跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Botpress，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 检查你的 Botpress 机器人：工作区和机器人，对话、消息、用户和事件，机器人日志、分析和问题，机器人的数据表（查询、添加和更新行），以及带语义搜索的知识库文件。
试试这样问
Botpress 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Botpress、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Botpress + ChatGPT
让你的 AI 检查你的 Botpress 机器人：工作区和机器人，对话、消息、用户和事件，机器人日志、分析和问题，机器人的数据表（查询、添加和更新行），以及带语义搜索的知识库文件。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
BOTPRESS_TOKEN, BOTPRESS_WORKSPACE_ID, BOTPRESS_BOT_ID
步骤 1 — 获取凭证
- 登录
https://app.botpress.cloud。打开右上角的个人资料菜单 → Profile Settings → Personal Access Tokens，创建一个令牌并复制（以bp_pat_开头）。把它粘贴到BOTPRESS_TOKEN，不要加 Bearer 一词。 - 工作区 ID（
BOTPRESS_WORKSPACE_ID）：在仪表板中打开工作区，复制 URL 中的wkspace_...部分（app.botpress.cloud/workspaces/wkspace_...）。 - 机器人 ID（
BOTPRESS_BOT_ID）：打开机器人，复制 URL 中/bots/后面的 UUID。Studio 的机器人设置中也会显示它。 - 安装连接器。这三个值只会发送给 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 — 在 ChatGPT 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件，仅付费套餐可用，不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins，点击 +，然后选择 Add custom MCP server。
- 填写名称，例如 Name:
Botpress。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。 - 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。
可用工具
| Tool | What it does |
|---|---|
botpress_list_workspaces | List the Botpress workspaces the token's user belongs to, with id, name, plan, bot count, spending limit and whether the workspace is… |
botpress_list_bots | List the bots of a Botpress workspace (production bots, or dev bots with dev true) with id, name, type, tags and last deploy time |
botpress_get_bot | Get one bot's overview: name, description, status, deploy time, whether it is a dev bot, tags, and its installed integrations with version… |
botpress_get_bot_logs | Read a bot's runtime logs (console output, errors and system messages) from timeStart on, filtered by level, conversation, user, workflow… |
botpress_get_bot_analytics | Get a bot's usage analytics between two dates: per period new and returning users, sessions, user and bot messages, events, conversations… |
botpress_list_bot_issues | List the issues Botpress recorded for a bot (errors in its code, hit limits, configuration problems) with code, title, description… |
botpress_list_conversations | List a bot's conversations from every channel, newest first, with id, integration and channel (e.g. webchat, whatsapp), message count, tags… |
botpress_get_conversation | Get one conversation of a bot: integration, channel, message count, tags, shared properties and dates |
botpress_list_messages | List a bot's messages, newest first, usually of one conversation (conversationId) |
botpress_list_users | List the end users who talked to a bot (one per channel: the same person on Slack and WhatsApp is two users), with id, name, tags and dates |
botpress_get_user | Get one end user of a bot: name, picture URL, tags, attributes and properties set by the bot or its integrations, and dates |
botpress_list_events | List a bot's events (incoming messages, integration events, custom and scheduled events) with type, status (pending, processed, ignored… |
botpress_get_event | Get one event of a bot with its full payload, status and failureReason |
botpress_list_tables | List a bot's tables with id, name, row factor, key column, whether it is frozen and the column schema |
botpress_get_table | Get one table of a bot with its columns (names, types, descriptions, computed settings), key column, its row count (rows) and how many rows… |
botpress_find_table_rows | Query rows of a bot's table with a MongoDB-like filter, full-text search, column selection, ordering and offset paging; group adds… |
botpress_create_table_rows | Add rows to a bot's table (1 to 1,000 per call), each an object of column values matching the table's schema (see botpress_get_table) |
botpress_update_table_rows | Update rows of a bot's table by id (1 to 1,000 per call): each row is {"id": 12, "column": "new value"} and only the given columns change |
botpress_delete_table_rows | Permanently delete rows of a bot's table by their ids (up to 1,000 per call) |
botpress_list_files | List a bot's files (knowledge-base documents and other uploads) with id, key, content type, size, tags, status (upload or indexing state)… |
botpress_search_files | Semantic search over a bot's indexed files (its knowledge base): returns the passages that best match a natural-language query, with score… |
示例提示
- “这周大家问我们的客服机器人最多的是什么？总结一下最近对话的主要话题。”
- “机器人昨天为什么出错？查看它的问题列表和 9 点以后的错误日志。”
- “给我看我们的机器人过去 30 天的新用户、回访用户、会话数和消息数。”
- “在 Leads 表中找到邮箱为 [email protected] 的那一行，把状态改为 contacted。改之前先给我看改动。”
- “在机器人的知识库里搜索我们的退款政策，并告诉我答案来自哪个文件。”
FAQ
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。
下一步
这份指南对你有帮助吗?
