# 在无头环境添加 Beatra MCP
> 一条命令：用户在任意手机或电脑上点允许，智能体完成剩下的配置。

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

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

## 一条命令完成连接

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

```bash
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
```

1. 第一次运行会输出 `BEATRA_CONNECT_PENDING`、一个链接和一串连接码，把两者都发给用户。用户在任意手机或电脑上打开链接、登录 Beatra，核对页面上的连接码与收到的一致，点**允许**。
2. 再运行同一条命令。每次最多等待 90 秒，重复运行直到输出 `BEATRA_CONNECT_READY`。连接码 15 分钟内有效，过期后下一次运行会给出新的。
3. 重新加载宿主的 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）。宿主的下一次调用会被拒绝。
- 重新连接：再运行一次同样的命令，用户再点一次允许。
- 用这条命令建立的连接一直有效，直到被断开，或连续一年没有使用。