1. 為什么要把 Claude Code 接到 Supabase 上Claude Code 單獨用的時候本質(zhì)上還是一個「讀代碼、寫代碼」的助手。你讓它改一個 React 組件、補一段 SQL、解釋一個報錯它都能干得不錯。但它看不到你數(shù)據(jù)庫里真實有什么表、字段類型是什么、有沒有索引、外鍵怎么連的。每次要寫查詢你得手動把 schema 貼給它或者來回切換 Supabase 控制臺復制粘貼。我試過在幾個真實項目里這么干最煩的不是寫 SQL而是「上下文對不上」。比如你讓 Claude 寫一個orders表的統(tǒng)計查詢它默認按created_at字段來分組但你庫里實際叫order_time跑出來直接報column does not exist。這種錯不致命但一次一次修很消耗耐心。Supabase MCP 解決的就是這個問題。MCP 全稱 Model Context Protocol是 Anthropic 推出的一個標準協(xié)議讓 Claude 能通過統(tǒng)一的接口去訪問外部系統(tǒng)——數(shù)據(jù)庫、文件系統(tǒng)、第三方 API 都行。Supabase 本身是開源的 Postgres自帶 REST API、鑒權(quán)、存儲和 Edge Functions免費層就能跑一個完整后端。把這兩個接起來之后Claude Code 就能直接讀你的表結(jié)構(gòu)、生成 SQL、執(zhí)行查詢、插入數(shù)據(jù)甚至根據(jù)真實 schema 幫你寫前端調(diào)用代碼。適合誰用三類人最明顯一是獨立開發(fā)者一個人要同時管前端、后端和數(shù)據(jù)庫想讓 AI 幫忙分擔數(shù)據(jù)庫這塊二是做 AI 編程出海方向的同學Supabase 在海外項目里用得非常多配合 Claude Code 能明顯提速三是剛接觸 Postgres 的新手讓 Claude 幫你把「建表、插數(shù)據(jù)、查結(jié)果」這條鏈路跑通比對著文檔啃快得多。這篇會從連接配置講到一次完整的建表查詢驗證中間給出可復制的 MCP 配置片段并且把 endpoint 統(tǒng)一改到 TaoToken 的 Key 通道這樣你只需要維護一個 Key不用在多個平臺之間來回切換。2. 前置準備TaoToken 統(tǒng)一 Key 通道與 MCP 環(huán)境在動手配 Supabase MCP 之前先把「Claude Code 怎么調(diào)用模型」這件事理順。Claude Code 默認走的是 Anthropic 官方通道但國內(nèi)直連經(jīng)常不穩(wěn)定而且 Key 管理分散。TaoToken 提供的是一個統(tǒng)一的 Key 通道把模型調(diào)用收斂到一個 endpoint 上Claude Code、Cline、Codex 這些工具都能共用同一個 Key。先注冊并拿到 Key。打開官網(wǎng) https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊后在控制臺里創(chuàng)建一個 API Key。控制臺地址是 https://taotoken.net/console Key 管理頁面在 https://taotoken.net/api-keys 。創(chuàng)建完記得復制保存頁面刷新后就不再完整顯示了。拿到 Key 之后Claude Code 這邊需要設置兩個環(huán)境變量。Base URL 指向https://taotoken.net/api注意這個地址不加任何 UTM 參數(shù)就是純 API 入口。Key 就是你剛復制的那串。export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密鑰如果你用的是 Claude Code 的配置文件方式可以在~/.claude/settings.json里寫{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密鑰 } }Model ID 這塊Claude Code 默認會請求claude-sonnet-4-5這類模型標識TaoToken 通道是兼容的你不需要額外改。如果遇到模型找不到的報錯去 https://taotoken.net/doc 查一下當前支持的模型列表把 Model ID 對齊即可。接下來是 Supabase 側(cè)的準備。你需要一個 Supabase 項目登錄 supabase.com 新建一個記下兩個東西項目 URL形如https://xxxx.supabase.co和 service_role key在 Project Settings → API 里注意用 service_role 而不是 anon因為 MCP 要執(zhí)行建表和寫入操作。這兩個值后面會寫進 MCP 配置里。MCP 的運行環(huán)境需要 Node.js。確認一下版本node -v npm -vNode 18 以上就行。然后建一個專門放 MCP 腳本的目錄我習慣放在~/.mcp/supabase下面方便統(tǒng)一管理。mkdir -p ~/.mcp/supabase cd ~/.mcp/supabase npm init -y npm install supabase/supabase-js裝完supabase/supabase-js之后這個目錄里就有了node_modules后面 MCP 腳本直接 require 它就行。這一步別跳過很多人配 MCP 失敗就是因為腳本里 import 了一個沒裝的包。3. 可復制的 Supabase MCP 配置片段這一節(jié)給出完整的配置文件路徑和原文保持一致你直接復制改幾個值就能用。先創(chuàng)建 MCP 服務腳本。在~/.mcp/supabase/index.js里寫入#!/usr/bin/env node import { createClient } from supabase/supabase-js; const [, , url, key] process.argv; if (!url || !key) { console.error(缺少 Supabase URL 或 Key); process.exit(1); } const supabase createClient(url, key); // 簡單的連通性檢查 const { data, error } await supabase.from(_mcp_health).select(*).limit(1); if (error error.code ! PGRST205) { console.error(連接失敗:, error.message); process.exit(1); } console.log(Connected to Supabase:, url);注意這里用了一個_mcp_health表做探活如果表不存在會返回PGRST205表未找到這其實說明連接是通的只是表還沒建所以代碼里把這個錯誤碼排除掉。這樣你第一次跑的時候不會因為表不存在而誤判連接失敗。然后是 Claude Code 的 MCP 配置文件。原文用的是~/.mcp/config.toml我們保持一致[mcp.supabase] command node args [ /Users/你的用戶名/.mcp/supabase/index.js, https://xxxx.supabase.co, your_service_role_key ]三個地方要改/Users/你的用戶名/換成你本機的實際路徑Windows 下是C:\\Users\\你的用戶名\\.mcp\\supabase\\index.jshttps://xxxx.supabase.co換成你的 Supabase 項目 URLyour_service_role_key換成 service_role key。如果你用的是 Cline 或者 Claude Code 的 MCP 配置界面格式會略有不同通常是 JSON{ mcpServers: { supabase: { command: node, args: [ /Users/你的用戶名/.mcp/supabase/index.js, https://xxxx.supabase.co, your_service_role_key ] } } }這里有個關鍵點Base URL、Key、Model ID 三件套要寫全。Base URL 是 TaoToken 的https://taotoken.net/apiKey 是 TaoToken 的 API KeyModel ID 是 Claude 的模型標識。Supabase 的 URL 和 Key 是另一套別混在一起。很多人配錯就是把 Supabase 的 key 填到了 ANTHROPIC_API_KEY 里結(jié)果模型調(diào)用直接 401。配置寫完后重啟 Claude Code 或者重新加載 MCP 配置。在 Claude Code 里輸入/mcp可以查看當前加載的 MCP 服務列表看到supabase就說明配置被讀到了。4. 驗證請求一次建表查詢的完整動作配置好之后最重要的就是驗證它真的能跑通。別急著讓 Claude 寫復雜業(yè)務先用一個最小閉環(huán)建表 → 插數(shù)據(jù) → 查結(jié)果。打開 Claude Code在對話里輸入我已經(jīng)配置了 Supabase MCP請先檢查數(shù)據(jù)庫連接是否正常。如果配置正確Claude 會調(diào)用 MCP 的探活邏輯返回類似Connected to Supabase: https://xxxx.supabase.co的信息。如果返回的是連接失敗或者超時先去看第 5 節(jié)的排查。連接確認后讓它建一張表幫我在 Supabase 里新建一個 users 表字段有 iduuid 主鍵、nametext、emailtext、created_attimestamp 默認 now。Claude 會生成這樣的 SQL 并通過 MCP 執(zhí)行create table users ( id uuid primary key default gen_random_uuid(), name text not null, email text not null unique, created_at timestamp default now() );執(zhí)行成功后你可以讓它插一條數(shù)據(jù)往 users 表插入一條記錄name 是 Miaomiaoemail 是 hiexample.com。對應的操作是await supabase.from(users).insert({ name: Miaomiao, email: hiexample.com });最后查詢驗證查詢 users 表的所有記錄。Claude 會返回類似[ { id: a1b2c3d4-..., name: Miaomiao, email: hiexample.com, created_at: 2025-01-15T10:30:00 } ]到這一步整條鏈路就通了。Claude Code 通過 MCP 讀到了真實表結(jié)構(gòu)生成了正確的 SQL執(zhí)行后拿到了真實數(shù)據(jù)。后面你再讓它寫前端調(diào)用代碼它就能基于真實的字段名來寫不會再出現(xiàn)order_time寫成created_at這種問題。如果你想驗證模型通道是否也走通了可以打開 https://taotoken.net/models 用同一個 Key 做一次對話測試確認模型側(cè)和數(shù)據(jù)庫側(cè)兩條鏈路都正常。5. 常見報錯排查401、local proxy failed、reading choices配 MCP 的過程里報錯基本集中在幾個地方。我把踩過的坑列出來對照著查會快很多。401 Unauthorized。這個最常見分兩種。一種是模型調(diào)用返回 401說明 TaoToken 的 Key 不對或者沒生效。檢查ANTHROPIC_API_KEY是不是完整復制了有沒有多余空格。另一種是 Supabase 返回 401說明 service_role key 填錯了或者用了 anon key 去執(zhí)行建表操作。anon key 權(quán)限不夠建表會直接被拒。確認你用的是 service_role key。local proxy failed。這個報錯通常出現(xiàn)在 Claude Code 啟動階段意思是它連不上你配置的 Base URL。先確認ANTHROPIC_BASE_URL寫的是https://taotoken.net/api不要帶路徑后綴也不要帶 UTM 參數(shù)。然后用 curl 測一下curl -X POST https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的密鑰 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-5,max_tokens:100,messages:[{role:user,content:hi}]}如果 curl 能通但 Claude Code 不通那就是 Claude Code 的配置文件沒被讀到檢查~/.claude/settings.json的路徑和格式。reading choices 報錯。這個一般出現(xiàn)在 MCP 返回的數(shù)據(jù)格式不對的時候。Claude Code 期望 MCP 返回結(jié)構(gòu)化的 JSON如果你的腳本里console.log混入了非 JSON 內(nèi)容解析就會失敗。檢查index.js里除了必要的日志不要輸出多余內(nèi)容。探活那條console.log是允許的但別在數(shù)據(jù)返回路徑上打日志。OAuth 相關報錯。Supabase 的某些操作需要 OAuth token如果你用的是 service_role key 直連一般不會觸發(fā)。但如果報 OAuth 錯誤說明你的 Supabase 項目開啟了 RLS行級安全且策略不允許 service_role 繞過。去 Supabase 控制臺的 Authentication → Policies 里檢查一下或者臨時關掉 RLS 測試。MCP 服務沒加載。在 Claude Code 里輸入/mcp看不到 supabase說明配置文件路徑不對或者 TOML 格式有誤。TOML 對縮進和引號敏感args數(shù)組里的每一項都要用雙引號路徑里的反斜杠在 Windows 下要轉(zhuǎn)義。建表成功但查詢報 column does not exist。這說明 Claude 生成的 SQL 字段名和實際表結(jié)構(gòu)不一致。讓 Claude 先執(zhí)行一次select * from information_schema.columns where table_name users把真實字段拉出來再基于結(jié)果寫查詢。這也是 MCP 的價值所在——它能自己查 schema不用你手動貼。6. 把這條鏈路用起來從建表到前端調(diào)用跑通驗證之后這條鏈路能做的事情比想象中多。我平時的工作流是這樣的先在 Claude Code 里用自然語言描述需求讓它通過 MCP 建表、加索引、插測試數(shù)據(jù)確認數(shù)據(jù)結(jié)構(gòu)沒問題之后再讓它基于真實 schema 生成 Next.js 的 API 路由和前端頁面。比如讓它寫一個用戶列表接口基于 users 表幫我寫一個 Next.js 的 /api/users 路由用 Supabase SDK 查詢所有用戶并返回 JSON。Claude 會生成類似這樣的代碼import { createClient } from supabase/supabase-js; const supabase createClient( process.env.SUPABASE_URL, process.env.SUPABASE_ANON_KEY ); export default async function handler(req, res) { const { data, error } await supabase.from(users).select(*); if (error) return res.status(500).json({ error: error.message }); res.status(200).json(data); }因為 Claude 已經(jīng)通過 MCP 看過真實的users表結(jié)構(gòu)它生成的字段名、類型都是對的你復制過去基本不用改。這就是「可對話式數(shù)據(jù)庫開發(fā)」的實際體驗——不是讓 AI 替你寫代碼而是讓它在真實上下文里寫代碼。長期做編碼和 Agent 方向的話可以考慮用 Coding Plan把模型調(diào)用和 MCP 工具鏈統(tǒng)一管理地址是 https://taotoken.net/coding-plan 。如果只是想先驗證模型通道用模型對話頁面測一下就行https://taotoken.net/models 。接入文檔在 https://taotoken.net/doc API Key 管理在 https://taotoken.net/api-keys 。最后說一個實用技巧把 Supabase 的 URL 和 Key 放到環(huán)境變量里不要硬編碼在 MCP 配置文件中。這樣你換項目的時候只需要改環(huán)境變量配置文件不用動。Claude Code 的 MCP 配置支持讀取環(huán)境變量把args里的值換成process.env.SUPABASE_URL和process.env.SUPABASE_KEY就行。