如何通过 MCP 将 Bubble 连接到 ChatGPT

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

Bubble + ChatGPT

让你的 AI 使用你的 Bubble 应用数据：查看应用开放了哪些数据类型和后端工作流，搜索和读取记录；经你确认后还能创建或修改记录，并运行后端工作流。

前提条件

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

BUBBLE_APP_URL, BUBBLE_API_TOKEN

步骤 1 — 获取凭证

1. 在 Bubble 编辑器中打开你的应用，进入 Settings → API，勾选 Enable Data API。然后逐一勾选 AI 可以访问的数据类型：没有勾选的类型对 AI 不可见。如果要让 AI 运行后端工作流，还要勾选 Enable Workflow API and backend workflows。
2. 在同一个标签页中点击 Generate a new API token，把令牌粘贴到 BUBBLE_API_TOKEN。
3. 把 BUBBLE_APP_URL 设为应用的地址，末尾不要加斜杠：正式版（live）用 https://yourapp.bubbleapps.io 或你自己的域名，例如 https://app.example.com。要使用开发版，在地址后加上 /version-test，例如 https://yourapp.bubbleapps.io/version-test。
4. 修改 API 设置后，把应用部署到正式版：正式版只认最近一次部署时的设置和令牌。
5. 安装连接器，然后用一次读取操作检查令牌，例如对你的某个数据类型运行 bubble_list_things。

连接测试只检查地址，不检查令牌：它确认你的应用在 BUBBLE_APP_URL 上有响应。令牌错误或尚未部署，要到第一次读取数据时才会以 401 暴露出来，所以请做一次这样的测试读取。

你需要拥有该应用的编辑权限。一个连接器对应一个 Bubble 应用；每多一个应用，就再添加一个连接器。

管理员令牌，受你的 API 设置限制：Settings 中生成的令牌以管理员身份操作。它会忽略应用的隐私规则（privacy rules），能看到你开放的数据类型的所有字段，但看不到你没有勾选的任何内容。要写入数据，每个数据类型还必须在其隐私规则中允许通过 API 创建、修改或删除。

能读取什么：应用开放的数据类型和后端工作流，包括每个类型的字段和每个工作流的参数；某个类型的记录（things），可按状态为待处理之类的条件筛选、排序，每页最多 100 条；以及按 ID 读取单条记录，包含创建日期、修改日期和创建者。

每次写入前都会先问你：bubble_create_thing、bubble_update_thing 和 bubble_run_workflow 会修改应用的数据，还可能触发应用自身的工作流、邮件或付款。每次调用前，AI 都会给你看数据类型和每个值，或者记录和具体改动，或者工作流及其参数，并等你同意。请先在 /version-test 地址上试验写入。

安装时默认关闭：bubble_delete_thing。管理员需要有意识地开启它；开启后，AI 会先给你看这条记录，在你确认后才删除。

类型名和字段名：在 API 中，类型名全部小写且没有空格（Rental Unit 变成 rentalunit），字段用应用的字段 ID 表示，例如 first_name_text，除非你的应用使用显示名称作为键。AI 在搜索或写入前，会先用 bubble_get_meta 和 bubble_get_data_types 读取这些名称。

个人数据：Bubble 应用经常存储用户、客户和付款信息。AI 只显示你需要的内容，绝不向不该看到的人列出用户记录，并把应用用户输入的文字当作数据，而不是指令。

容量：每个 Bubble 套餐都有工作负载（workload）上限，大量使用 API 会让应用对其用户变慢。AI 以小分页读取，避免对成千上万条记录做循环。在大多数套餐中，一次搜索最多返回 50,000 条记录。

常见错误：400：Bubble 不认识这个应用地址；请检查 BUBBLE_APP_URL，不要带 /api/1.1。401：令牌错误、已删除，或尚未部署到这个版本；请部署到正式版，或改用 /version-test 地址。404：Data API 未开启、该类型未勾选，或该工作流未开放。

该连接器不会构建或修改应用本身（页面、数据类型、工作流、隐私规则），不批量创建记录，不整体替换记录，也不上传文件。

步骤 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 权限。

1. 前往 chatgpt.com/plugins，点击 +，然后选择 Add custom MCP server。
2. 填写名称，例如 Name: Bubble。
3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。
4. 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
5. 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。

可用工具

示例提示

• “我们的 Bubble 应用开放了哪些数据类型和后端工作流？”
• “给我看本周创建的未处理支持请求，最新的排在前面。”
• “10 月份我们收到了多少个状态为已付款的订单？”
• “把 Anna Weber 11 月 12 日那笔预订的状态改为已确认。先给我看要改的内容。”
• “运行向 [email protected] 发送欢迎邮件的后端工作流。启动前先告诉我它有哪些参数。”

FAQ

ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse