跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Bubble，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 使用你的 Bubble 应用数据：查看应用开放了哪些数据类型和后端工作流，搜索和读取记录；经你确认后还能创建或修改记录，并运行后端工作流。
试试这样问
Bubble 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Bubble、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Bubble
让你的 AI 使用你的 Bubble 应用数据：查看应用开放了哪些数据类型和后端工作流，搜索和读取记录；经你确认后还能创建或修改记录，并运行后端工作流。
设置
- 在 Bubble 编辑器中打开你的应用，进入 Settings → API，勾选 Enable Data API。然后逐一勾选 AI 可以访问的数据类型：没有勾选的类型对 AI 不可见。如果要让 AI 运行后端工作流，还要勾选 Enable Workflow API and backend workflows。
- 在同一个标签页中点击 Generate a new API token，把令牌粘贴到
BUBBLE_API_TOKEN。 - 把
BUBBLE_APP_URL设为应用的地址，末尾不要加斜杠：正式版（live）用https://yourapp.bubbleapps.io或你自己的域名，例如https://app.example.com。要使用开发版，在地址后加上/version-test，例如https://yourapp.bubbleapps.io/version-test。 - 修改 API 设置后，把应用部署到正式版：正式版只认最近一次部署时的设置和令牌。
- 安装连接器，然后用一次读取操作检查令牌，例如对你的某个数据类型运行
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 未开启、该类型未勾选，或该工作流未开放。
该连接器不会构建或修改应用本身（页面、数据类型、工作流、隐私规则），不批量创建记录，不整体替换记录，也不上传文件。
前提条件: BUBBLE_APP_URL, BUBBLE_API_TOKEN
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 Bubble 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
bubble_get_meta | Read what the Bubble app exposes through its API: the data types the Data API can reach (dataTypes), and the backend workflows the Workflow… |
bubble_get_data_types | Read the data types of the Bubble app with their fields: for each type its display name and fields with id (the key to use in constraints… |
bubble_list_things | List or search the things (records) of one data type, up to 100 per call |
bubble_get_thing | Read one thing of a data type by its unique id: all fields the token may see, plus _id, Created Date, Modified Date and Created By |
bubble_create_thing | Create a new thing of a data type |
bubble_update_thing | Change fields of an existing thing; fields left out keep their value |
bubble_run_workflow | Run a backend workflow exposed through the app's Workflow API |
bubble_delete_thing | Delete one thing for good |
示例提示
- “我们的 Bubble 应用开放了哪些数据类型和后端工作流？”
- “给我看本周创建的未处理支持请求，最新的排在前面。”
- “10 月份我们收到了多少个状态为已付款的订单？”
- “把 Anna Weber 11 月 12 日那笔预订的状态改为已确认。先给我看要改的内容。”
- “运行向 [email protected] 发送欢迎邮件的后端工作流。启动前先告诉我它有哪些参数。”
下一步
这份指南对你有帮助吗?
