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 条评论

登录 后参与评论

还没有评论,来抢沙发~