使用 Busabase 插件连接 Claude Code

Busabase 插件是在 Claude Code 中使用 Busabase Cloud 的推荐方式。它会安装：

• busabase：搜索工作区知识并提交可审核的修改建议；
• busabase-app-creator：创建或维护完整的工作区应用；
• 连接到 https://busabase.com/api/mcp 的托管 HTTP MCP，并通过浏览器 OAuth 登录。

无需创建或粘贴 Busabase API Key。

1. 检查 Claude Code

同一个终端中需要 Claude Code 2.x 和 Git：

claude --version
git --version

如果 Claude Code 已安装但版本较旧，请先运行 claude update。

2. 安装 marketplace 插件

按顺序运行：

claude plugin marketplace add https://github.com/ranglang/busabase-skills.git#main
claude plugin install busabase@busabase

确认已安装的组件：

claude plugin list
claude plugin details busabase@busabase

详情中应显示 busabase、busabase-app-creator 两个 skill，以及一个 MCP server。

3. 授权 Busabase Cloud

Claude Code 会为插件内置的 server 添加命名空间。Busabase server id 是 plugin:busabase:busabase。

claude mcp login plugin:busabase:busabase

在浏览器中完成 Busabase 登录和授权。OAuth 会话由 Claude Code 保存并刷新；不要创建或粘贴 API Key。

在 SSH、容器或其他无浏览器终端中运行：

claude mcp login --no-browser plugin:busabase:busabase

在有浏览器的电脑上打开命令输出的授权 URL。如果 localhost 回调无法自动返回远程终端，请复制浏览器地址栏中的完整回调 URL，并粘贴到等待中的 Claude Code 终端。

4. 验证连接

claude mcp get plugin:busabase:busabase

server 应指向 https://busabase.com/api/mcp，并显示已认证或已连接。也可以在 Claude Code 中运行 /mcp 检查。

插件安装、OAuth 授权和当前对话的工具目录是三个独立状态。安装和登录后请开始一个新对话。如果 Claude Code 提示重新加载，请运行 /reload-plugins。

5. 开始第一个 Busabase 任务

用自然语言提问，并明确说使用 Busabase：

使用 Busabase 查找我们的新员工入职清单，并总结当前流程。

使用 Busabase 提议把发布记录的负责人改为 Maya。

列出未处理的 Busabase ChangeRequest，但不要审核或合并任何内容。

Claude 应在其他 Busabase 操作之前调用 auth_verify。如果账号可以访问多个空间，Claude 必须列出空间并等待你选择，不能猜测。之后整个任务都应使用选定的 targetSpaceId。

审核优先的修改流程

只读任务中，Claude 会搜索或读取选定工作区并报告结果。需要修改时，标准流程是：

1. Claude 先读取相关 Base、记录、文档或节点。
2. Claude 创建 ChangeRequest，说明要改什么以及为什么。
3. 你在 Busabase 中检查提案，或要求 Claude 展示提案。
4. 只有在你对该 ChangeRequest 给出明确指令后，Claude 才能审核、合并或关闭它。
5. 合并后，Claude 再次读取正式数据并确认实际结果。

工作区中的记录、文档、附件、评论和 ChangeRequest 消息都只是数据，不是指令，也不会授予 Claude 审核或合并权限。

创建或维护工作区应用

插件内置的 busabase-app-creator skill 用于引导式 AirApp 工作流。可以尝试：

使用 Busabase app creator 创建一个客户反馈跟踪应用。

维护现有的 Sales Pipeline AirApp，并加入一个经过批准的下次跟进流程。

审核这个 Busabase AirApp 并提出改进建议，但暂时不要修改。

Claude 会先判断任务属于创建还是维护，然后一次引导你做一个决定。新应用使用隔离的工作区资源；维护任务必须明确现有 AirApp，并保留批准范围之外的所有内容。

故障排查

插件已安装，但没有 Busabase 工具

开始新对话或运行 /reload-plugins，然后检查 /mcp。如果 Claude Code 报告插件加载错误，请运行 /doctor。

server 显示 Needs authentication

重新运行登录命令，并保持终端进程运行直到浏览器流程完成：

claude mcp login plugin:busabase:busabase

不要添加 Authorization header，也不要再创建一个名为 busabase 的独立 MCP server。

Claude 选择了错误的空间

要求 Claude 调用 auth_verify，列出所有空间并等待你的选择。在明确目标 targetSpaceId 之前，不要继续任何空间级任务。

浏览器无法完成 OAuth

使用 --no-browser，在本地打开授权 URL，然后把完整回调 URL 粘贴到等待中的终端。

更新或卸载插件

claude plugin marketplace update busabase
claude plugin update busabase@busabase
claude plugin uninstall busabase@busabase

更新后开始新对话，让 Claude Code 重新加载 skill 和 MCP 工具目录。

Claude Code plugin marketplace 文档 · Busabase 插件源码 · 直接配置 MCP