Supabase MCP 是什么？
Supabase MCP 是 Supabase 官方提供的项目与数据库连接器。接入后，Codex 可以在指定 project_ref 和功能范围内读取表结构、查询数据、查看文档与项目状态，并可通过 read_only 参数关闭写入工具。
一句话理解让助手在限定项目和工具范围内查看 Supabase 数据库、文档与项目状态。
为什么需要它？
把数据库上下文带入任务，同时通过项目、功能集和只读模式缩小操作面。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
按项目连接 Supabase MCP
把真实信息带回当前任务，减少反复复制和手动核对。
限定 database、docs 等功能集
在明确授权范围内调用工具，并保留执行过程和结果。
通过 read_only=true 排除修改工具
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 查看 Supabase 项目和表结构
- 已经使用 Supabase，并需要在开发任务中查询数据库结构或项目信息的团队。
- 项目 ID、表名、字段和返回行数与控制台一致，并保留只读参数。
- 不适合先连生产库，或在没有审批的情况下运行迁移和写入。
- 非只读模式可能包含数据库或项目修改工具
- 数据库结果可能含个人信息和业务数据
怎么接入？
- 1准备
选择测试项目并记录 project_ref。
- 2授权
使用官方远程端点，URL 中加入
project_ref、read_only=true和必要 features。 - 3连接
在客户端完成授权并核对项目。
- 4开始使用
只读取一次表结构验证范围。
安装命令
添加 Supabase MCP
codex mcp add supabase --url "https://mcp.supabase.com/mcp?project_ref=YOUR_PROJECT_REF&read_only=true"先把 YOUR_PROJECT_REF 换成测试项目 ID；首次连接保留 read_only=true。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Supabase MCP
请帮我在当前电脑上接入并验证 Supabase MCP。
官方来源：https://github.com/supabase/mcp
目标接入命令：codex mcp add supabase --url "https://mcp.supabase.com/mcp?project_ref=YOUR_PROJECT_REF&read_only=true"
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Supabase MCP 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Supabase MCP 读取测试项目的表结构和每张表 3 行样例，保持只读，不执行 SQL 写入。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Supabase MCP 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Supabase MCP 读取测试项目的表结构和每张表 3 行样例，保持只读，不执行 SQL 写入。怎样算成功
项目 ID、表名、字段和返回行数与控制台一致，并保留只读参数。
- 先读取项目和表结构。
- 运行有限行数的只读查询。
- 把结果与 Supabase 控制台核对。
- 任何迁移、SQL 写入或项目管理需单独授权。
权限与安全
凭证与连接方式
远程 HTTP；首次保留 project_ref 和 read_only=true，使用最小项目权限。
- 非只读模式可能包含数据库或项目修改工具
- 数据库结果可能含个人信息和业务数据
- 生产库必须使用最小角色、项目隔离和独立审计
