> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exploratory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめる

Exploratory Desktop の CLI をオンにして、expl をつなぎ、プロジェクトのデータを見ます。次の手順を順に行うと、このページ 1 つで最初の結果まで進めます。

## 手順

### 1. Desktop を起動してサインインする

Exploratory Desktop を起動して、サインインします。expl は、Desktop が書いた接続先とトークンを読むので、expl 自身のサインインは必要ありません。

### 2. CLI をオンにする

expl は Exploratory Desktop に同梱されています。CLI は初期状態ではオフで、オンにするまで、Desktop は expl のコマンドを受け付けません。

Exploratory Desktop で、画面の左下にある自分の名前を選び、開いたメニューで「システム設定」を選びます。左のメニューで MCP / CLI を選び、「CLI」のカードのスイッチをオンにして、「保存」を選びます。expl でコンテンツの作成、変更、削除もしたいときは、「作成、変更、削除を許可する」にもチェックを入れます。画面の画像は[インストール](https://docs.exploratory.io/ja/cli/desktop/install.md#enable)のページにあります。

### 3. バージョンと状態を確認する

新しいターミナルを開いて、expl が動くことを確かめます。

```sh theme={null}
expl --version
```

```sh theme={null}
expl status
```

Desktop のバージョンと、サインイン中のユーザーを表示します。

初めて使うときは、Exploratory Desktop に「expl の Exploratory への接続を許可しますか？」と聞く画面が出ます。自分で起動した expl であることを確かめて、許可します。

![「AI ツールが許可を求めています」の画面。「expl の Exploratory への接続を許可しますか？ 自分で起動したアプリだけ許可してください。」と表示され、「許可する」と「許可しない」のボタンがある](https://mintcdn.com/exploratory-inc/_cHetG8yIT5gmGiQ/ja/cli/desktop/images/ja/pairing-dialog.png?fit=max\&auto=format\&n=_cHetG8yIT5gmGiQ\&q=85\&s=def887d650a9e5dc6aca5e4d86ed9dea)

expl は答えを最大 2 分待ち、その間は標準エラーに「Exploratory で expl の承認を待っています（確認が表示されています）...」と出します。許可すると、コマンドはそのまま続きます。2 分以内に答えないと、PAIRING\_PENDING で止まります（終了コード 1）。Desktop の画面で答えてから、もう一度実行します。

「許可しない」を選ぶと、コマンドは PAIRING\_REQUIRED で止まります（終了コード 4）。その後 5 分間は、もう一度実行しても画面は出ずに断られます。5 分たってからもう一度実行し、画面で許可します。

### 4. プロジェクトを選ぶ

```sh theme={null}
expl project list
```

プロジェクトを一覧します。

```sh theme={null}
expl project use "Sales Analysis"
```

Sales Analysis は、自分のプロジェクトの名前に置き換えます。以降のコマンドは、このプロジェクトが対象になります。このコマンドは既定のプロジェクトを保存するだけで、Desktop でプロジェクトを開くことはしません。

後のコマンドが PROJECT\_NOT\_OPEN で止まったときは、プロジェクトが Desktop で開いていません。expl project list で見つけた id で開きます。

```sh theme={null}
expl project open <project_id>
```

### 5. データを見る

```sh theme={null}
expl dataframe list
```

プロジェクトのデータフレームを一覧します。1 つ選んで、id を控えます。

```sh theme={null}
expl dataframe get-schema <dataframe_id>
```

列の名前と型を表示します。\<dataframe\_id> は、選んだ id に置き換えます。行を見るときは、expl dataframe preview \<dataframe\_id> を実行します。

### 6. ダッシュボードを取得する（任意）

```sh theme={null}
expl dashboard list
```

一覧から、ダッシュボードの id を選びます。一覧が空のときは、そのプロジェクトにダッシュボードがまだありません。

```sh theme={null}
expl dashboard get d123 --json
```

d123 は、選んだ id に置き換えます。

## うまくいかないとき

* コマンドが受け付けられません: CLI のスイッチがオンで、保存してあるか確かめます（手順 2）。
* PAIRING\_PENDING で止まります: 2 分以内に答えなかったためです。Desktop の画面で答えてから、もう一度実行します（手順 3）。
* PAIRING\_REQUIRED で止まります: 「許可しない」を選んだためです。5 分たってからもう一度実行し、画面で許可します（手順 3）。
* PROJECT\_NOT\_OPEN で止まります: expl project open \<project\_id> でプロジェクトを開きます（手順 4）。
* expl tools list は終了コード 0 で終わるのに、ほかのコマンドが動きません: 終了コード 0 は、Desktop につながっている印ではありません。expl status を実行します。
* ダッシュボードの一覧が空です: そのプロジェクトにダッシュボードがまだありません。

詳しくは[トラブルシューティング](https://docs.exploratory.io/ja/cli/desktop/troubleshooting.md)を参照してください。

## 次に読むもの

* [プロジェクトを選ぶ](https://docs.exploratory.io/ja/cli/desktop/guides/projects.md) - プロジェクトが決まる順です。
* [使い方](https://docs.exploratory.io/ja/cli/desktop/use) - やりたいことからコマンドを探します。
* [コマンド一覧](https://docs.exploratory.io/ja/cli/desktop/commands.md) - 目的からコマンドを探します。
* [トラブルシューティング](https://docs.exploratory.io/ja/cli/desktop/troubleshooting.md) - 症状から対処を探します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.