结论先说
- 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 条评论
还没有评论,来抢沙发~