# 一键连接 AI 工具

> 在 Beav 里点一下，把 Beav 接进 Codex、WorkBuddy、Claude Code、Claude 桌面版或 Cursor；Beav 更新后不用重新连接。

- 原文: https://beav.pro/docs/agent/one-click

核对日期：2026-10-11。适用于带「一键连接」的新版 Beav（尚未发布）。已核对源码，并在 Linux 云端完成编译、单元测试和本机 MCP 地址的真实调用；在 Codex、WorkBuddy、Claude、Cursor 里的连接尚待逐一验收。

这是现在推荐的接入方式：不用让 AI 跑命令，也不用装插件。Beav 会把自己直接写进你那款 AI 工具的 MCP 配置。

## 怎么连

1. 打开 Beav，点「接入 Agent」。素材库模式下在侧栏底部，其他时候在左下角账号菜单里。
2. 选你的 AI 工具：Claude Code、Codex、WorkBuddy、Claude 桌面版或 Cursor。
3. 点「连接到 …」。
4. 回到那个工具新开一个对话就能用。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 需要开着。打开后台运行后，关掉窗口也不会断开（见[关闭窗口后继续后台运行](https://beav.pro/docs/getting-started/install#关闭窗口后继续后台运行)）。Claude 桌面版会在需要时自己把 Beav 拉起来。

## 断开

在同一个弹窗点「断开」。Beav 会删掉该工具配置里的 `beav` 项，并撤销它的授权。Codex 和 WorkBuddy 与旧的插件安装共用同一份授权，断开后旧插件也会失效。

## 以前装过插件

以前通过[插件方式](https://beav.pro/docs/agent/connect)或 `beav extension prepare` 装过的，可以继续用。如果同时装着插件和一键连接，工具里会出现两组 Beav 工具，留一组就行。只用一键连接时，Codex 侧栏里的素材库入口是否还会出现，尚待实测。