用 MCP 让 Claude Code、Cursor 直接翻译 PDF：接入步骤与注意事项

Claude 能直接帮你翻译一整份 PDF 吗？

能，前提是接入翻译 MCP 服务。在 Claude Code、Cursor 等 MCP 客户端中填入 Belin Doc 的 MCP 配置和 API 密钥，再说一句「把这个 PDF 翻译成日文」，AI 就会上传文件、提交任务，等翻译完成后给出保留原文版式的译文下载链接。

把文档贴进对话框，翻译几段话没问题；换成一份带表格的 40 页合同，或一整个文件夹的说明书，就会遇到内容截断、版式丢失的问题，最后还得手动把回答逐段贴回 Word。MCP 将翻译交给专门的文档翻译服务，AI 助手负责理解你的需求，并调用工具完成各个步骤。

下面介绍四件事：MCP 服务做了什么、如何接入、AI 翻译文件时的调用流程，以及使用前需要了解的限制。

终端窗口通过插头连到一份译好的文档，表格和版式保持原样

翻译 MCP 服务到底做了什么

MCP（Model Context Protocol，模型上下文协议）是 AI 客户端调用外部工具的一套标准。Claude Code、Cursor 这类客户端连接 MCP 服务后，会读取它提供的工具清单，并根据你的请求决定调用哪些工具。

Belin Doc 的 MCP 服务将 belindoc.com 网页端的文档翻译和视频翻译能力封装为一组工具。文档相关的主要工具如下：

工具	作用
`upload_document`	返回预签名上传链接和可直接执行的上传命令
`translate_document`	按源语言、目标语言和模型提交翻译任务
`wait_for_translation`	等待任务完成，进度变化时返回
`get_document_translation_result`	返回译文下载链接
`get_model_list` / `get_supported_languages`	列出当前账户可用的模型和支持的语言
`get_account_status`	查询剩余额度和当前档位的各项限制

与直接让聊天机器人翻译相比，区别在于谁来处理文档。客户端里的大模型只负责调用工具，译文由网页端同一套翻译流程生成，因此表格、图片和公式的位置都保持原样。

远程接入还是本地 stdio：怎么选

两种接入方式使用相同的工具、账户和额度。

远程（Streamable HTTP）。 客户端直接连接 https://mcp.belindoc.com/api/mcp，通过 Authorization: Bearer 请求头传入 API 密钥，无需在本机安装软件。适合支持远程地址和自定义请求头的客户端，如 Claude Code、Cursor。

本地（stdio）。 客户端在你的电脑上通过 uvx belindoc-mcp 启动服务，密钥放在环境变量中。需要先安装 uv；不方便配置远程地址或请求头的客户端（包括 Claude Desktop）可以使用这种方式。

如果客户端支持远程接入，优先选远程：需要安装的东西少，也无需操心服务升级。

在 Claude Code、Cursor 里接入 MCP 翻译服务

下面这段 2 分钟的视频演示了完整的接入过程，文字步骤见视频下方。

Belin Doc MCP 接入教程：3 步让 AI 翻译整份 PDF

第一步：创建 API 密钥

第二步：把服务加进客户端

远程接入时，将以下内容加入客户端的 MCP 配置（Claude Code 是 .mcp.json，Cursor 是 .cursor/mcp.json），并在 Bearer 后填入密钥：

{
  "mcpServers": {
    "belindoc-mcp": {
      "type": "http",
      "url": "https://mcp.belindoc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <你的 API 密钥>"
      }
    }
  }
}

在 Claude Code 中本地接入，只需执行一条命令：

claude mcp add belindoc-mcp \
  -e BELINDOC_API_KEY=<你的 API 密钥> \
  -- uvx belindoc-mcp

Claude Desktop、Codex、Windsurf、VS Code 的配置方法见 MCP 服务页。各客户端的配置文件路径和顶层键名不同，也可能随版本变化；配置未生效时，先查阅客户端文档。

第三步：验证连接

先发起一个不消耗额度的查询，比如「我这个月还剩多少页额度？」AI 会调用 get_account_status；能返回额度信息，就说明密钥有效，服务已连接。

第四步：开口让它翻译

指定文件和目标语言，例如：「把 contracts/nda.pdf 翻译成德文。」如果没有指定模型，AI 会先询问你要用哪个，再上传文件、提交任务，等待完成后给出译文下载链接。

一句「翻译这个 PDF」背后发生了什么

了解实际调用流程，也更容易判断问题出在哪一步。

上传。 upload_document 返回一个短时有效的签名链接和一条可直接执行的上传命令，AI 在你的电脑上执行命令，上传文件。服务端不会主动读取你电脑上的文件。
判断扫描件。 提交 PDF 翻译任务前，服务端会判断文件是否为扫描件。扫描件需要 OCR，OCR 页数照常计入翻译页数额度，免费账户另有每月 OCR 页数上限；每个文件采用的处理方式都会告知 AI。
提交。 translate_document 按你选择的语言和模型开始翻译。还可以传入 Belin Doc 术语库中的术语表 ID，让人名和专业词使用你指定的译法。
等待。 wait_for_translation 在进度变化时返回，AI 可以随时告知长文档的翻译进度。
下载。 get_document_translation_result 返回签名下载链接。? 后面的字符串就是签名，必须保留完整链接，截掉签名后将无法打开。

第 1 步需要执行上传命令，因此支持终端命令的客户端用起来更顺手，例如 Claude Code、Codex、Cursor 的 Agent 模式。没有终端权限的客户端也能查询额度、查看任务列表和获取结果，但上传本地文件仍需要在某处执行这条命令。

适合用 MCP 做什么，用之前查什么

当翻译只是整个流程中的一步时，MCP 尤其适用：翻译一个文件夹里的所有 PDF、翻译规格书后总结它与上一版的差异，或查询一批此前提交的任务。你只需描述想要的结果，AI 会依次调用所需工具。

处理重要文档前，需要留意以下几点：

明确指定模型。 可用模型因账户而异。翻译合同、技术手册等文档时，直接告诉 AI 使用哪个模型；选择方法可参考按文档类型选模型指南。
留意扫描件的 OCR 提示。 扫描版 PDF 不经过 OCR，译文会是空白；使用 OCR 时页数照常计入翻译额度，免费账户另有每月 OCR 页数上限。AI 会报告每个文件的处理方式，记得查看。
打开译文文件检查。 AI 在聊天中的回复只说明任务已完成。和使用任何机器翻译一样，应打开译文，抽查人名、数字和表格。

❓ 常见问题（FAQ）

MCP 服务能翻译哪些格式的文件？

支持 PDF、DOCX、PPTX、XLSX、TXT、EPUB，以及 PNG、JPG 图片。图片每张按 1 页计算，均通过 OCR 处理。

通过 MCP 翻译和网页端分开计费吗？

不分开。MCP 是同一账户的另一个入口，消耗相同的页数和视频额度，模型系数也与网页端一致，没有单独的 MCP 定价。

Claude Desktop 能用吗？

可以通过本地 stdio 方式接入。不过，上传本地文件需要 AI 执行上传命令。要翻译硬盘上的文件，使用 Claude Code 这类支持终端命令的客户端更稳妥。

API 密钥泄露了怎么办？

立即在开发者中心停用或删除该密钥，再创建新密钥。也可以设置 IP 白名单，只允许自己的机器调用。

能通过 MCP 翻译视频吗？

能。同一服务还提供视频翻译和字幕改写工具。这类任务会消耗额度，因此分两步确认：AI 先展示各个组合所需的额度，等你选定后再提交任务。

不想经过 AI 客户端，想在自己代码里调用怎么办？

直接调用翻译 API 即可。API 文档提供了 REST 接口说明，使用的是同一套 API 密钥。