---
title: "安装 Supabase 插件"
summary: "安装 supabase@openai-curated 并连接 Supabase。当前插件清单未声明 mcpServers，远程 MCP 可按需单独配置。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Supabase", "supabase@openai-curated"]
canonical: /tips/supabase-codex-plugin/
---

# 安装 Supabase 插件

安装 supabase@openai-curated 并连接 Supabase。当前插件清单未声明 mcpServers，远程 MCP 可按需单独配置。

安装 supabase@openai-curated 并连接 Supabase。当前插件清单未声明 mcpServers，远程 MCP 可按需单独配置。

这是把托管 Postgres 项目、Auth、Edge Functions 和迁移接到 Codex，用来查库、改 schema、审 RLS。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/supabase/.codex-plugin/plugin.json) 的 name 是 `supabase`、version 是 `1.0.0`，所以精选 id 是 `supabase@openai-curated`。现行清单声明 [`.app.json`](https://github.com/openai/plugins/blob/main/plugins/supabase/.app.json) 和 `skills`，没有 `mcpServers` 字段。不要把 `.app.json` 里的 connector id 抄进手写配置。

CLI：

```bash
codex plugin add supabase@openai-curated
codex plugin list
```

TUI `/plugins` 或桌面 Plugins 搜 Supabase 再装，效果一样。装完按提示 Connect Supabase 账号。IDE 扩展没有 `/plugins`，用 CLI 这条。

README 写明插件带远程 MCP 和 [supabase/agent-skills](https://github.com/supabase/agent-skills) 里的技能（示例是 `postgres-best-practices`）。仓库里的 `git submodule update` 是插件作者克隆后拉共享技能用的，**不是** Codex 安装步骤。不要 `git clone` 再 `/plugins`，也不要把子模块命令抄进会话。

技能随插件走，目录和 SKILL.md 的 name 是 `supabase`、`supabase-postgres-best-practices`。不要 `npx skills add` 当 Codex 安装器，也不要手拷到 `~/.codex/skills`。

仓库另有 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/supabase/.mcp.json)，表名是 `supabase`，type 是 http，URL 是 `https://mcp.supabase.com/mcp`。因为现行 `plugin.json` **没有**挂 `mcpServers`，不要假设 `plugin add` 会自动叠这张 MCP 表。只要 MCP、不要 App 和技能时，才走已收录的 `mcp-supabase-remote`：`mcp add supabase --url https://mcp.supabase.com/mcp` 再 `mcp login supabase`。插件已经登记 MCP 时，不要再 `mcp add` 叠一张。查询参数 `read_only`、`project_ref`、`features` 仍写进那条 MCP `url`，不要写进 `plugin add`。

0.154 起先看**当前会话**的 `/plugins`；没有再新开。`codex plugin list` 里应看到 `supabase@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 Supabase。

使用注意事项：

- 操作影响：执行 SQL、改 schema、部署 Edge Functions 会动真实项目。


## 来源

- [openai/plugins · supabase plugin.json](https://github.com/openai/plugins/blob/main/plugins/supabase/.codex-plugin/plugin.json)
- [openai/plugins · supabase README](https://github.com/openai/plugins/blob/main/plugins/supabase/README.md)
- [openai/plugins · supabase .mcp.json](https://github.com/openai/plugins/blob/main/plugins/supabase/.mcp.json)