使用 Busabase 插件连接 Codex

Busabase 插件是通过 Codex 使用 Busabase Cloud 的最快方式。它会同时安装托管的 OAuth MCP 配置和两个可复用 skill：

• $busabase：查看工作区、提交 Change Request，以及使用已批准的数据。
• $busabase-app-creator：创建完整的 Busabase 工作区应用。

插件发布在公开的 busabase/skills 仓库中，不需要配置 Busabase API Key。

1. 添加 marketplace 和插件

在终端运行：

codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase

第一条命令把 GitHub 仓库注册为 busabase marketplace；第二条命令从这个 marketplace 安装 busabase 插件。

检查两种状态：

codex plugin marketplace list
codex plugin list

也可以启动 Codex 后输入 /plugins，检查已安装的插件和内置 skill。

2. 授权 Cloud MCP 连接

安装插件和授权 MCP 是两个独立状态。启动 Busabase OAuth：

codex mcp login busabase --scopes mcp
codex mcp list

在浏览器中使用拥有目标工作区的 Busabase 账号完成授权。请选择足够用的最小权限和有限有效期；普通智能体工作优先使用 changeRequest。

在 codex mcp list 中，busabase 行应显示 OAuth 认证。如果仍显示 Not logged in，请重新运行 login 命令，并在命令仍在等待时完成新打开的浏览器页面。

3. 新建 Codex 任务

完成安装和登录后新建一个任务，让 Codex 加载插件的 skill 与已认证工具目录。在新任务中：

1. 输入 /plugins，确认 Busabase 已安装并启用。
2. 输入 /mcp，确认 busabase 服务器已连接。
3. 要求 Codex 调用 auth_verify。
4. 如果返回多个空间，选择一个，并在后续调用中使用它的 targetSpaceId。
5. 要求 Codex 调用只读的 bases_list 做连通性检查。

Busabase 会拒绝有歧义的多空间调用，而不会自行猜测。

4. 使用内置 skill

可以直接描述目标，也可以显式调用 skill：

$busabase 列出所选工作区中的 Base，并概括每个 Base 的用途。

$busabase-app-creator 在 Busabase 中创建一个轻量内容日历应用。

插件遵循 Busabase 的审批优先工作流。它可以提交 Change Request，但不得在你没有明确要求时评审、合并或关闭 Change Request。

更新或重新连接

刷新 Git marketplace：

codex plugin marketplace upgrade busabase

更新后新建 Codex 任务，以加载最新的插件内容。

如需切换 Busabase 账号或替换已过期授权：

codex mcp logout busabase
codex mcp login busabase --scopes mcp
codex mcp list

如果组织策略禁止添加 Git marketplace，请让工作区管理员允许 https://github.com/busabase/skills，或改用直接 MCP 配置。

应该选择哪种方式？

Codex 插件官方文档 · Busabase skill 与插件源码