POEditor

官方 POEditor MCP 服务

面向 POEditor 的官方 Model Context Protocol (MCP) 服务——这是一款翻译管理平台。将任何兼容 MCP 的 AI 助手直接连接到你的 POEditor 项目。

覆盖完整 POEditor v2 API 的 59 个工具。管理项目、术语、翻译、贡献者和语言。维护术语表。使用 Google、Microsoft 或 DeepL 自动翻译。与 Figma 双向传输文本。导出为客户端支持的任何格式。支持带 PKCE 的 OAuth 2.1。

---

端点

https://mcp.poeditor.com/mcp

由 POEditor 托管的官方远程 MCP 服务。无需安装。采用 Streamable HTTP 传输方式，符合 MCP 规范。

---

快速开始

1. 获取 API 令牌

在 poeditor.com/account/api 生成令牌。

2. 添加到客户端

Claude Code — 使用 OAuth 或 API 令牌：

claude mcp add poeditor --transport http https://mcp.poeditor.com/mcp

首次使用时，Claude Code 会打开浏览器以登录 POEditor，并自动保存令牌。若要改用 API 令牌：

claude mcp add poeditor --transport http https://mcp.poeditor.com/mcp \
  --header "Authorization: Bearer YOUR_POEDITOR_API_TOKEN"

Claude Desktop — 编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Cursor — 编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Windsurf — 编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "poeditor": {
      "serverUrl": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

VS Code (GitHub Copilot) — 添加到 .vscode/mcp.json：

{
  "servers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Zed — 添加到 ~/.config/zed/settings.json：

{
  "context_servers": {
    "poeditor": {
      "command": {
        "path": "npx",
        "args": [
          "-y", "mcp-remote",
          "https://mcp.poeditor.com/mcp",
          "--header", "Authorization: Bearer YOUR_POEDITOR_API_TOKEN"
        ]
      },
      "settings": {}
    }
  }
}

Gemini CLI — 添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Amazon Q Developer — 添加到 ~/.aws/amazonq/mcp.json：

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Cline、Continue、Augment 及其他客户端的配置，请参见 examples/。

3. 试用

向助手提问：

List all my POEditor projects

---

工具

实时工具列表由 MCP 端点通过 tools/list 提供。下方分类反映当前覆盖范围。

类别	工具
项目	列表、详情、添加、更新、删除、同步、上传、导出
语言	可用语言、列出项目语言、添加、更新、删除
术语	列表、添加、更新、删除、详情、评论
翻译	提交、提议、更新、删除、从 TM 填充、列出模糊匹配项、列出待校对项、列出未翻译项、标记为已校对
进度	翻译状态、校对进度、项目活动统计
质量	QA 检查、AI 质量评估（MQM 评分）、列出已存储的评估
贡献者	列表、添加、移除、贡献者活动统计
术语表	列表、详情、添加、更新、删除、分配给/取消分配给项目、列出/添加/更新/删除术语、设置/删除翻译、CSV 导入/导出
自动化	自动翻译（Google、Microsoft、DeepL）
Figma	将页面导出到 POEditor、将翻译作为 Figma 变量导入、移除本地化集合、移除过时术语
账户	账户信息

完整架构：请参见 docs/tools.md。

---

身份验证

• 令牌 — POEditor API 令牌，通过 Authorization: Bearer <token> 请求头传递
• OAuth 2.1 (PKCE) — 支持在 Claude Code、Claude.ai Connectors 和兼容客户端中一键连接

令牌范围：仅限用户自己的项目。不可跨租户访问。请参见身份验证。

---

导出格式

export_strings_file 会返回生成文件的下载 URL。可请求 POEditor 支持的任何格式——无论格式如何，大模型都可以直接读取、解析并处理内容。完整格式列表请参见 docs/tools.md。

---

示例

List all my POEditor projects
Show me untranslated terms in project 123456 for Spanish
Add the term "checkout_button" with English value "Check out" to project 123456
Export Spanish translations from project 123456 as JSON
Auto-translate untranslated French terms in project 123456 using DeepL
Show translation progress for all languages in project 123456
List all contributors for project 123456
Add "Dashboard" as a do-not-translate term to my product glossary
How many words did each contributor translate in project 123456 last month?
Export the "Checkout" page from this Figma file into project 123456

---

支持的客户端

任何支持 MCP 的客户端均可使用。支持：

• Claude Code · Claude Desktop · Claude.ai Connectors
• Cursor · Windsurf · Zed
• VS Code（GitHub Copilot · Cline · Continue · MCP extension）
• Gemini CLI · Amazon Q Developer · Augment
• mcp-inspector

---

功能

• 59 个工具——全面覆盖 POEditor v2 API，并提供超出原始 API 的工具
• 导出为 POEditor 支持的任何格式
• 在多个项目间共享术语表，并支持 CSV 导入／导出
• 通过 Google、Microsoft 或 DeepL 自动翻译
• 通过用户自己的 Figma MCP 连接实现 Figma 双向同步
• 支持 PKCE 的 OAuth 2.1
• Streamable HTTP 传输（符合 MCP 规范）
• 基础设施通过 ISO 27001 认证

---

链接

• POEditor：poeditor.com
• API 文档：poeditor.com/docs/api
• MCP 规范：modelcontextprotocol.io
• 支持：[email protected]

许可证

MIT——详见 LICENSE。