关于 busabase
Busabase Skills & Plugins 为 Busabase 提供两种 Agent Skill;Busabase 是面向 AI Agent 的开源数据库与工作区。它支持工作区数据操作和应用创建;没有写入权限时,写入会作为可审核的变更请求提交。
主要功能
- 01列出 Base 和记录
- 02提出并合并变更请求
- 03创建工作区应用
- 04通过 Skill 或插件安装
适用场景
- 01审核工作区数据变更提案
- 02根据产品构想创建 Busabase 应用
MCP 相关
插件声明了位于 https://busabase.com/api/mcp 的托管 Streamable HTTP MCP 服务,并说明本地端点。Claude Code 和 Codex 通过浏览器 OAuth 连接托管服务;Codex 提供经过筛选的工具目录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://busabase.com/api/mcpclaude mcp add --transport http com-busabase-busabase https://busabase.com/api/mcp{"mcpServers":{"com-busabase-busabase":{"type":"http","url":"https://busabase.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-busabase-busabase":{"type":"http","url":"https://busabase.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-busabase-busabase":{"type":"http","url":"https://busabase.com/api/mcp"}}}{"mcpServers":{"com-busabase-busabase":{"serverUrl":"https://busabase.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Busabase 技能与插件
适用于 Busabase 的 Agent Skills + 插件——这是面向 AI Agent 的开源数据库和工作空间。每次写入都会成为一项变更请求,附带消息和差异:拥有写入权限时会立即生效,否则会等待人工审核。
两项技能,五种安装方式——选择 Agent 支持的方式即可。
安装
skills(Claude Code、Cursor、Codex 等——持续更新)
npx skills add busabase/skills
Agent Plugins v1(可移植包)
仓库根目录遵循 Agent Plugins Specification v1.0.0:
plugin.json 是可移植清单,skills/ 包含 Agent Skills,mcp.json
声明托管的 Streamable HTTP MCP 服务。任何支持 Agent Plugins 格式的客户端都可以安装或加载此仓库根目录。
Agent Plugins v1 将 OAuth 和凭据交由客户端处理。现有的 Claude Code 和 Codex
包保留了各自专用的浏览器 OAuth 行为。有关兼容性映射和验证,请参阅
docs/agent-plugins.md。
Claude Code 插件
claude plugin marketplace add https://github.com/busabase/skills.git
claude plugin install busabase@busabase
claude mcp login plugin:busabase:busabase
Claude Code 插件通过浏览器 OAuth 连接到 https://busabase.com/api/mcp。Claude
将其捆绑的服务命名空间设为 plugin:busabase:busabase。安装并登录后,请开始新的对话,以加载经过身份验证的工具目录。完整的验证和恢复流程请参阅
docs/claude-code-install.md。
维护者还应阅读
docs/codex-to-claude-code-port.md,了解各主机在清单、MCP、OAuth、技能和验证方面的差异。
Codex 插件
codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase
codex mcp login busabase
Codex 插件连接到 https://busabase.com/api/mcp,打开标准的浏览器 OAuth 流程,并提供一个精简的 22 工具目录。无需设置 API 密钥。
插件安装和 MCP 授权是两个独立的状态。浏览器显示
Authentication complete 后,请先验证已保存的连接,再开始 Busabase 任务:
codex mcp list
busabase 行的 Auth 应显示为 OAuth。如果仍显示 Not logged in,请再次运行
codex mcp login busabase,并在该命令仍在运行时完成新打开的浏览器标签页。登录成功后,请开始新的 Codex 任务,以便加载经过身份验证的工具目录。
MCP(任何支持 MCP 的 Agent)
将 Agent 指向工作空间的 Streamable-HTTP 端点:
- 桌面 / 本地:
http://localhost:15419/api/mcp(无需身份验证) - 云端:
https://busabase.com/api/mcp(发送Authorization: Bearer $BUSABASE_API_KEY)
Codex 可以通过标准 OAuth 直接使用完整的云端 MCP 功能:
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase
根目录中的可移植文件 mcp.json 使用 Agent Plugins v1 格式声明托管端点。旧版根目录文件
.mcp.json 仍会为通用 MCP 客户端配置本地端点。Claude
包使用其自己的托管 OAuth MCP 配置。Codex 插件则有单独的远程 MCP 配置。
根目录的 busabase 技能仍是面向本地和通用 Agent 安装的完整 CLI/curl 指南。Claude 和 Codex 捆绑的技能则刻意采用 MCP 优先的方式:它们依赖 OAuth 和精选工具目录,而不是读取 ~/.busabase/.env。
若要从头开始设置工作空间,请先粘贴 Busabase 控制面板中的入门提示词(Agent Skills 按钮)——它会引导 Agent 完成连接、创建第一个 Base,然后运行上述某条安装命令。
技能
| 技能 | 功能 |
|---|---|
busabase | 通过 HTTP 操作 Busabase 工作区:列出 Bases/记录、提出 ChangeRequests,并合并已批准的请求。 |
busabase-app-creator | 将产品创意转化为完整的 Busabase 工作区应用,包含原生资源、受限的数据访问,以及可供审核的 AirApp。 |
想找可安装的模板? 完整应用——表格、AirApp 以及 Agent 阅读的手册——位于 busabase/templates。 它们单独存放,这样安装这两个技能就不会一并下载所有模板的源文件和截图。
仓库布局
这个仓库支持上述所有安装方式:
plugin.json Agent Plugins v1 portable manifest
mcp.json Agent Plugins v1 hosted MCP profile
skills/busabase/SKILL.md canonical local/general-purpose skill
skills/busabase-app-creator/SKILL.md guided Busabase workspace and AirApp creator
.claude-plugin/marketplace.json Claude Code marketplace listing
claude/.claude-plugin/plugin.json Claude Code plugin manifest
claude/.mcp.json hosted OAuth MCP profile for Claude Code
claude/skills/busabase/SKILL.md Claude-specific MCP-first connection guidance
claude/skills/busabase-app-creator/ symlink to the shared app creator skill
.agents/plugins/marketplace.json Codex marketplace listing
plugins/busabase/.codex-plugin/plugin.json Codex plugin manifest
plugins/busabase/.mcp.json hosted OAuth MCP profile for Codex
plugins/busabase/skills/busabase/SKILL.md Codex needs the skill INSIDE the plugin dir
(MCP-first guidance for the curated profile)
plugins/busabase/skills/busabase-app-creator/SKILL.md
app creator bundled beside its Busabase dependency
plugins/busabase/assets/ icons and light/dark logos bundled with Codex
.mcp.json legacy/general-client local MCP profile
server.json official MCP Registry entry (remote → busabase.com/api/mcp)
scripts/validate-agent-plugin.mjs portable and client-package conformance guard
为什么要提供针对特定宿主的 Busabase 技能? 插件包使用托管 OAuth 和 MCP 工具,而不是本地 shell 配置。此外,Claude Code 将服务命名空间设为
plugin:busabase:busabase,而 Codex 使用busabase。共享的busabase-app-creator技能 将连接、API 和 ChangeRequest 行为委托给针对特定宿主、以 MCP 为优先的依赖项。
发布到 OpenAI Plugin Directory
OpenAI Plugin Directory 和 MCP Registry 是两个独立的发布渠道。有关 Platform 提交、
域名验证、审核人员访问权限、测试提示词和生产环境冒烟测试,请参阅
docs/openai-plugin-submission.md。
发布到官方 MCP Registry
brew install mcp-publisher # or grab the binary from the registry releases
mcp-publisher login dns --domain busabase.com --private-key <KEY> # verifies the com.busabase/* namespace
mcp-publisher publish # publishes server.json — live immediately, no review
仅在发布 MCP Registry 更新时,才更新 server.json 中的 version。对于 GitHub marketplace 发布,应单独更新 Codex 插件清单。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。