Supabase 官方 MCP Server 怎麼配:OAuth 與只讀模式(read-only)、查表建遷移與生產庫防誤刪設定

連接 Supabase 官方遠程 MCP 伺服器 https://mcp.supabase.com/mcp 支持 OAuth 登入、單項目限定與 read_only 只讀參數。本文整理配置步驟、查表建遷移工具及生產庫防誤刪設定。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

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

Supabase 官方 MCP 開發與生產配置對比

圖:本站根據 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_refproject_ref=abcdefghijkl鎖定單個項目;不填則預設可訪問授權組織下的全部項目
read_onlyread_only=true開啟只讀模式,屏蔽寫數據、應用遷移與提交反饋等變更工具
featuresfeatures=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 配置步驟

  1. 在終端把帶參數的 URL 添加為項目級 HTTP 伺服器(含 & 號時外層必須加英文雙引號):
bash
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?project_ref=你的項目ID&read_only=true"
  1. 按官方說明,在系統常規終端運行 claude 並輸入 /mcp,選中 supabase 後點擊認證(Authenticate)。
  2. 在彈出的瀏覽器頁面登入 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 官方文檔:Supabase MCP Server 整理的示意圖

四、生產庫防誤刪的四條硬規則

  1. 測試與生產分設獨立連接名:測試庫配可寫的 supabase-dev,生產庫配帶 read_only=true 的 supabase-prod 且平時關閉。
  2. 認清服務端確認(Elicitation)的邊界:客戶端支持表單確認時,execute_sql 與 apply_migration 遇到破壞性 SQL 會暫停確認,create_project 與 create_branch 會觸發費用確認(Cost confirmation);若客戶端不支持或被規則自動放行則無法兜底。
  3. 關閉寫工具免審:切勿在客戶端對 execute_sql、apply_migration 勾選「始終允許」。
  4. 裁剪高危分組:日常寫業務代碼時從 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,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~