把 Pi 接上 Busabase
极简、可扩展的终端 agent harness,原生发现 Agent Skills 并具备 shell 工具。
粘贴到 Pi 里
请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。

把这一句话交给你的 agent
你拿到的比一个连接器多:busabase skill 里带着完整的变更请求工作流、CLI 和全部 API——以后每个会话都在,不用再粘一遍。
先问你
Busabase Cloud 还是本地桌面版——动手之前先由你决定。
完成连接
帮你登录并自己保管凭证,不用手工复制 API Key。
建好第一个 Base
创建并填充数据,工作区打开时不会是一片空白。
装上常驻 skill
busabase 与 busabase-app-creator 长期驻留,此后每次会话都能直接用。
这个 agent 的注意事项
Pi 从 ~/.agents/skills 和项目下的 .agents/skills 读取 Skill。它刻意不内置沙箱或权限系统,所以只在可信的仓库和账号下跑安装。
更想要连接器?
如果你不打算让 agent 自己装 skill,而是想把 Busabase 作为 MCP 工具接入,用下面这个服务器地址。
接入概览
- 厂商
- Earendil Works
- 接入方式
- MCP + OAuth · MCP + API Key · 插件 / Skill · busabase-cli · REST API
- 传输方式
- Streamable HTTP
- 认证方式
- OAuth(动态注册)
- 配置文件
- ~/.pi/agent/mcp.json (project: .pi/mcp.json, needs project trust)
npm exec -y --package busabase-cli@latest -- busabase-cli login --device-codePi 有 bash 权限,并会从 ~/.agents/skills 和项目下的 .agents/skills 读取 Agent Skills,所以走 Skill 路径即可:让 Pi 执行 Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me.
想用连接器?
Pi 现在的文档已经支持远程 MCP 服务器。在 ~/.pi/agent/mcp.json(用户级;项目下的 .pi/mcp.json 同名条目会覆盖它,但要先对该项目授予信任)里加入 Busabase:
{
"mcpServers": {
"busabase": {
"url": "https://busabase.com/api/mcp"
}
}
}
或者在终端执行:
pi mcp add busabase --url https://busabase.com/api/mcp
运行 pi mcp login busabase(或在会话里输入 /mcp → 选中 busabase → Sign in)完成 OAuth。Pi 会自动注册自己的 OAuth 客户端,不需要手动申请 client id 或 secret,并且会直接使用 Busabase 服务器声明的 scope,不用自己设置 oauth.scope。用 pi mcp logout busabase 登出。
之后可以让智能体调用 auth_verify 确认连接成功。
手动兜底或脚本化场景,busabase-cli 和 /api/v1 的 REST API 依然可用:
npm exec -y --package busabase-cli@latest -- busabase-cli login --device-code
npx busabase-cli bases list
已知的坑
Pi 的远程 MCP 条目用 `url` 字段,对应的是 streamable HTTP;旧的 SSE 传输不再支持。项目级的 `.pi/mcp.json` 只有在你对该项目授予信任后才会被读取,没授权时加了也不会生效。这一行之前写的是「Pi 没有 MCP 客户端」——那是旧版本的情况,Pi 官方文档现在已经补上了。
接入能力对比
和目录里其他已收录 agent 的接入能力放在一起对比。
| 能力 | |||
|---|---|---|---|
| 形态 | 终端 Agent | 终端 Agent | AI 编辑器 |
| 推荐路径 | Agent Skill | Agent Skill | Agent Skill |
| 接入方式 | MCP + OAuth · MCP + API Key · 插件 / Skill · busabase-cli · REST API | MCP + OAuth · 插件 / Skill | MCP + OAuth · 插件 / Skill |
| 传输方式 | Streamable HTTP | Streamable HTTP | Streamable HTTP |
| 认证方式 | OAuth(动态注册) | OAuth(动态注册) | OAuth(动态注册) |
粘贴到 Pi 里
请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。