Agent 概览
一键连接 AI 工具
在 Beav 里点一下，把 Beav 接进 Codex、WorkBuddy、Claude Code、Claude 桌面版或 Cursor；Beav 更新后不用重新连接。
核对日期：2026-10-11。适用于带「一键连接」的新版 Beav（尚未发布）。已核对源码，并在 Linux 云端完成编译、单元测试和本机 MCP 地址的真实调用；在 Codex、WorkBuddy、Claude、Cursor 里的连接尚待逐一验收。
这是现在推荐的接入方式：不用让 AI 跑命令，也不用装插件。Beav 会把自己直接写进你那款 AI 工具的 MCP 配置。
怎么连
- 打开 Beav，点「接入 Agent」。素材库模式下在侧栏底部，其他时候在左下角账号菜单里。
- 选你的 AI 工具：Claude Code、Codex、WorkBuddy、Claude 桌面版或 Cursor。
- 点「连接到 …」。
- 回到那个工具新开一个对话就能用。Claude 桌面版需要完全退出再重新打开。
想确认连上了，可以在对话里说：「调用 creator_status，看看 Beav 连上没有」。
Beav 写了什么
| AI 工具 | 写入位置 | 连接方式 |
|---|---|---|
| Codex（含 ChatGPT 桌面版的 Codex） | ~/.codex/config.toml 的 [mcp_servers.beav] | 本机地址 http://127.0.0.1:31937/mcp |
| WorkBuddy | ~/.workbuddy/.mcp.json（已有 mcp.json 时写它） | 同上 |
| Claude Code | ~/.claude.json | 同上 |
| Cursor | ~/.cursor/mcp.json | 同上 |
| Claude 桌面版聊天 | Claude 的 claude_desktop_config.json | 启动 Beav 程序（它不支持填地址） |
- Beav 只改名为
beav的那一项，你的其他设置原样保留；第一次修改前会在同一目录留一份.beav-backup备份。 - 每个工具都有自己的授权，写在它的配置里，可在 Beav 里随时断开。不要把配置里的令牌发给任何 AI 或其他人。
- 配置文件里有注释（不是标准 JSON）时，Beav 不会动它，会提示你手动添加。
更新
AI 工具里只记了一个固定地址。Beav 更新后不用重新连接，工具和能力会自动跟上新版。Beav 启动时还会检查自己写过的配置，端口或程序位置变了就自动改过来；你自己删掉的不会再加回去。
用地址连接时 Beav 需要开着。打开后台运行后，关掉窗口也不会断开（见关闭窗口后继续后台运行）。Claude 桌面版会在需要时自己把 Beav 拉起来。
断开
在同一个弹窗点「断开」。Beav 会删掉该工具配置里的 beav 项，并撤销它的授权。Codex 和 WorkBuddy 与旧的插件安装共用同一份授权，断开后旧插件也会失效。
以前装过插件
以前通过插件方式或 beav extension prepare 装过的，可以继续用。如果同时装着插件和一键连接，工具里会出现两组 Beav 工具，留一组就行。只用一键连接时，Codex 侧栏里的素材库入口是否还会出现，尚待实测。