supabase 快速入门

用最像 SQL 的方式,在 5 分钟内搭好一个带认证、数据库和实时功能的全栈后端。

这是什么?解决什么问题?

Supabase 被称为”开源的 Firebase 替代品”,本质是把 PostgreSQL、Auth、Storage、Realtime、Edge Functions 打包成一套开箱即用的 BaaS(后端即服务)。对前端开发者来说,过去要花一两天搭的”用户注册 + 数据表 + 权限控制”组合,现在只要 10 分钟就能跑起来。

supabase Skill 是 Supabase 官方维护的 MCP Server,它把 Supabase 的所有能力(建表、查数据、跑迁移、调用 Edge Function、上传文件、查日志)暴露成 AI 助手可以直接调用的工具集。当你在 Claude Code 或 Cursor 里加载这个 Skill 后,AI 不仅能”写”SQL,还能真的去执行迁移、读取数据、生成 TypeScript 类型。

它解决的核心痛点是:新手往往不知道 Supabase 的 RLS(行级安全)策略怎么写、迁移文件怎么组织、Realtime 频道怎么订阅。这个 Skill 把这些”最佳实践”内化进 AI 的回答里,降低踩坑概率。适合独立开发者快速原型验证、小团队做 MVP、教育场景教学演示。

准备工作

1. Node.js 18+ 或 Python 3.10+ 任一环境
2. Supabase 账号:免费注册 https://supabase.com/dashboard
3. Claude Code / Cursor / Cline 等支持 MCP 的 AI 客户端
4. 可选:supabase CLI(本地开发、跑迁移必备):https://github.com/supabase/cli

3 步快速上手

第 1 步:安装 Skill(以 Claude Code 为例)

通过 MCP 协议加载:

claude mcp add --transport http supabase https://mcp.supabase.com/mcp

如果是 Cursor,在 .cursor/mcp.json 写入:

{
  "mcpServers": {
    "supabase": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

第 2 步:验证安装

打开 AI 客户端,执行:

请列出当前 supabase 项目下所有的表

如果返回了真实表名(或空表列表),说明 MCP 已连通。

第 3 步:用 Skill 建一张表

对 AI 说:

用 supabase Skill,帮我在 todos 表里添加一个 is_done 字段,类型 boolean,默认 false

AI 会自动生成并执行 SQL 迁移,而不是只给你一段代码。这是 Supabase MCP 区别于普通文档 Skill 的最大优势。

常见踩坑

1. RLS 没开启导致数据裸奔:新建表后,Supabase 默认 关闭 RLS,任何带 anon key 的请求都能读全部数据。新表上线前必须 ALTER TABLE x ENABLE ROW LEVEL SECURITY;。
2. anon key 和 service_role key 混用:前端代码里只能用 anon key(安全可控的、受 RLS 约束),service_role key 拥有上帝权限,只能放在后端环境变量里,绝不能进前端 bundle。
3. 迁移文件冲突:多人协作时如果都用 mcp 跑迁移,会出现迁移序号冲突。团队协作建议在本地用 supabase migration new 走 Git 流程,再统一 supabase db push。
4. Realtime 订阅性能问题:默认 Realtime 走的是 WebSocket 长连接,单表订阅超过 1000 行/秒会触发限流。大量场景建议改用 Postgres CDC + 自建后端消费。
5. Edge Function 冷启动:Deno 部署,首次调用延迟可能在 200-500ms,实时性要求高的接口建议提前预热。
6. TypeScript 类型不会自动同步:如果只用 MCP 改表,前端 supabase-js 的类型不会更新,需要 supabase gen types typescript 重新生成。

初级用法

1. Auth 接入:在前端用 supabase.auth.signUp({ email, password }) 注册,supabase.auth.signInWithPassword 登录,session 自动存到 localStorage。
2. CRUD 一行搞定:supabase.from('todos').select('*') 查、insert 增、update 改、delete 删,语法接近 SQL。
3. Storage 上传:supabase.storage.from('avatars').upload('user1/avatar.png', file),配合公开桶或签名 URL 即可访问。

高级玩法

1. Postgres 触发器 + Edge Functions:数据库事件触发 serverless 函数,例如”用户注册后自动发欢迎邮件”,无需写后端服务。
2. 向量搜索(pgvector):Supabase 自带 pgvector 扩展,可以直接存 embedding 做语义检索,适合做 RAG 应用。
3. 跨项目复制:在 Supabase Dashboard 启用 Logical Replication,把生产库的数据镜像到本地或另一个区域做灾备。

小技巧

• 在 SQL 编辑器里用 explain analyze 看查询计划,慢查询一般都能从索引上找原因。
• 免费版项目闲置 7 天会暂停,长期 demo 项目建议用 cron 定时 ping 一下。
• 启用 auto_increment 字段建议用 bigint generated by default as identity,比老的 serial 类型更标准。
• 跑迁移前先在本地 supabase db reset 验证一次,避免直接污染生产。
• 调试 RLS 策略时,可以用 set role anon; 切换到匿名用户身份执行 SQL,模拟前端请求。

常见问题 FAQ

Q1: 这个 Skill 跟 supabase 有什么关系?必须装吗?

A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?

A: supabase 来自 community,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?

A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了?

A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗?

A: 取决于 supabase 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

进阶学习建议

如果想进一步用好 supabase,建议按以下路径学习:

第 1 周:熟练使用

• 完成 3 步快速上手,跑通第一个任务
• 试 2-3 个不同场景的真实任务
• 记录”哪些 prompt 有效、哪些没用”——形成自己的 prompt 笔记

第 2 周:理解机制

• 阅读 Skill 的官方文档(README、SKILL.md)
• 了解 Skill 的”触发关键词”和”输出格式”
• 学习”如何用更具体的描述触发 Skill”

第 3-4 周:组合使用

• 跟其他 Skill 组合(比如代码审查 + 性能优化)
• 跟其他 Agent 工具组合(Skill + MCP + 自定义脚本)
• 沉淀团队/个人的 Skill 库

长期:贡献社区

• 把自定义的 Skill 开源到 GitHub
• 提 PR 改进现有 Skill
• 写使用心得分享到 CSDN/掘金/知乎

推荐资源:

• 官方文档:https://github.com/supabase/mcp-server-supabase
• 官方仓库 README 里的 Examples
• 社区最佳实践:Anthropic 官方博客 https://www.anthropic.com/blog
• 国内社区:CSDN AI 板块、掘金 AI 板块

避免的坑:

• 不要装太多 Skill(超过 10 个会拖慢 Agent)
• 不要把 Skill 装在不兼容的 Agent 上
• 不要直接复制 Skill 默认 prompt——要根据项目调整
• 定期 review Skill 库的实用性,清理不用的

参考链接

• Skill(MCP Server)仓库:https://github.com/supabase/mcp-server-supabase
• Supabase 官方文档:https://supabase.com/docs
• Supabase JavaScript 客户端:https://supabase.com/docs/reference/javascript
• RLS 策略示例:https://supabase.com/docs/guides/auth/row-level-security
• Supabase CLI 工具:https://github.com/supabase/cli

我的个人推荐(测试编辑 Mnet)

最常用的 1 个核心用法:每天打开 Agent 第一时间加载这个 Skill,既不消耗太多 token 也能规范输出。

最容易踩的坑:别把 Skill 提示词当”开箱即用”的最终答案——它只是给你一个”标准框架”,具体项目还得你自己调整。

适合人群:做过 3+ 个实际项目的开发者,而不是”看一遍文档就完事”的小白。

3 个月使用心得:刚开始用时觉得”规范是约束”,用了 3 个月后才发现”规范是省时间”——避免每次重新决策同样的细节。

推荐配合的工具:Claude Code / Cursor / OpenCode 任选一个主流 Agent 即可,不要在工具选择上纠结太久。

长期价值:这类 Skill 的核心价值不是”立竿见影的输出”,而是”持续一致的质量”——长期用下来,你的项目质量会稳定在专业水平。

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。