Exploratory Server

探索性插件

日本語

这些插件通过 MCP（Model Context Protocol）将你的 AI 客户端（Claude Code、Codex、Cursor 等）连接到 Exploratory。共有两个插件：

• 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）

这两个插件不共用工具或技能。你可以按任意顺序安装两者。

指南 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 参考。

只能选择一种方式：安装官方插件、直接添加 URL，或使用 claude.ai 上的 Exploratory 连接器（使用同一个 Claude 账户登录时，该连接器也会显示在 Claude Code 中）。如果之后从官方目录安装插件，请先移除直接添加的条目（例如，claude mcp remove exploratory-server）。否则相同的工具会出现两次。

步骤 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 只能通过一种方式安装（官方插件、直接 URL 或 claude.ai 连接器）。如果出现两个 Server 条目，相同的工具会显示两次。
• 登录是独立的。Server 使用浏览器中的 Exploratory OAuth。Desktop 使用应用中已登录的账号。

如果你使用的是早期的一体化插件

早期的 exploratory 插件同时包含 Server 和 Desktop。更新后，它会变成 Desktop 插件，Server 连接也会被移除。若要继续读取已发布的内容，请按照指南 1添加 Server。

Agent 可以做什么

类别	工具
查找和阅读	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 代码。

在 Agent 写入内容前，请先检查其提议。Exploratory MCP 参考文档列出了 Server MCP 工具的参数、错误和限制。你的 AI 客户端会在工具列表中显示 Desktop MCP 工具。

设置（Claude Code）

Claude Code 有四项插件设置：

设置	默认值	功能
ai_summary	false	为你创建的图表和分析生成并保存 AI 摘要
save_comments	false	为你创建的图表保存说明性注释
review_hook	false	要求 Agent 审查其工作（见下文和隐私）
plan_gate	true	要求 Agent 在构建前保存计划（见计划门槛）

启用 review_hook 后，Agent 会在以下四个时点审查其工作：

• 首次调用 create_chart 或 create_analytics 之前。
• 每个数据整理步骤之后。
• 创建注释之后。
• 创建或编辑图表和分析之后。
  • 每个图表或分析都会单独审查一次。
  • 单个会话中图表和分析的总数上限为 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 本身有钩子机制。

计划门槛

计划门槛会阻止 Agent 在保存计划前开始构建。默认情况下已启用（plan_gate = true）。如需关闭，请使用上文中的 claude plugin configure 命令将 plan_gate 设为 false。

关于被拒绝的调用和规则，请参阅计划门槛（Claude Code）。

数据和权限

• Server MCP 会读取已发布的内容。Desktop MCP 可以创建和编辑本地项目内容，也可以在你提出要求时发布内容。请检查 Agent 提议执行的操作。
• Server MCP 调用以已登录用户的身份运行，不会超出该用户在 exploratory.io 上的可查看范围。发布者可以为每项已发布内容关闭 MCP 访问权限，也可以将数据行设为私有。
• 这些控制措施不适用于 Desktop MCP。Desktop MCP 通过你电脑上的 Exploratory Desktop 应用运行，使用的是已登录该应用的用户身份。
• 如需断开客户端与 Server MCP 的连接，请打开 exploratory.io 上的 Account Settings，并在 Connected AI Apps 下移除该客户端。这不会停止 Desktop MCP。退出 Exploratory Desktop 后，Desktop MCP 才会停止。

更新和卸载

以下命令用于管理 Desktop 插件。请通过安装 Server 时使用的官方市场更新或移除 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 中。
桌面端 MCP 工具返回未运行错误	启动 Exploratory Desktop，然后在同一对话中再次使用这些工具。
服务端 MCP 要求你登录	重新登录：在 Claude Code 中运行 /mcp，在 Codex 中运行 codex mcp login exploratory-server，在 Cursor 中运行 agent mcp login exploratory-server。在 Grok Bot 中，移除连接并重新添加。
桌面端 MCP 无法按预期工作	检查是否已登录 Exploratory Desktop。

隐私

• Server MCP：调用会发送到 https://exploratory.io/mcp。它们只读取已发布的内容，且为只读。如需了解权限，请参阅数据与权限。
• Desktop MCP：它在你的计算机上运行。它的中继会与本地的 Exploratory Desktop 通信。它通过应用读取和编辑本地项目内容（数据框、图表、分析、笔记、仪表板）。
• Desktop MCP 使用记录：Exploratory Desktop 会为每次 Desktop MCP 工具调用发送一条使用记录，并将记录发送到你登录的 exploratory.io 服务。我们使用这些记录来改进工具。
  • 记录包含工具名称及其参数。参数可能包括你输入的公式和值。
  • 记录还包含以下内容：成功或失败，以及错误类型和消息。
  • 记录还包含结果的大小（不包含内容）和耗时。
  • 记录包含 Exploratory Desktop 版本、AI 客户端名称和版本，以及会话 ID 和项目 ID。
  • 只有在你登录且 AI 功能已开启时，Exploratory Desktop 才会发送记录。对于本地数据目录工具，它绝不会发送记录。
• 工具结果：工具返回的内容（行、列名、图表图像、错误）会成为对话的一部分，并会根据 AI 提供商的条款发送给你的 AI 提供商（例如 Anthropic、OpenAI、Google 或 xAI）。请勿将插件用于包含你可能无法发送给该提供商的数据。
• Hooks（目前通过 Claude Code 清单连接）：hook 是一个会在 Agent 操作之前或之后自行运行的小程序。这些 hook 在本地通过 node 运行，不会通过网络发送任何内容。
  • 状态文件：hook 会将这些文件写入插件数据文件夹。如果未设置文件夹，则会将其写入系统临时文件夹中的 exploratory-plugin-review。插件不会删除这些文件。如果不想保留它们，请自行删除。
  • Review hook：开启 review_hook 后，它会将这些工具的参数和结果原样保存到 -charts.json 文件中。其中可能包含列名和筛选值。
    • create_chart
    • update_chart
    • create_analytics
    • update_analytics
  • 对于笔记，hook 会保存笔记 ID 或标题。
  • Plan hooks：开启 plan_gate（默认开启）后，hook 会保存以下内容：
    • 每个 R 表达式的 SHA-1 哈希（由文本生成的短代码）。
    • 报告和计划文件的路径。
    • 图表 ID。
  • 开启 plan_gate 后，hook 还会读取工作文件夹中的 *計画*.md 和 *plan*.md 文件。計画 的意思是“计划”。
  • 每次调用 Skill、Write、Bash 和 PowerShell 时，都会启动计划 hook。以下 Desktop MCP 调用也会启动计划 hook：
    • 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
  • 只有先使用了分析技能，计划 hook 才会记录内容。
  • Settings hook：它会将设置值作为上下文传递给 Agent。每次 Desktop MCP 调用时都会启动，即使 review_hook 和 plan_gate 都为 false 也不例外。它会在状态文件夹中为该会话写入一个小型标记文件（-settings）。
  • 若要关闭记录 hook，请将 review_hook 和 plan_gate 设为 false。你也可以卸载插件。
• Exploratory 隐私政策：https://exploratory.io/privacy

支持

请通过 https://exploratory.io/ 右下角的聊天窗口联系我们，或发送邮件至 [email protected]。

条款：https://exploratory.io/terms

安全性

请勿将令牌或密码放入提示词或文件中。此插件不会传递令牌。中继会读取自己的凭据。

桌面 MCP 会为删除操作（delete_*、unpublish）和发布操作（publish_note、publish_dashboard、publish_data_frame）标记 destructiveHint。这仅是一项提示。支持此提示的客户端可以询问你是否确认。具体取决于客户端和你的权限设置。复制到其他项目不会添加此标记。

如需报告漏洞，请参阅 SECURITY.md。

文档

• 探索性 MCP 参考：端点、授权、工具、错误和限制
• 安全策略
• 变更日志

许可证

MIT