如何通过 MCP 将 Botpress 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Botpress、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Botpress + Gemini

让你的 AI 检查你的 Botpress 机器人：工作区和机器人，对话、消息、用户和事件，机器人日志、分析和问题，机器人的数据表（查询、添加和更新行），以及带语义搜索的知识库文件。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

BOTPRESS_TOKEN, BOTPRESS_WORKSPACE_ID, BOTPRESS_BOT_ID

步骤 1 — 获取凭证

1. 登录 https://app.botpress.cloud。打开右上角的个人资料菜单 → Profile Settings → Personal Access Tokens，创建一个令牌并复制（以 bp_pat_ 开头）。把它粘贴到 BOTPRESS_TOKEN，不要加 Bearer 一词。
2. 工作区 ID（BOTPRESS_WORKSPACE_ID）：在仪表板中打开工作区，复制 URL 中的 wkspace_... 部分（app.botpress.cloud/workspaces/wkspace_...）。
3. 机器人 ID（BOTPRESS_BOT_ID）：打开机器人，复制 URL 中 /bots/ 后面的 UUID。Studio 的机器人设置中也会显示它。
4. 安装连接器。这三个值只会发送给 Botpress。之后，botpress_list_workspaces 和 botpress_list_bots 也能显示你其他工作区和机器人的 id。

谁能看到什么：令牌带有你本人对所属全部工作区的访问权限。请妥善保密，并只把 MCP 服务器分享给有权阅读机器人对话的人，因为对话中可能包含个人数据。

使用 Botpress 的哪些部分：一个 Personal Access Token 即可访问以下四个部分（Bot Access Key 无法用于管理类工具，所以请使用个人令牌）：

• Admin API：工作区、机器人、机器人日志、分析和问题。
• Runtime API：机器人在所有渠道（Webchat、WhatsApp、Slack 等）的对话、消息、用户和事件。不使用 Botpress 单独的 Chat API，因为它只能看到其自身 Chat 集成中的对话。
• Tables API：机器人的数据表，可查询、添加和更新行。
• Files API：机器人的知识库文件，可对已建索引的文件进行语义搜索。

多个机器人：对话、消息、用户、事件、数据表和文件工具默认作用于 BOTPRESS_BOT_ID，除非你指定另一个机器人。机器人工具（概览、日志、分析、问题）每次调用都要带上机器人 id，因此 AI 可以比较同一工作区中的机器人。

先确认：botpress_create_table_rows 和 botpress_update_table_rows 会修改机器人的数据，所以 AI 会先给你看这些行并等你同意。botpress_delete_table_rows 在安装时默认关闭；只有希望 AI 删除行时，才在连接器设置中开启它。它只能按行 id 删除。

不可信内容：消息、用户字段和文件片段来自终端用户或上传的文档。AI 会把其中的指令当作数据，而不是命令。

常见错误：401 Unauthorized：令牌错误或已撤销，或者工作区 ID 不属于你的用户所在的工作区。403 Forbidden：你在工作区中的角色不允许该操作。404 ResourceNotFound：id 未知，或者对话、数据表属于另一个机器人，而不是 BOTPRESS_BOT_ID 中的那个。400 InvalidPayload 或 InvalidQuery：参数无效，例如日期不是 ISO 8601 格式。429 RateLimited：请稍候再试。

该连接器不会创建、部署或删除机器人，不会以机器人身份发送消息，不管理集成，不向知识库上传文件，也不管理工作区成员和账单。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Botpress 的工具。

可用工具

示例提示

• “这周大家问我们的客服机器人最多的是什么？总结一下最近对话的主要话题。”
• “机器人昨天为什么出错？查看它的问题列表和 9 点以后的错误日志。”
• “给我看我们的机器人过去 30 天的新用户、回访用户、会话数和消息数。”
• “在 Leads 表中找到邮箱为 [email protected] 的那一行，把状态改为 contacted。改之前先给我看改动。”
• “在机器人的知识库里搜索我们的退款政策，并告诉我答案来自哪个文件。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT