使用智能体快速开始
先选择 Busabase Cloud 或 Desktop，再按智能体选择正确的接入指南，并仅在需要时添加 MCP。
把这段提示词复制到你的智能体中，打开此工作区的引导技能（SETUP_SKILL.md）。它会优先复用已连接的 Busabase MCP 集成，否则先登录；连接后再安装常驻的 Busabase 技能。
这是 Codex、Claude Code、Cursor、Gemini CLI 或其他编码智能体 的统一入口。你只需要做三个决定：Busabase 运行在哪里、当前客户端应该使用哪种接入方式，以及是否需要可选的 MCP 连接。
哪些改动能直接生效，由你决定
智能体通过 ChangeRequest 写入，每次改动都带说明、差异和可回滚的历史。这次写入是立即生效还是等你审核，取决于它用的 Key 的权限级别——发一把 changeRequest 级的 Key，它写的东西就都要等你批准。无论哪种，除非你明确要求它对某个提案做出审核决定，否则它不得批准、合并或关闭该提案。
选择 Busabase Cloud 或 Desktop
当工作区需要被多台设备、团队成员、托管智能体或网页聊天产品访问时，选择 Busabase Cloud。Cloud 连接使用浏览器 OAuth，托管地址为 https://busabase.com。
打开目标工作区；如果希望提示词自动绑定当前空间，请使用 Dashboard → Agent Skills。
设置你的智能体
从横向标签中选择智能体，再通过面板右侧的下拉菜单选择 Busabase 版本。切换不同智能体时，当前版本选择会保持不变。
使用专门的 Codex 插件指南。插件会同时安装 Busabase skills 和托管 OAuth MCP 配置，是 Cloud 版本最方便的接入方式。
把这段提示词交给你的智能体
请阅读 https://busabase.com/zh-CN/docs/codex-plugin，完成 Busabase Plugin 在 Codex 中的安装与环境初始化。完成后请验证 Busabase 连接是否正常。可选：添加 MCP
当智能体或 IDE 需要直接调用 Busabase tools 时，MCP 很有用。如果已经安装 Cloud 版 Codex 或 Claude Code 插件，请跳过此步骤，因为插件已包含正确的 MCP server。
设置客户端
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase --scopes mcp
codex mcp list连接
完成浏览器 OAuth，然后打开 /mcp，确认工具已启用。
验证工作区
让 Agent 运行 auth_verify；如果返回多个空间，先询问要使用哪个空间，再用该 targetSpaceId 运行 bases_list。
从 Base 或 Skill Node 复制任务提示词
如果任务针对某张 Base 或某个 Skill Node，先打开该节点，再进入 Agent prompts。Skill Node 打开后默认就是这个标签页；在 Base 中，可从顶部的更多操作（···）→ Agent prompts 或侧栏节点的更多菜单进入。选一个内置或自定义场景，点 Copy，再粘贴给你正在使用的外部智能体。
这是公开 Demo 截图；图中的空间和节点 ID 只是示例。请在自己的空间打开目标节点后再复制。
复制出的内容会指出目标节点和空间，要求智能体检查连接；尚未连接时，还会附上设置指南。Skill Node 的 Use this skill 场景会让智能体读取该节点的 SKILL.md。对已有数据发起具体任务时，这比重新描述节点位置更直接；还没选定节点时，再从 Dashboard → Agent Skills 进行空间级接入。
把外部任务结果带回 Busabase
智能体连接好后，可以继续在其他工具中完成任务，再使用已安装的 Busabase Skill 把结果带回空间站供团队审核。Busabase 不会自动监视第三方工具；每次结果都需要由智能体或集成主动提交。
- 在目标空间打开 Agent Skills，复制包含当前空间信息的接入提示词，交给执行任务的编码智能体。完成引导后，让它核对连接的是哪个空间。Cloud 上的 Codex 插件和 Claude Code 插件会同时安装 Skill 和 MCP 连接；其他编码智能体可按接入提示词设置。纯网页聊天产品需要使用 MCP 连接，不能运行基于 shell 的 Skill 安装。
- 建一张「任务结果」Base，保存稳定的外部任务编号、来源系统、最近一次运行状态、尝试次数、完成时间、简短结果、证据链接和审核状态。完整日志与文件留在原系统，链接指向具体的那次运行，方便审核人打开。每次重试都要独立追溯时，再建一张关联的「运行尝试」Base，按运行编号保存每次结果。
- 需要人工核对时，给智能体
changeRequest级别的 Key 或 OAuth 权限。让它先按来源系统和任务编号查找记录，再提出新增或更新，避免重试生成重复任务；提交时带上有意义的修改说明和证据链接。团队在 Inbox → For review 检查、批准并合并后，结果才成为正式记录。待审提案不会实时更新正式进度；若要展示实时状态，需要另外明确授权一条状态写入路径。
可以把第一项任务这样交给已连接的智能体：
使用已安装的 Busabase Skill 核对目标空间。创建或查找「任务结果」Base。针对外部任务 SYNC-428，先按来源系统和任务编号查找已有记录，再提出新增或更新；写入最近结果、尝试次数、简短摘要和这次运行的证据链接。提交给人工审核，不要自行批准或合并。最后读回变更请求链接。能够运行工具的智能体可由 Skill 处理 Busabase 的操作流程。如果你在另一个产品中开发连接器，可通过 MCP + OAuth 或 REST API 提交同样可审核的修改；变更请求说明解释审核边界。
接下来阅读
自带智能体
了解标准提示词、常驻 skill 与日常变更请求工作流。
Codex 插件
为 Codex 安装 Busabase Cloud 专用插件。
Claude Code 插件
安装并验证 Claude Code 的 Busabase Cloud 专用插件。
MCP + OAuth
为支持的智能体和聊天客户端配置直接 MCP 访问。
其他接入方式：接入方式总览 · CLI · SDK · MCP · OpenAPI / REST · Agent Skills · Webhook