結論先說
- Supabase 官方託管了遠程 MCP 伺服器
https://mcp.supabase.com/mcp,採用瀏覽器 OAuth 登入授權,不需要在本地配置文件裏硬編碼個人訪問令牌。 - 連接線上生產庫務必加上
read_only=true與project_ref參數,既禁止寫操作,又防止 AI 跨項目讀取同組織下的其他數據庫。 - 改表結構應優先調用
apply_migration而非直接跑execute_sql,讓結構變更留存在遷移記錄裏,方便版本回溯和本地同步。 - 服務端自帶破壞性 SQL 與費用二次確認(Elicitation),但官方提醒這只是護欄而非安全承諾,開發調試應優先連獨立分支或測試項目。
- 主力模型訂閱與帳號配套入口:跑通 MCP 工具鏈與多文件智能體編碼依賴穩定的底層大模型配額,國內免境外卡自助開通可見本站 Claude Code 訂閱頁、ChatGPT Plus 充值頁 與 AI 會員充值總覽。

圖:本站根據 Supabase 官方文檔:Supabase MCP Server 整理的示意圖
本文根據 Supabase 官方文檔《Supabase MCP Server》及 Claude Code 文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Supabase 或 Anthropic 官方網站。
適用於誰
- 想在 Claude Code 或 Cursor 裏直接查 Postgres 表結構、生成 TypeScript 類型、寫數據庫遷移(Migration)的開發者;
- 擔心 AI 誤跑刪表語句或改壞線上數據,想搞懂
read_only=true與單項目隔離怎麼配的人; - 配置
mcp.supabase.com後卡在組織授權或找不到指定工具分組的用戶。
一、拼接連接 URL:項目鎖定、只讀與功能組
Supabase 官方通過 URL 查詢參數控制連接權限與暴露的工具範圍,最關鍵的三個參數如下:
| 參數名 | 示例寫法 | 作用說明 |
|---|---|---|
project_ref | project_ref=abcdefghijkl | 鎖定單個項目;不填則預設可訪問授權組織下的全部項目 |
read_only | read_only=true | 開啟只讀模式,屏蔽寫數據、應用遷移與提交反饋等變更工具 |
features | features=database,debugging,docs | 按需啟用分組以節省上下文(storage 存儲桶組預設關閉) |
如果連線上庫做數據核對或慢查詢分析,建議固定使用帶只讀和單項目鎖定的地址:
text
https://mcp.supabase.com/mcp?project_ref=你的項目ID&read_only=true&features=database,debugging,docs
數據庫 MCP 的通用限權思路還可參考 Claude Code 寫後端接口、連數據庫 與 Claude Code 用數據庫 MCP 查數據、出報表。
二、在 Claude Code 與 Cursor 中完成 OAuth 授權
1. Claude Code 配置步驟
- 在終端把帶參數的 URL 添加為項目級 HTTP 伺服器(含
&號時外層必須加英文雙引號):
bash
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?project_ref=你的項目ID&read_only=true"
- 按官方說明,在系統常規終端運行
claude並輸入/mcp,選中supabase後點擊認證(Authenticate)。 - 在彈出的瀏覽器頁面登入 Supabase,核對下拉框選中的組織(Organization)包含你的目標項目,批准即可生效。若高頻讀寫表結構導致終端會話額度告急,可在本站了解 Claude Code 訂閱充值。
2. Cursor 配置步驟
在項目 .cursor/mcp.json 或 .mcp.json 寫入:
json
{
"mcpServers": {
"supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp?project_ref=你的項目ID&read_only=true"
}
}
}
儲存後進入設定(Settings)> Cursor Settings > 工具與 MCP(Tools & MCP)完成網頁登入,必要時重啟客戶端刷新工具列表,詳見 Cursor MCP 配置教學。
編程訂閱與高配額省心方案:在 Cursor、Claude Code 或 Codex 裏掛載外部工具做長鏈路開發時,固定月費訂閱通常比純按量 API 更易控成本。本站支持支付寶、微信支付與 AlipayHK 免密自助兌換 Claude Pro、Claude Max 與 ChatGPT Pro,團隊協作亦可定製 ChatGPT Business 團隊版。
三、查表、建遷移與日誌分析核心工具
在測試項目去掉 read_only=true 後,常用工具按分組包括:
- 數據庫組(
database):list_tables查表清單、list_extensions查已安裝的 Postgres 擴展、list_migrations與apply_migration管理和執行結構遷移、execute_sql跑普通數據查詢;日常新增索引、修改列類型或補齊外鍵約束時,都應該明確要求模型走遷移工具而非臨時執行語句,避免線上與測試環境結構脫節; - 開發組(
development):generate_typescript_types按最新 Schema 自動導出前後端可直接引用的 TypeScript 類型定義,改完表後讓助手順手刷新本地類型文件能省掉手工同步字段的麻煩,get_project_url與get_publishable_keys則用於讀取項目公開連接地址和匿名公鑰; - 調試與分支組(
debugging/branching):query_logs支持用只讀 SQL 過濾和聚合項目日誌,get_advisors自動掃描行級安全策略(RLS)漏配或缺失索引問題;若開啟實驗性分支功能,還能先在預覽分支驗證複雜結構變更再合入主分支。

圖:本站根據 Supabase 官方文檔:Supabase MCP Server 整理的示意圖
四、生產庫防誤刪的四條硬規則
- 測試與生產分設獨立連接名:測試庫配可寫的
supabase-dev,生產庫配帶read_only=true的supabase-prod且平時關閉。 - 認清服務端確認(Elicitation)的邊界:客戶端支持表單確認時,
execute_sql與apply_migration遇到破壞性 SQL 會暫停確認,create_project與create_branch會觸發費用確認(Cost confirmation);若客戶端不支持或被規則自動放行則無法兜底。 - 關閉寫工具免審:切勿在客戶端對
execute_sql、apply_migration勾選「始終允許」。 - 裁剪高危分組:日常寫業務代碼時從
features剔除account與branching,避免誤建付費實例。
常見問題
問:為什麼連上後沒有操作 Storage 存儲桶的工具?
答:官方文檔註明 storage 組預設關閉。需在 URL 的 features 參數裏加上 storage 重連後才會顯示 list_storage_buckets 等工具。
問:OAuth 登入成功卻報找不到項目怎麼辦?
答:多半是網頁授權時選錯了 Organization。斷開重連並在授權頁切換到該項目所屬的組織。
問:配置 Edge Function 密鑰會把明文發給大模型嗎?
答:客戶端支持 URL Elicitation 模式時,調用 create_edge_function_secret 會彈出連結讓你去 Supabase 控制檯安全填寫,避免密鑰明文進對話。
問:配置好開發環境後,國內沒有外幣卡怎麼開通 Claude 或 ChatGPT 編程訂閱?
答:可在 本站充值中心 自助選購卡密開通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。
相關教學
- Claude Code 寫後端接口、連數據庫:只讀帳號加 MCP 查表結構
- Claude Code 用數據庫 MCP 查數據、出報表
- Claude Code MCP 配置教學:claude mcp add、配置文件位置與常用 MCP
- Cursor MCP 配置教學:mcp.json 寫法、項目與全局位置、OAuth 與連接失敗排查
參考資料
- Supabase 官方文檔:Supabase MCP Server — https://supabase.com/docs/guides/ai-tools/mcp
- Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
0 條評論
還沒有評論,來搶沙發~