Bubble MCP 接入指南：Claude Code 設定、修改驗收與回復限制

Bubble MCP 與 Agent 2，先依工作位置選擇#

需要在編輯器內邊看預覽邊調整 App，可以先用 Agent 2；已有外部 Agent 工作流程、想帶入規格或其他工具的上下文，才考慮 MCP。兩者的結果都仍是可在 Bubble visual editor 檢視的 App，不應把 MCP 理解為匯出任意框架的原始碼。

費用也分開看。官方公告說 MCP 不消耗 Bubble AI credits，但外部 AI 供應商的用量、費用與限制仍適用。這不免除 App 方案原本的功能限制。Agent 2 的編輯與圖片生成則使用 AI credits；選擇時先確認工作流在哪裡執行，不要把「MCP 不扣 credits」當成整個 App 免費運作。

Claude Code 加入 Bubble MCP#

先準備可使用的 Claude Code 與 Bubble 帳號，並選一個沒有真實個資的測試 App。Bubble 官方手冊提供以下 HTTP server 設定：

1
claude mcp add --transport http --scope user bubble https://mcp.bubble.io/mcp

--scope user 會讓設定在你的 Claude Code 專案間可用。若只想在特定專案試用，先依 Claude Code 的 scope 文件選擇範圍，不要為了方便把所有工作流都接上。

接著在 Claude Code 輸入 /mcp，選擇 bubble 並進行 authentication；瀏覽器會開啟 Bubble 登入與授權流程。核對登入身份與要求的權限後才繼續。加入 URL 與完成登入是兩個步驟，看到設定項目不代表 server 已能代表帳號操作。

目前手冊指出 server 使用 CIMD（Client ID Metadata Documents），部分 client 尚不支援，並列出 Cursor 與 Composio。若登入流程失敗，先查 client 的當前支援；不要只因其他工具都支援 MCP，就認定登入規格也相同。這是查核當日的文件限制，後續可能改變。

Bubble 是遠端 HTTP MCP，與 Proxyman 的本機執行檔接入方式不同；不要把本機 stdio server 的設定格式直接套用過來。

權限沿用帳號，Live database 說明仍待釐清#

手冊說 MCP 以登入的 Bubble 使用者身份操作，collaborator 的權限與 App 方案限制仍適用。工具清單包含修改頁面、建立 privacy rule，以及建立、更新與刪除 records；它不只是讀取 App 結構的工具。

有一項值得先停下來確認：查核當日，手冊的資料存取段落寫「Live database 可讀」，同段表格卻將 Live 的 Read 與 Write 都列為 No。這兩處互相矛盾，本文無法確認目前 Live database 是否可讀。 在官方說明一致、且帳號授權範圍可驗證前，不要宣稱 Agent 一定讀不到正式資料，也不要把需要 Live data 的排錯任務視為已受支援。

手冊另提醒，Agent 讀取的 records 會送到所用的 AI 供應商。測試 App 的 development database 也應使用合成資料，並核對管理者允許存取的 data types；「開發資料」不會自動等於「不敏感」。

分兩次 prompt，先盤點再修改#

第一個 prompt 應給出 App 與 branch 的明確名稱，並限制操作：

1
目標是測試 App <App 名稱> 的 <branch 名稱>。
2
先確認帳號身份、App 和 branch，列出頁面與 workflow 的結構。
3
不要讀取 records、不要建立或修改任何內容。
4
若無法確認目標，停止並回報缺少的資訊。

這是給 Agent 的操作指示，不是 server 端權限隔離。完成後在 Bubble 編輯器核對目標，再進入小修改，例如只改測試頁面的靜態文字：

1
先建立此次修改前的 savepoint，回報識別資訊。
2
僅修改 <測試頁面> 的 <指定元素>，把靜態文字改為「測試完成」。
3
不要修改 workflow、privacy rule、data type 或 records。
4
完成後列出實際改動、執行 App issue check，提供 preview link。
5
不要合併 branch 或部署。

驗收不能只看 Agent 回覆「完成」。在編輯器核對該元素，查看 change log 是否只有預期修改，打開 preview 確認畫面；若任務涉及表單或 workflow，還要測成功、失敗與權限不足的分支。issue check 沒有錯誤，也不能證明業務流程符合需求。

官方當前限制包括不能 merge branches、不能 deploy；OAuth2 setup 仍留在編輯器，付費 plugin 需先購買才可由工具安裝。正式發布應留在人工確認後的編輯器流程，不要把 preview link 當成已部署證明。

Savepoint 不能回復所有資料操作#

MCP 修改不會進入 Bubble editor 的 undo history，按編輯器的 Undo 不會撤回這些改動。官方提供請 Agent undo 或 restore savepoint 的方式，但有兩個限制：

• restore savepoint 會覆蓋建立之後的變更，包含你或同事在編輯器做的修改。回復前應核對時點與 change log，避免一起消除其他人的工作。
• Agent 刪除的 database records 不能靠 undo 還原；savepoint 可回溯的範圍也受方案影響。

因此，第一次測試不要用刪除 records 或重建整份資料模型。先驗證一個靜態元素的修改與回復，再逐步擴大操作範圍。要把 MCP 納入日常工作，至少保留 App／branch、修改前 savepoint、實際改動與驗收結果；讀寫權限有疑問時，先解決權限證據，再讓 Agent 執行資料任務。

參考資料：

Bubble：Agent 2 與 Bubble MCP 公告

Bubble MCP：接入、工具、權限與回復限制

Bubble：2026 年 10 月官方社群更新

Claude Code：MCP installation scopes