expl の使い方
- 最初に、接続を確かめます。expl server status を実行します。expl server tools list が終了コード 0 で終わっても、接続できているとは限りません。
- コマンド名を推測せず、
expl server tools list --jsonで探します。1 つのコマンドの引数は、expl server tools describe <tool_name> で確認します。 --jsonを付けて、結果を標準出力から読みます。進捗と警告は標準エラーに出るので、JSON は壊れません。- 終了コードを確認します。3 はサーバーにつながらない、4 は認証または権限の問題です。
- ターミナル以外では、取り消しにくい操作は
--yesがないと何も実行されず、終了コード 2 で終了します。--yesを付ける前に利用者に確認し、利用者が実行すると決めた操作にのみ付けます。ただし expl server token revoke は例外で、--yesの有無にかかわらず確認なしで取り消しを送ります。実行する前に、取り消す API キーと、取り消す意思を利用者に確認します。 - CI では、環境変数 EXPL_SERVER_TOKEN の API キーでサインインします。
- エラーのメッセージに chart_query のような道具名が出たら、expl server tools describe <tool_name> で、その道具に当たるコマンドを確認します。
expl と MCP Server の選び方
MCP は、AI ツールが外部のサービスに接続するための共通の規格です。どちらの方法でも、AI から Exploratory を利用できます。
AI ツールから、公開されたコンテンツを読む場合はMCP Serverを、Exploratory Desktop のプロジェクトを扱う場合はDesktop で使うを参照してください。
