在无头环境添加 Beatra MCP

一条命令：用户在任意手机或电脑上点允许，智能体完成剩下的配置。

智能体运行在打不开浏览器的地方（SSH 服务器、容器、云主机、VPS 上的聊天机器人）时，用这一页。

如果宿主能在用户电脑上打开浏览器，不需要这一页：在宿主里添加 https://mcp.beatra.cn/mcp，按提示登录即可。

一条命令完成连接

需要 Python 3.8 或更新版本，只用标准库。

mkdir -p ~/.beatra/connector
curl -fsSL https://api.beatra.cn/oauth/connector/connect.py -o ~/.beatra/connector/beatra_connect.py
python3 ~/.beatra/connector/beatra_connect.py --host claude-code

第一次运行会输出 BEATRA_CONNECT_PENDING、一个链接和一串连接码，把两者都发给用户。用户在任意手机或电脑上打开链接、登录 Beatra，核对页面上的连接码与收到的一致，点允许。
再运行同一条命令。每次最多等待 90 秒，重复运行直到输出 BEATRA_CONNECT_READY。连接码 15 分钟内有效，过期后下一次运行会给出新的。
重新加载宿主的 MCP 服务器（见下表）。然后调用 beatra.tasks.list 确认连接，这一步不花积分。

命令不会输出令牌。不要打开、打印或复制它的令牌文件（*.token）、进行中的请求文件（*.pending.json）和它写过的宿主配置，也不要把令牌写进对话、命令行或项目文件。

选择 `--host`

宿主	`--host`	配置了什么	怎么加载
Claude Code	`claude-code`	用户级服务器 `beatra`，带请求头助手	`/mcp` 里重新连接，或重启 Claude Code
Codex	`codex`	`~/.codex/config.toml` 里的 `[mcp_servers.beatra]`	新开一个 Codex 会话
Cursor	`cursor`	`~/.cursor/mcp.json` 里的 `beatra`	重启 Cursor 或重新加载窗口
其他用 JSON `mcpServers` 配置的宿主	`json --config <路径>`（宿主的用户级配置，不能是项目里的文件）	`beatra`，带地址和 `Authorization` 请求头	按宿主的说明
Grok Build，以及能读令牌文件或运行请求头助手的宿主	`file`	私有令牌文件和请求头助手，命令会输出它们的路径	把宿主指向输出的路径，然后重启

加 --name "<你的应用名>" 可以指定核对页上显示的名称。

宿主登录

宿主支持标准 MCP OAuth 并且能打开浏览器时，使用宿主自带的登录流程。服务器无法打开浏览器时，使用上面的命令。远程浏览器转发请参考宿主当前版本的说明。每台机器单独授权，不要复制令牌文件。微信中无法返回宿主时，请用系统浏览器打开链接。

断开与重新连接

断开：控制台 → 设备 → 已连接的应用 → 断开（也可以直接打开 console.beatra.cn/apps）。宿主的下一次调用会被拒绝。
重新连接：再运行一次同样的命令，用户再点一次允许。
用这条命令建立的连接一直有效，直到被断开，或连续一年没有使用。

在无头环境添加 Beatra MCP

一条命令完成连接

选择 --host

宿主登录

断开与重新连接

本页内容

选择 `--host`