Supabase MCP 0.16.0 更新：AI 可建立與執行筆記本，50 格與結果上限怎麼算？

請 AI 查一次資料很快，但同一輪排錯往往包含好幾段查詢。修正其中一格後，未必需要把前面的工作全部重做。

Supabase MCP 0.16.0 更新把建立與執行筆記本的工具打開，讓代理可以把查詢保存成一份可接續的工作，並在修正後只重跑需要的部分。

MCP 是讓 AI 連接外部服務的共用規格。在這裡，模型可以透過工具接近 Supabase 專案的資料與管理功能，能做多少則依工具與連線設定決定。

2026 年 11 月 5 日的新版本也加入刪除確認與執行限制。因此，新增的能力不只是把內容存起來，還包括每輪執行的範圍與停止方式。

我會優先讓已用 MCP 查詢與排錯的團隊評估它，因為保存步驟與局部重跑，能讓資料工作更容易交接。但結果大小上限不能當成帳單上限。

要知道這次改變了什麼，得先分清讀取既有筆記本和讓代理直接執行的差別。

Supabase MCP 新增筆記本工具，工作如何接續？

新版本讓代理建立與執行筆記本，從讀取既有內容跨到保存和重做查詢流程。0.16.0 發布紀錄列出 create_notebook 與 run_notebook，以及指定儲存格等新增能力。

這裡的筆記本不是一般文章頁面，而是把說明與查詢步驟放在一起的工作文件。每個儲存格是一段內容或操作，讓人與代理能沿著相同順序理解怎麼取得結果。

例如排查某個時段的登入異常，可能先看總量，再比較錯誤類型，最後查看相關日誌。如果這些步驟只有聊天裡的一次性工具呼叫，下一次查同樣問題時，就得重新拼出順序。

保存成筆記本後，工作可以保留在專案脈絡裡。當條件改變，代理有一個明確位置可修改，也能讓其他人知道這份結果經過哪些查詢。

根據新增工具的原始變更，先前建立與執行功能已經實作，但藏在內部未發布選項後面，筆記本功能組主要對外提供列出與讀取。

這次移除那個內部開關，讓建立與執行在筆記本功能組裡預設註冊。這描述的是該功能組能提供的工具，不表示所有客戶端、所有連線都自動顯示全部功能。

如果自己的連線只選了資料庫或文件工具，仍要看功能範圍是否包含筆記本。模型沒有看見工具時，要求它多試幾次，也不會讓連線自然多出能力。

能執行之後，第一個要確認的是一輪究竟會跑哪些儲存格。

選定儲存格執行，為什麼不會自動補依賴？

代理可以只重跑選定的查詢，但必須自己帶入需要的前置步驟。選定執行的變更說明新增一個可選的儲存格清單，不提供時仍執行整份文件。

如果代理只修正最後一段查詢，就可以指定該格，而不必連前面的日誌查詢一起重跑。這讓局部修改有比較明確的成本範圍，也減少已完成工作被再次執行。

但工具不會自動分析格子之間的依賴。若後面的查詢需要前面建立的狀態，選定範圍就要包含必要的準備，不能期待平台自己猜出完整工作鏈。

選中的格子仍按筆記本原順序執行，而不是照傳入清單的排列。這保留了文件本身的流程意義，避免同一份內容因呼叫順序不同，就變成另一種工作。

重複的識別值會去除重複，找不到的識別值或非查詢格則會回報跳過原因。這些回傳讓代理能辨認，是某格沒有需要執行的內容，還是引用了已經過期的位置。

空選擇與錯誤識別值怎麼處理？

如果送入空清單，或選擇裡完全沒有符合的查詢格，工具會在任何確認與查詢開始前，回傳呼叫錯誤。這表示沒有執行，不應被整理成成功完成但結果為空。

若只有部分識別值無效，則有效查詢可以繼續，無效部分保留跳過紀錄。團隊查看結果時，需要把完成與跳過分開，才能知道原本打算做的工作是否全部發生。

批准也和當次選擇綁定。同意執行一組格子，不等於之後換成另一組也自動得到同意，代理擴大工作範圍時，仍要依新範圍處理。

選擇範圍確定後，格數與結果上限才有明確的計算對象。

50 格與約 1 MB 上限，分別限制什麼？

格數限制控制一次提交的查詢數，結果預算則會在輸出累積後停止後面的執行。根據限制變更說明，兩者處理的是不同階段。

一次超過五十個查詢格，會在任何提示或查詢執行前被拒絕，代理會收到拆分工作提示。這不是先跑完前五十格，再默默把後面略過。

格數計算也與文件長度不同。一份有很多說明段落的筆記本，不會只因文字多就觸發五十格限制，因為這裡檢查的是本輪要執行的查詢格。

使用選定清單時，上限套用到選中的查詢格。原文件很長，但這次只選十格，就以這十格作為本輪範圍，無效且被跳過的識別值不計入。

五十是這個版本採用的起始值，並非永遠不變的產品規則。變更說明也指出，Studio 當時沒有相同的格數限制，因此不能把 MCP 的上限直接套到網頁編輯器。

結果預算用完，後面的查詢還會跑嗎？

約一 MB 限制的是這次呼叫累積的結果大小。一旦用完，後續查詢格會回報跳過，而且不再執行，避免已無法交回結果時，仍持續做後面的工作。

如果單一查詢結果太大，超過剩餘空間，該格會用掉剩餘預算，之後的查詢也會停下來。其他種類的錯誤則不會以同樣方式消耗結果預算。

這個上限不代表資料庫只讀取一 MB，也不表示只花費固定金額。資料庫可能掃描較多資料才產生一份小結果，查詢資源消耗與回傳內容大小是不同口徑。

因此，想降低工作量，仍應讓查詢對準必要時間、欄位與資料範圍。輸出較短可以減少模型讀取負擔，卻不能反過來保證資料庫的前段運算也很少。

取消請求也有界線，工具會停止後續格子，但已在執行中的格子仍會完成。這意味著使用者按下取消後，不能直接推定當前資料操作已被撤回。

此次變更尚未加入整輪執行期限。若需要保證某段工作在指定時間結束，還得看後端查詢、客戶端與後續版本各自提供什麼機制。

限制執行量不等於禁止改資料，寫入動作還有另外的確認規則。

唯讀、寫入與刪除確認，哪些動作會停下來？

工具依查詢類型決定是否需要確認，刪除筆記本還要求客戶端能顯示確認表單。這些安排影響的是執行權限，與前述格數和結果上限分開運作。

純讀取查詢可以不經確認，並以唯讀方式執行。變更說明列出一般查詢、顯示設定與解釋查詢計畫等類型，以及不含資料寫入的條件查詢。

相對地，程序呼叫、程式區塊、交易控制與設定修改等動作，會進入確認程序。接受之後，才以服務原本的執行模式處理，不能因為它位於筆記本，就當成只會讀資料。

這個分類也不等於只要看到 SELECT 就可執行任意寫入。若查詢裡呼叫會改資料的函式，唯讀模式仍可能讓它在資料庫端失敗。

刪除筆記本需要什麼客戶端？

刪除工具的原始變更使用 MCP 的表單確認能力，讓客戶端先把問題顯示給人，再決定是否刪除。

如果客戶端不支援這種表單，而且確認仍開啟，工具會拒絕操作。這與模型有沒有理解使用者說「刪掉」不同，連線本身也必須能完成指定互動。

系統提供明確設定，可略過特定刪除工具的確認。因此，文件中的確認是預設流程，不能寫成任何部署都無法跳過的強制保護。

對團隊而言，這個差別影響誰能設定自動化。如果某個環境選擇略過確認，應理解改變的是實際執行程序，而不只是讓畫面少一個提示。

查詢批准也不是未來任務的永久授權。當代理換了執行範圍，或把讀取工作延伸成資料修改，就需要重新依工具規則辨認這次會做什麼。

這些能力是否到達自己的環境，還得看安裝版本與平台連接方式。

開源版本與代管部署，採用前看哪些差異？

套件釋出代表原始碼與版本已公開，代管端和本機工具的能力仍可能不同步。專案 README也將代管、本機命令工具與自架環境分開說明。

代管連線可透過客戶端登入 Supabase，選擇需要的組織與專案。本機與自架入口只提供部分工具，也沒有同樣的 OAuth 2.1 流程，因此不能直接照搬另一種環境的操作預期。

OAuth 是讓使用者授權工具存取帳戶的方式。連線能成功登入，表示身分流程完成，仍不代表所需的新工具已由該部署提供。

此次日誌格的單格結果限制，也有明確的版本條件。原始變更指出，代管平台需要納入相應更新後才會套用，而本機仍經公開日誌介面取得結果，再依既有方式檢查。

因此，同樣看到 0.16.0 的發布頁，不能推定所有遠端伺服器已在相同時間採用同一份程式。遇到行為不同時，先區分套件版本與實際連到的平台，才能找到原因。

如果只需要某個專案，README 提供專案範圍設定，並可縮小工具功能組。對查詢工作，這能讓模型看到較符合任務的工具清單，減少無關的管理入口。

唯讀模式則是另一項選擇，並不等同於指定專案。前者限制能否改變資料，後者限制可操作哪個專案，兩者會改變不同的使用範圍。

對需要多人接力的排錯流程，保存筆記本的價值是留下工作方法，並非讓任何看到文件的人都自動取得原本帳戶的權限。真正能執行的工具仍沿各自的登入與平台設定。

版本與部署確認後，團隊才容易辨認問題出在模型、工具還是查詢本身。

延伸閱讀：Supabase Agent prompts 是什麼？讓 AI 代理定時查日誌、安全與慢查詢的設定與風險

延伸閱讀：Supabase 本地開發可免 Docker：AI 代理、pg-delta 與多工作目錄怎麼配合？

Supabase MCP 常見問題

五十格上限可以當成每月額度嗎？

它限制單次執行所選的查詢格，並非帳戶每月總額度。將一份長工作拆成多次，也不會讓資料庫原有的用量與費用限制消失。

工具回傳跳過，能算完成嗎？

需要看跳過原因。識別值無效、非查詢格或結果預算耗盡，都可能讓某格沒有執行，因此應將完成結果與跳過項目分開理解。

網頁能執行，就代表 MCP 同樣能做嗎？

不能只靠網頁畫面推定。Studio 與 MCP 有不同的入口與限制，所用工具版本、功能組與客戶端確認能力，也會影響實際可做的操作。

從一份局部重跑的工作，判斷是否值得採用

已經用 AI 查詢 Supabase 的團隊，可以先保存一份自己看得懂的排錯流程，再只重跑修正過的格子。觀察選定順序、跳過原因與回傳結果，會比只確認工具清單變長更有用。

這次更新讓代理能把資料工作留下來，並縮小每輪重新執行的範圍。先理解這個範圍如何與批准、輸出和版本接在一起，再搬入更多日常工作，才能保留可交接的查詢方法。