Beatra MCP

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

服务器地址

https://mcp.beatra.ai/mcp

三步接上

  1. 添加地址

    把服务器地址填进你的工具,或者用下面的一键按钮。

  2. 浏览器登录 Beatra

    工具会在浏览器里打开 Beatra 登录页。

  3. 核对后点「允许」

    页面会写明这次连接的应用。核对无误就点「允许」,再回到你的工具。

按工具看步骤

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

Claude Code

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

    claude mcp add --transport http --scope user beatra https://mcp.beatra.ai/mcp
  2. 打开 Claude Code,输入 /mcp。选中 beatra,按提示登录。

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

在 SSH 上(没有浏览器)

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

claude mcp login beatra --no-browser

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

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

Codex

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

    codex mcp add beatra --url https://mcp.beatra.ai/mcp
  2. 浏览器没有打开,或断开后要重新连接时,运行 codex mcp login beatra。

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

在 SSH 上(没有浏览器)

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

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

实测于 2026-11-16 · Codex 0.166.0

Cursor

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

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

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

或者手动添加

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

{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.ai/mcp"
    }
  }
}

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

VS Code

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

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

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

或者手动添加

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

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

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

Claude

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

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

    https://mcp.beatra.ai/mcp
  3. 点「连接」,登录 Beatra,核对应用名称后点「允许」。

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

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

实测于 2026-11-16 · Claude

其他 MCP 工具

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

    https://mcp.beatra.ai/mcp
  2. 工具打开浏览器后,登录 Beatra,点「允许」。

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

或者手动添加

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

{
  "mcpServers": {
    "beatra": {
      "url": "https://mcp.beatra.ai/mcp"
    }
  }
}

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

没有浏览器的服务器

把这句话发给智能体

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

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

    mkdir -p ~/.beatra/connector
    curl -fsSL https://api.beatra.ai/oauth/connector/connect.py -o ~/.beatra/connector/beatra_connect.py
    python3 ~/.beatra/connector/beatra_connect.py --host claude-code
  2. 第一次运行会给出一个链接和一串连接码。在任意手机或电脑上打开链接并登录。核对连接码一致后,点「允许」。

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

完整说明和其他工具

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

接上以后能做什么

  • 视频

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

  • 图片

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

  • 音乐

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

  • 配音

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

MCP 还是 Skill?

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

Skill

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

安装 Skill →

MCP

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

安全与掌控

  • 不用 API Key

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

  • 允许前看清去向

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

  • 随时断开

    你允许过的每个应用都列在控制台的「设备 → 已连接的应用」里。断开后,它的下一次调用会被拒绝。

常见问题

  • 收费吗?

    连接免费。生成视频、图片、音乐和配音会扣积分,与 Skill 共用一份。套餐和计费方式见定价页。

  • 需要 API Key 吗?

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

  • 支持哪些工具?

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

  • Grok Build 能用吗?

    暂时不能。Grok Build 目前不接受 Beatra 的工具名称。请先装 Skill。

  • 服务器没有浏览器怎么办?

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

  • 怎么断开?

    在控制台打开「设备 → 已连接的应用」,点「断开」。工具的下一次调用会被拒绝,想再用就重新连接一次。

  • 多久要重新登录?

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

现在就把 Beatra 接上

复制地址,加进你的工具,登录一次就好。

安装 Skill