> ## 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.

# トラブルシューティング

症状から、対処を探します。

## まず状態を確かめる

expl server status を実行します。expl server tools list が終了コード 0 で終わっても、接続できているとは限りません（[コマンドを調べる](https://docs.exploratory.io/ja/cli/server/commands.md#inspect-list)を参照）。送受信の内容を見るときは、`--verbose` を付けます。標準エラーに出力されます。トークンは出力されませんが、貼り付ける前に、中身を確認してください。

## 問い合わせるとき

次の内容を [support@exploratory.io](mailto:support@exploratory.io) へ送ってください。`expl --version` の出力、実行したコマンド、終了コード、メッセージです。トークンや API キーは伏せてください。

## 会社のネットワークでつながらないとき

IT の担当者に、exploratory.io への通信を許可してもらってください。オンプレミスの場合は、自社のサーバーの URL への通信を許可してもらってください。

## コマンドが見つからない

| 症状 | 対処 |
| - | - |
| expl: command not found | 新しいターミナルを開いて、もう一度実行します。Desktop の expl は、アプリを起動したときに PATH に追加されます。 |
| npm install -g が EEXIST で止まる | `--force` を付けて再実行しないでください。Exploratory Desktop に同梱されている expl が置き換わります。 |
| どの expl が実行されているか分からない | which -a expl（Windows は where expl）で、インストールされているものをすべて確認します。 |

Desktop と npm の両方にインストールしている場合の確認方法は、[インストール](https://docs.exploratory.io/ja/cli/server/install.md)を参照してください。

## サインイン

| 症状 | 対処 |
| - | - |
| `Run "expl server login".` | サインインしていないか、保存したログイン情報が拒否されています。expl server login を実行します。 |
| The API key is invalid or expired. Create a new one in Account Settings > API Keys. (UNAUTHORIZED) | キーが間違っているか、期限切れか、取り消されています。新しい API キーを作って、EXPL\_SERVER\_TOKEN に設定するか、`expl server login --with-token` を実行します。終了コード 4 です。 |
| API keys are disabled by your administrator. / This IP address is not allowed for API keys. | 管理者が、API キーをオフにしているか、使える IP アドレスを限定しています。管理者に確認するか、expl server login でサインインします。終了コード 4 です。 |
| `--token` was removed. … | EXPL\_SERVER\_TOKEN を設定するか、`expl server login --with-token` を実行します。終了コード 2 です。 |
| Too many failed API key attempts. Try again later. | このアドレスから、拒否されたキーが短い時間に何度も送られました。キーを直して、しばらくしてからやり直します。 |
| The redirect URL has no authorization code. | `--no-browser` のとき、最初に表示された URL を貼り付けています。移動先の、[http://127.0.0.1/callback?code=](http://127.0.0.1/callback?code=) で始まる URL を貼り付けてください。 |
| 終了コード 4（Desktop） | メッセージの末尾のコード（NOT\_SIGNED\_IN、UNAUTHORIZED、PAIRING\_REQUIRED、CHANNEL\_DISABLED、PERMISSION\_DENIED）を、[終了コードとエラー](https://docs.exploratory.io/ja/cli/server/exit-codes.md#action)で確認します。 |

環境変数のキーから保存したログインに切り替えるときは、EXPL\_SERVER\_TOKEN が先に使われるので、先に unset EXPL\_SERVER\_TOKEN を実行してください。

API キーの作り方、渡し方、取り消し方は、[API キー](https://docs.exploratory.io/ja/cli/server/token.md)を参照してください。

## 通信

| 症状 | 対処 |
| - | - |
| 終了コード 3（Server） | サーバーに接続できていません。通信を確認して、もう一度実行します。 |
| 終了コード 3（Desktop） | Exploratory Desktop を起動して、もう一度実行します。 |
| メッセージに chart\_query のような道具の名前が出る | expl server tools describe \<tool\_name> で、その道具に対応するコマンドを確認します。 |
| 結果が想定と異なる | `--verbose` を付けて、送受信した内容を確認します。貼り付ける前に、中身を確認してください。 |

## 上限

| 症状 | 対処 |
| - | - |
| Too big: expected number to be \<=50 at limit | search の `--limit` を 50 以下にします。 |
| 結果の has\_more が true で、全部が返っていない | search と dataframe preview は、`--offset` で次のページを取得します。dataset query は、絞り込むか、集計します。 |
| SERVER\_BUSY | ほかの書き出しが実行中か、1 時間あたりの書き出しの上限に達しています。数秒おいてから再度実行します。上限に達した場合は、最大 1 時間待ちます。 |

これらのエラーを返すサーバーは、MCP Server が使うサーバーと同じです。ほかに返すエラー（NOT\_FOUND、PERSONALIZED\_CONTENT、CONTENT\_UPDATING、UNSUPPORTED\_OPERATION、RESULT\_TOO\_LARGE）と、1 分あたりの要求回数の上限（120 回）は、MCP Server の[制限とエラー](https://docs.exploratory.io/ja/mcp/server/limits.md#errors)を参照してください。

## 問い合わせできないデータ

| 症状 | 対処 |
| - | - |
| DATASET\_UNAVAILABLE | 公開した人が、最新のバージョンの Exploratory Desktop でデータを公開し直す必要があります。 |
| DATA\_EGRESS\_LIMIT | 公開した人が、このデータをファイルとしてダウンロードすることを許していません。fetch か dataframe get-schema で、公開した人が共有している内容を読みます。 |
| Unknown property "by" in a sort entry. (INVALID\_SORT) | sort では、出力の列の名前を field で指定します。 |

JSON で渡す引数の書き方は、[データを集計する](https://docs.exploratory.io/ja/cli/server/guides/query-data.md#json)を参照してください。


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