Exploratory Server

Exploratory プラグイン

日本語

これらのプラグインは、AI クライアント（Claude Code、Codex、Cursor など）を MCP（Model Context Protocol）を通じて Exploratory に接続します。プラグインは 2 つあります。

• Exploratory Server は、exploratory.io で公開されているコンテンツ（ノート、ダッシュボード、スライド、チャート、分析、データ）を読み取ります。
• Exploratory Desktop は、お使いのコンピューター上の Exploratory Desktop でプロジェクトを作成、編集します。

必要なプラグインを選ぶ

表から該当するケースを見つけて、ガイドに従ってください。

目的	ガイド	インストールするもの
exploratory.io で公開されているコンテンツを読み取り、クエリする	Server のみ	Exploratory Server
Exploratory Desktop でデータ、チャート、分析、ノート、ダッシュボードを作成する	Desktop のみ	Exploratory Desktop v17 以降、および Exploratory Desktop プラグイン
両方を行う	Server と Desktop	上記の両方

プラグイン	プラグイン名	入手先
Exploratory Server	exploratory-server (0.1.4)	AI クライアントの公式プラグインディレクトリ
Exploratory Desktop	exploratory (0.1.6)	このリポジトリのマーケットプレイス（exploratory-io/exploratory）

2 つのプラグインでツールやスキルは共有されません。どちらを先にしても、両方をインストールできます。

ガイド 1：Server のみ

Exploratory アカウントが必要です。Exploratory Desktop や Node.js は必要ありません。

ステップ 1. インストール

AI クライアントの公式プラグインディレクトリに掲載されている場合は、そこから Exploratory Server をインストールしてください。

掲載されるまでは、MCP URL を直接追加してください。これでツールは追加されますが、Server スキルは追加されません。

Claude Code：

claude mcp add --transport http exploratory-server https://exploratory.io/mcp

Codex：

codex mcp add exploratory-server --url https://exploratory.io/mcp
codex mcp login exploratory-server

Cursor、Grok Bot、その他のクライアントについては、MCP リファレンスを参照してください。

方法は 1 つだけ選んでください。公式プラグイン、直接 URL、または claude.ai の Exploratory コネクターです（同じ Claude アカウントでサインインすると、Claude Code にも表示されます）。後から公式ディレクトリからプラグインをインストールする場合は、先に直接追加した項目を削除してください（例：claude mcp remove exploratory-server）。そうしないと、同じツールが 2 回表示されます。

ステップ 2. サインイン

新しいセッションを開始します。初回の呼び出し時に、AI クライアントがブラウザーウィンドウを開きます。Exploratory にサインインして、アクセスを承認してください。API キーは必要ありません。

ステップ 3. 試してみる

Exploratory で公開したコンテンツを一覧表示してください。

Exploratory の「Sales」データにはどの列がありますか。また、売上が最も高い 5 つの地域はどこですか？

ガイド 2：Desktop のみ

以下が必要です。

• Exploratory Desktop v17 以降がインストールされ、サインイン済みで、起動していること。起動時に、exploratory-mcp コマンドが PATH に追加されます。プラグインはこのコマンドを起動します。
• Claude Code の場合：PATH に node があること。プラグインのレビュー用フックはこれを使用して実行されます。

ステップ 1. Exploratory Desktop で MCP を有効にする

System Settings > MCP / CLI を開き、MCP スイッチをオンにします。チャート、ノートなどのコンテンツを作成、変更するには、Allow create, edit and delete もオンにします。どちらもデフォルトではオフです。

ステップ 2. Exploratory Desktop プラグインをインストールする

このプラグインは公式ディレクトリにはありません。このリポジトリをマーケットプレイスとして追加し、プラグインをインストールしてください。コマンドを入力するか、AI クライアントに実行を依頼できます。

Claude Code

claude plugin marketplace add exploratory-io/exploratory
claude plugin install exploratory@exploratory

Claude Code で /plugin を開き、マーケットプレイス exploratory-io/exploratory を追加して、exploratory を選ぶこともできます。

Codex

codex plugin marketplace add exploratory-io/exploratory
codex plugin add exploratory@exploratory

Cursor

git clone https://github.com/exploratory-io/exploratory
agent --plugin-dir ./exploratory/plugins/exploratory-desktop

スキルを使わず Desktop MCP のみを登録するには、これを ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "exploratory-desktop": {
      "type": "stdio",
      "command": "exploratory-mcp"
    }
  }
}

Antigravity

git clone https://github.com/exploratory-io/exploratory
agy plugin install ./exploratory/plugins/exploratory-desktop

ステップ 3. 確認して試す

新しいセッションを開始します。Claude Code では /mcp を開き、exploratory-desktop が接続されていることを確認します。Codex では codex mcp list を実行し、exploratory-desktop が一覧に表示されていることを確認します。Exploratory Desktop でプロジェクトを開いてから、次のように試します。

開いている Exploratory プロジェクトで、売上データから月別の棒グラフを作成してください。

MCP がオフになっているというメッセージが表示された場合は、ステップ 1 に戻ってください。

ガイド 3：サーバーとデスクトップ

ガイド 1 と ガイド 2 の両方に従ってください。順序は問いません。もう一方のプラグインは後から追加できます。最初のプラグインを再インストールする必要はありません。

• Desktop プラグインには、ルーティングスキルが含まれています。公開済みコンテンツに関するリクエストは Server に、ローカルプロジェクトに関するリクエストは Desktop に送ります。
• Server は 1 つの方法のみでインストールしてください（公式プラグイン、直接 URL、または claude.ai コネクター）。Server の項目が 2 つあると、同じツールが 2 回表示されます。
• サインインは別々です。Server はブラウザーで Exploratory OAuth を使用します。Desktop はアプリにサインインしているアカウントを使用します。

以前のオールインワンプラグインを使用していた場合

以前の exploratory プラグインには、Server と Desktop の両方が含まれていました。更新すると Desktop プラグインになり、Server 接続は削除されます。公開済みコンテンツの閲覧を続けるには、ガイド 1 に従って Server を追加してください。

エージェントにできること

カテゴリ	ツール
検索と閲覧	search は公開済みコンテンツを一覧表示して検索します。fetch はノート、ダッシュボード、またはスライドを Markdown として読み込みます
グラフと分析	chart_get_data はグラフの元となる数値を返します。chart_get_image はグラフを画像として返します。analytics_get_result は係数、p 値、その他の結果を返します
データ	dataframe_get_schema は列と承認済みの意味を説明します。dataframe_preview は行を表示します。query_dataset はサーバー上でフィルター処理と集計を行います。dataframe_export は結果を CSV または Parquet として保存します

表に記載されている Server MCP ツールは読み取り専用です。dataframe_export のみ、15 分間有効なダウンロードリンクを作成します。

Desktop MCP ツールはローカルプロジェクトを作成、編集します。次の項目を操作できます。

• データフレーム、データ加工ステップ、ブランチ、パラメーター、接続
• グラフと分析
• ノートとダッシュボード

一部の Desktop MCP ツールは、項目を変更または削除します。

• グラフ、分析、ノート、ダッシュボード、ステップ、ブランチ、パラメーター、接続を削除します。
• ノート、ダッシュボード、データフレームを公開および非公開にします。
• execute_r_script で R コードを実行します。

エージェントが変更を加える前に、その提案を確認してください。Exploratory MCP リファレンスには、Server MCP ツールの引数、エラー、制限が記載されています。AI クライアントでは、ツール一覧に Desktop MCP ツールが表示されます。

Settings（Claude Code）

Claude Code には、次の4つのプラグイン設定があります。

設定	デフォルト	機能
ai_summary	false	作成したチャートや分析の AI サマリーを作成して保存します
save_comments	false	作成したチャートに説明コメントを保存します
review_hook	false	エージェントに作業のレビューを依頼します（以下およびプライバシーを参照）
plan_gate	true	エージェントが構築を始める前に、計画を保存するようにします（計画ゲートを参照）

review_hook を有効にすると、エージェントは次の4つのタイミングで作業をレビューします。

• 最初の create_chart または create_analytics の前。
• 各データ加工ステップの後。
• ノートの作成後。
• チャートや分析の作成または編集の呼び出し後。
  • チャートまたは分析ごとに1回レビューします。
  • 1セッションでのチャートと分析の合計上限は8件です。
  • 上限を変更するには、EXPLORATORY_REVIEW_CHART_LIMIT を設定します。

設定を確認するには、claude plugin configure exploratory@exploratory を実行します。設定を変更するには、--values-stdin を指定して、そのコマンドに JSON オブジェクトを渡します。インストール時に設定することもできます。

claude plugin install exploratory@exploratory \
  --config ai_summary=true \
  --config save_comments=true \
  --config review_hook=true

Desktop パッケージでは、Claude Code マニフェストを通じてフックと計画ゲートを接続します。Codex マニフェストでは現在、これらのフックや設定は接続されていません。Codex 自体にはフックの仕組みがあります。

計画ゲート

計画ゲートは、計画が保存されるまでエージェントが構築を開始できないようにします。デフォルトで有効です（plan_gate = true）。無効にするには、上記の claude plugin configure コマンドで plan_gate を false に設定します。

拒否される呼び出しとルールについては、計画ゲート（Claude Code）を参照してください。

データと権限

• Server MCP は公開済みのコンテンツを読み取ります。Desktop MCP はローカルのプロジェクトコンテンツを作成および編集できます。依頼すれば公開することもできます。エージェントが提案する操作を確認してください。
• Server MCP の呼び出しは、サインインしているユーザーとして実行されます。そのユーザーが exploratory.io で表示できる範囲を超えることはありません。公開者は、公開済みコンテンツごとに MCP アクセスを無効にできます。また、データの行を非公開にすることもできます。
• これらの制御は Desktop MCP には適用されません。Desktop MCP は、お使いのコンピューター上の Exploratory Desktop アプリを通じて、アプリにサインインしているユーザーとして動作します。
• クライアントを Server MCP から切断するには、exploratory.io の Account Settings を開き、Connected AI Apps からクライアントを削除します。これによって Desktop MCP が停止することはありません。Desktop MCP は Exploratory Desktop を終了すると停止します。

更新とアンインストール

以下のコマンドは Desktop プラグインを管理します。Server を更新または削除するには、インストールした公式マーケットプレイスを使用してください。

クライアント	更新	アンインストール
Claude Code	claude plugin marketplace update exploratory を実行し、続けて claude plugin update exploratory@exploratory を実行してから、Claude Code を再起動します	claude plugin uninstall exploratory@exploratory
Codex	codex plugin marketplace upgrade exploratory を実行し、続けて codex plugin remove exploratory@exploratory と codex plugin add exploratory@exploratory を実行して再インストールします	codex plugin remove exploratory@exploratory
Cursor	クローンしたフォルダーで git pull を実行し、再度 agent --plugin-dir を起動します	--plugin-dir の使用を停止します。手動で ~/.cursor/mcp.json を作成した場合は、そこから exploratory-desktop を削除します
Antigravity	クローンしたフォルダーで git pull を実行し、続けて agy plugin install を再度実行します	Antigravity のプラグイン設定でプラグインを削除します

アンインストールしても Server MCP へのアクセス権は取り消されません。アクセス権を取り消すには、exploratory.io の Connected AI Apps からクライアントも削除してください。

トラブルシューティング

問題	対処方法
exploratory-mcp が見つからない	MCP 対応の Exploratory Desktop v17 以降を起動して、exploratory-mcp を PATH にインストールし、その後 AI クライアントを再起動します。
Claude Code のフックが node を見つけられない	Node.js をインストールし、node を PATH に追加します。
Desktop MCP ツールが未起動エラーを返す	Exploratory Desktop を起動します。その後、同じ会話でツールを再度使用します。
Server MCP でサインインを求められる	再度サインインします。Claude Code では /mcp、Codex では codex mcp login exploratory-server、Cursor では agent mcp login exploratory-server を使用します。Grok Bot では、接続を削除して再度追加します。
Desktop MCP が期待どおりに動作しない	Exploratory Desktop にサインインしていることを確認します。

プライバシー

• Server MCP：呼び出しは https://exploratory.io/mcp に送信されます。公開済みのコンテンツのみを読み取り、読み取り専用です。権限については、データと権限をご覧ください。
• Desktop MCP：お使いのコンピューター上で実行されます。リレーはローカルの Exploratory Desktop と通信します。アプリを通じて、ローカルプロジェクトのコンテンツ（データフレーム、チャート、分析、ノート、ダッシュボード）を読み取り、編集します。
• Desktop MCP の使用記録：Exploratory Desktop は、Desktop MCP のツール呼び出しごとに使用記録を 1 件送信します。記録は、サインインしている exploratory.io サーバーに送信されます。ツールの改善にこの記録を使用します。
  • 記録には、ツール名とその引数が含まれます。引数には、入力した数式や値が含まれることがあります。
  • 記録には、成功または失敗、およびエラーの種類とメッセージも含まれます。
  • 結果のサイズ（内容は含みません）と所要時間も含まれます。
  • Exploratory Desktop のバージョン、AI クライアントの名前とバージョン、セッション ID とアイテム ID も含まれます。
  • Exploratory Desktop は、サインイン中で AI 機能が有効な場合にのみ記録を送信します。ローカルデータカタログのツールについては、記録を送信しません。
• ツールの結果：ツールが返す情報（行、列名、チャート画像、エラー）は、会話の一部になります。AI のプロバイダー（Anthropic、OpenAI、Google、xAI など）に、そのプロバイダーの規約に従って送信されます。そのプロバイダーに送信してもよいデータに限り、このプラグインを使用してください。
• フック（現在は Claude Code のマニフェストを通じて接続）：フックは、エージェントのアクションの前後に自動実行される小さなプログラムです。これらのフックは node を使ってローカルで実行され、ネットワーク経由で何も送信しません。
  • 状態ファイル：フックはプラグインのデータフォルダーにファイルを書き込みます。フォルダーが設定されていない場合は、システムの一時フォルダーにある exploratory-plugin-review に書き込みます。プラグインはこれらのファイルを削除しません。ファイルを残したくない場合は、ご自身で削除してください。
  • レビューフック：review_hook が有効な場合、これらのツールの引数と結果をそのまま -charts.json ファイルに保存します。列名やフィルター値が含まれることがあります。
    • create_chart
    • update_chart
    • create_analytics
    • update_analytics
  • ノートについては、フックはノート ID またはタイトルを保存します。
  • プランフック：plan_gate が有効な場合（デフォルト）、フックは次の項目を保存します。
    • 各 R 式の SHA-1 ハッシュ（テキストから作られる短いコード）。
    • レポートファイルとプランファイルのパス。
    • チャート ID。
  • plan_gate が有効な場合、フックは作業フォルダー内の *計画*.md および *plan*.md ファイルも読み取ります。計画 は「plan」を意味します。
  • プランフックは、Skill、Write、Bash、PowerShell の呼び出しごとに起動します。また、次の Desktop MCP 呼び出しでも起動します。
    • execute_r_script、get_chart_image、get_chart_data
    • create_chart、update_chart、create_analytics、update_analytics、delete_chart
    • create_note、update_note、get_note_image
    • create_dashboard、update_dashboard、get_dashboard、get_dashboard_image
  • プランフックは、分析スキルが先に使用されていない限り、何も記録しません。
  • 設定フック：設定値をコンテキストとしてエージェントに渡します。review_hook と plan_gate の両方が false の場合も含め、Desktop MCP の呼び出しごとに起動します。状態フォルダーに、セッション用の小さなマーカーファイル（-settings）を書き込みます。
  • 記録フックを無効にするには、review_hook と plan_gate を false に設定してください。プラグインをアンインストールすることもできます。
• Exploratory のプライバシーポリシー：https://exploratory.io/privacy

サポート

https://exploratory.io/ の右下にあるチャットを利用するか、[email protected] までメールでお問い合わせください。

利用規約：https://exploratory.io/terms

セキュリティ

トークンやパスワードをプロンプトやファイルに記載しないでください。プラグインはトークンを渡しません。リレーが独自の認証情報を読み込みます。

Desktop MCP は、削除操作（delete_*、unpublish）と公開操作（publish_note、publish_dashboard、publish_data_frame）に destructiveHint を付与します。これはあくまでヒントです。これに対応するクライアントは、確認を求めることができます。これはクライアントと権限の設定によって異なります。別のプロジェクトへのコピーには付与されません。

脆弱性を報告するには、SECURITY.md を参照してください。

ドキュメント

• Exploratory MCP リファレンス：エンドポイント、認証、ツール、エラー、制限事項
• セキュリティポリシー
• 変更履歴

ライセンス

MIT