---
title: "在 Claude Code、Codex、Cursor、VS Code 里接入 Beatra MCP"
summary: "在 MCP 工具里添加 https://mcp.beatra.cn/mcp，浏览器登录 Beatra，就能在对话里生成视频、图片、音乐和配音，不用 API Key。"
url: "https://www.beatra.cn/zh/mcp"
language: "zh"
last_verified: "2026-11-16"
---

# 把 Beatra 接进你的 MCP 工具

在支持 MCP 的工具里添加 https://mcp.beatra.cn/mcp，浏览器登录后点「允许」。之后就能在对话里生成视频、图片、音乐和配音。全程不用 API Key。

服务器地址

```text
https://mcp.beatra.cn/mcp
```

[你的智能体能装 Skill？装 Skill 更省事](https://www.beatra.cn/zh/install)

## 三步接上

1. **添加地址**: 把服务器地址填进你的工具，或者用下面的一键按钮。
2. **浏览器登录 Beatra**: 工具会在浏览器里打开 Beatra 登录页。
3. **核对后点「允许」**: 页面会写明这次连接的应用。核对无误就点「允许」，再回到你的工具。

## 按工具看步骤

选你的工具。单独列出的工具，都实际接通并测试过。

### Claude Code

1. 在终端运行下面的命令，添加 Beatra。

```sh
claude mcp add --transport http --scope user beatra https://mcp.beatra.cn/mcp
```

2. 打开 Claude Code，输入 `/mcp`。选中 beatra，按提示登录。

3. 在浏览器里登录 Beatra。应用名称会显示为「未命名应用」。核对「授权将发往」是「这台电脑上的应用」，再点「允许」。

**在 SSH 上（没有浏览器）**

第 2 步改用下面的命令。在任意设备上打开它给出的链接，登录并点「允许」。页面打不开也没关系，复制浏览器最后停留的地址，粘贴回终端。

```sh
claude mcp login beatra --no-browser
```

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

实测于 2026-11-16 · Claude Code 2.1.326

### Codex

1. 在终端运行下面的命令。Codex 添加 Beatra 后会打开浏览器登录。

```sh
codex mcp add beatra --url https://mcp.beatra.cn/mcp
```

2. 浏览器没有打开，或断开后要重新连接时，运行 `codex mcp login beatra`。

3. 登录 Beatra，核对应用名称后点「允许」。

**在 SSH 上（没有浏览器）**

跳过上面的步骤，按「没有浏览器的服务器」操作，`--host` 填 `codex`。它给出的链接在任意设备上打开都行。

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

实测于 2026-11-16 · Codex 0.166.0

### Cursor

1. 点「添加到 Cursor」，在 Cursor 里确认安装。

[添加到 Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=beatra&config=eyJ1cmwiOiJodHRwczovL21jcC5iZWF0cmEuY24vbWNwIn0=)

2. 打开 Cursor 的 MCP 设置。点 beatra 旁边的登录提示。

3. 登录 Beatra，核对应用名称后点「允许」。

**或者手动添加**

或者把下面的配置加进 Cursor 的 MCP 设置（`~/.cursor/mcp.json`）。

```json
{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.cn/mcp"
    }
  }
}
```

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

### VS Code

1. 点「在 VS Code 中安装」，然后确认安装。

[在 VS Code 中安装](vscode:mcp/install?%7B%22name%22%3A%22beatra%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.beatra.cn%2Fmcp%22%7D)

2. VS Code 会请求登录 Beatra，再问能否打开网页。两次都同意。没有弹出时，先登录 Copilot，再在聊天里发一条消息。

3. 登录 Beatra，核对应用名称后点「允许」。VS Code 的聊天要先登录 Copilot。之后就能在聊天里用 Beatra。

**或者手动添加**

或者在 macOS 或 Linux 的终端运行下面的命令。

```sh
code --add-mcp '{"name":"beatra","type":"http","url":"https://mcp.beatra.cn/mcp"}'
```

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

### Claude

1. 在 Claude 里打开「自定义 → 连接器」。点「添加」，选「添加自定义连接器」。

2. 名称填 Beatra，粘贴下面的服务器地址。再按提示点「添加」。

```text
https://mcp.beatra.cn/mcp
```

3. 点「连接」，登录 Beatra，核对应用名称后点「允许」。

4. 哪些套餐能添加自定义连接器，以 Claude 的说明为准。

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

实测于 2026-11-16 · Claude

### 其他 MCP 工具

1. 在工具里添加远程 MCP 服务器，粘贴服务器地址。要选类型时，选 streamable HTTP。

```text
https://mcp.beatra.cn/mcp
```

2. 工具打开浏览器后，登录 Beatra，点「允许」。

3. 工具没法在浏览器里登录时，看「没有浏览器的服务器」。也可以装 Skill。

**或者手动添加**

很多工具用这种配置格式。

```json
{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.cn/mcp"
    }
  }
}
```

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

### 没有浏览器的服务器

把这句话发给智能体

```text
请按 https://docs.beatra.cn/zh/docs/agent-connect 给本机智能体接入 Beatra MCP。需要我批准时，把链接和连接码发给我。
```

1. 也可以自己运行下面的命令。把最后一行的 `--host` 换成你的工具：`claude-code`、`codex` 或 `cursor`。

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

2. 第一次运行会给出一个链接和一串连接码。在任意手机或电脑上打开链接并登录。核对连接码一致后，点「允许」。

3. 再运行同一条命令，直到提示连接完成。然后重新加载工具的 MCP 服务器。

[完整说明和其他工具](https://docs.beatra.cn/zh/docs/agent-connect)

想确认接好了，就让它列出最近的 Beatra 任务。只列这次连接里做的任务，刚接上时是空列表，不花积分。

## 接上以后能做什么

### 视频

> 「做一段 8 秒的海边日落延时视频，竖屏」

### 图片

> 「做一张春季新品海报，留出标题的位置」

### 音乐

> 「写一段 30 秒的轻快片头曲，不要人声」

### 配音

> 「用温和沉稳的声音把这段文案读出来」

## MCP 还是 Skill？

两者共用同一个账号、同一份积分、同样的能力。

### Skill

除了工具，Skill 还会教智能体怎么用好它们。比如花积分前先确认价格、重试不重复扣费、上传本地文件。你的工具能装 Skill，就装 Skill。

[安装 Skill](https://www.beatra.cn/zh/install)

### MCP

只接入工具本身，怎么用由你的工具决定。适合只能添加 MCP 地址的工具，或你自己搭的智能体。

## 安全与掌控

### 不用 API Key

在浏览器里登录，没有要复制的密钥，也不用往聊天里贴任何东西。

### 允许前看清去向

点「允许」之前，页面会写明是哪个应用在请求、授权发往哪里。

### 随时断开

你允许过的每个应用都列在控制台的[「设备 → 已连接的应用」](https://console.beatra.cn/apps)里。断开后，它的下一次调用会被拒绝。

## 常见问题

### 收费吗？

连接免费。生成视频、图片、音乐和配音会扣积分，与 Skill 共用一份。套餐和计费方式见[定价页](https://www.beatra.cn/zh/pricing)。

### 需要 API Key 吗？

不需要。工具会在浏览器里打开 Beatra，你登录后点「允许」就行。工具没法在浏览器里登录时，看「没有浏览器的服务器」。

### 支持哪些工具？

页面上单独列出的工具，都实际接通并测试过。其他支持远程 MCP 服务器和浏览器登录的工具，一般也能接上。

### Grok Build 能用吗？

暂时不能。Grok Build 目前不接受 Beatra 的工具名称。请先[装 Skill](https://www.beatra.cn/zh/install)。

### 服务器没有浏览器怎么办？

用「没有浏览器的服务器」里的命令。它会给出一个链接和连接码。你在任意手机或电脑上打开链接，核对连接码后点「允许」。

### 怎么断开？

在控制台打开[「设备 → 已连接的应用」](https://console.beatra.cn/apps)，点「断开」。工具的下一次调用会被拒绝，想再用就重新连接一次。

### 多久要重新登录？

不用定期登录。工具会在后台自动续期，大约一年没用才需要重新登录。
