通过 MCP 将 VocaLingo 连接至 Claude、ChatGPT 和 Cursor

连接 VocaLingo 后，你的 AI 助手可以使用原说话者的声音翻译语音消息、总结 YouTube 视频、用你自己的声音朗读文本、为视频配音或添加字幕。智能体将消耗你常规的 VocaLingo 代币余额，且每项结果都会同步显示在应用的历史记录中：在电脑端开启配音，在手机端随时查看。

服务器详情

第 1 步：打开 AI 智能体屏幕

1. 在 iOS、Android 或 web.vocalingo.app 上打开 VocaLingo 并登录。

2. 前往设置 → AI 智能体 (MCP)。该界面标题为“将 VocaLingo 连接至你的 AI”。

3. 在“选择你的 AI”下方，点击你的助手：Claude、ChatGPT、Cursor、VS Code、Claude Code 或其他。屏幕上会显示对应的操作步骤。

连接 Claude

此方法适用于 claude.ai、Claude Desktop 和 Claude 移动端应用。

1. 在 AI 智能体屏幕上点击打开 Claude。“添加自定义连接器”窗口将打开，名称和地址已自动填好。

2. 点击添加，然后点击连接。

3. Claude 会打开 VocaLingo 登录页面。使用与应用相同的方式登录：邮箱验证码、Google，或使用应用内的验证码。

手动配置方法：在 Claude 中打开 Customize → Connectors → Add custom connector，粘贴 https://nodejs.vocalingo.app/mcp 并点击 Connect。完成后，VocaLingo 即可在你的所有设备上的 Claude 中使用。

连接 ChatGPT

1. 在 AI 智能体屏幕上复制服务器地址。

2. 在手机或电脑的浏览器中打开 chatgpt.com/plugins。

3. 点击 + → Add custom MCP server。

4. 输入名称 VocaLingo，粘贴地址，选择 OAuth 登录，勾选确认“I understand and want to continue”，然后点击 Create。

5. 在打开的页面中登录 VocaLingo。

自定义 MCP 服务器并非适用于所有 ChatGPT 订阅计划。

如何从 Claude 或 ChatGPT 登录

登录页面支持与应用相同的登录方式：邮箱验证码或 Google。如果你在应用中使用 Apple 登录或忘记了登录方式，请在 AI 智能体屏幕上点击获取登录验证码。在登录页面选择“使用 VocaLingo 应用的验证码登录”并输入 8 位验证码。验证码单次有效，有效期为 10 分钟。

连接 Cursor 或 VS Code

1. 在安装了 Cursor 或 VS Code 的电脑上打开 web.vocalingo.app 并登录。

2. 前往设置 → AI 智能体 (MCP)，选择 Cursor 或 VS Code。

3. 点击安装到 Cursor或安装到 VS Code。编辑器将打开并提示添加 VocaLingo 服务器，点击确认即可。

一键安装仅在电脑端可用。你也可以点击复制配置，并将其粘贴到 Cursor 的 ~/.cursor/mcp.json 中，或 VS Code 的 mcp.json 中（通过命令“MCP: Open User Configuration”）。配置文件中已包含你的令牌。

连接 Claude Code

1. 在 AI 智能体屏幕上选择 Claude Code，然后点击复制命令。

2. 在终端中运行该命令。格式如下：

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

重启 Claude Code。VocaLingo 将显示在 /mcp 列表中。

其他 MCP 客户端

Windsurf、Cline 以及任何支持远程 MCP 服务器的客户端都可以使用地址 https://nodejs.vocalingo.app/mcp 和请求头 Authorization: Bearer vlmcp_… 进行连接。在 AI 智能体屏幕上选择“其他”，即可复制你的令牌和预设配置。适用于 Claude Code、Cursor、Codex 和 Gemini CLI 的预设技能插件可在 GitHub 上的 vocalingo-mcp 仓库中找到。

VocaLingo MCP 工具

智能体会根据你的请求自动选择工具。付费工具将消耗应用内代币 VocaLingo 代币。

translate_video、caption_video 和 change_voice 需要文件输入。对于 YouTube 或 TikTok 链接，智能体会先调用 download_media 并传递下载的文件。付费工具的价格与应用内相同，详情请参阅各工具的代币价格。

智能体如何确认费用

• 费用达到或超过 50 代币的操作会先提示价格，仅在你同意后才会开始任务。智能体无法代你确认。

• 你可以提前询问价格：“为这个视频配音需要多少钱？”。智能体会获取预估费用，而不会启动任何任务。

• 10 分钟内重复相同的请求不会重复扣费：智能体会直接获取相同的任务结果。

• 如果余额不足，智能体会提示“余额不足”。请在应用中充值，详情请参阅如何购买代币。MCP 没有单独的计费系统。

如何向智能体发送音频、照片和视频

上传的文件会保留 48 小时，智能体可以直接复用而无需重新上传。文件大小限制：translate_audio 最高 150 MB，speech_to_text 和 save_voice 最高 50 MB，视频类工具和 change_voice 最高 100 MB，图片最高 20 MB。

如果你只需要读取或翻译照片上的文字，Claude 和 ChatGPT 本身即可免费处理。translate_image 适用于你需要重绘文字后的完整图片画面的情况。

耗时较长的任务

处理耗时较长的工具会等待约 25 秒，如果已完成则直接返回结果。否则，智能体会获得一个 jobId 并通过 check_job 查询进度。配音最长可能需要 30 分钟。如果你在任务执行期间关闭了聊天，可以让智能体调用不带 jobId 的 check_job：它会列出最近的任务。结果文件的链接有效期为 24 小时；结果本身会保留在应用历史记录中（未开通 Premium 时，每个工具保留最近 3 条记录）。

权限、令牌与停用方法

任何拥有你令牌的人都可以消耗你的代币余额，请务必妥善保管。在 AI 智能体屏幕的权限与令牌区域提供两项操作：

• 生成新令牌：旧令牌将在 1 分钟内失效。请在通过令牌连接的智能体中替换它。

• 停用 MCP 访问：所有智能体将在 1 分钟内失去访问权限，包括 Claude 和 ChatGPT 连接器。如需重新连接，点击启用 MCP 访问即可生成新令牌。

请仅克隆你自己的声音，或已获得明确授权使用的声音。此规则同样适用于应用内。

常见问题