Pi 的 Busabase 接入

把 Pi 接上 Busabase

极简、可扩展的终端 agent harness,原生发现 Agent Skills 并具备 shell 工具。

粘贴到 Pi 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。

阅读 Pi 的 Skill 官方文档
Busabase
Agent Skill
Busabase 工作区里的一张文章数据表,包含记录、视图和 Agent 提示词

把这一句话交给你的 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-code

Pi 有 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 servers 官方文档

已知的坑

Pi 的远程 MCP 条目用 `url` 字段,对应的是 streamable HTTP;旧的 SSE 传输不再支持。项目级的 `.pi/mcp.json` 只有在你对该项目授予信任后才会被读取,没授权时加了也不会生效。这一行之前写的是「Pi 没有 MCP 客户端」——那是旧版本的情况,Pi 官方文档现在已经补上了。

接入能力对比

和目录里其他已收录 agent 的接入能力放在一起对比。

能力PiClaude CodeCursor
形态终端 Agent终端 AgentAI 编辑器
推荐路径Agent SkillAgent SkillAgent Skill
接入方式MCP + OAuth · MCP + API Key · 插件 / Skill · busabase-cli · REST APIMCP + OAuth · 插件 / SkillMCP + OAuth · 插件 / Skill
传输方式Streamable HTTPStreamable HTTPStreamable HTTP
认证方式OAuth(动态注册)OAuth(动态注册)OAuth(动态注册)
这份说明来自官方文档未记录核对日期

依据该 Agent 自己的官方文档整理,我们尚未在真机上逐步复跑。若命令有变动,请以下方链接的官方文档为准。

让你的 agent 自己完成接入

一句话、一次授权,此后它做的每一个改动都带说明和差异,随时可查、可回滚。

浏览全部 Agent

粘贴到 Pi 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。