摘要
通过 API v2 使用 crowdin.com 和 Crowdin Enterprise 本地化:项目及各语言进度、文件、源字符串、翻译和审批、评论和问题、任务、报告、翻译构建和导出、翻译记忆库、术语表以及项目成员。
引导式设置
2 分钟将 Crowdin 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Crowdin,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Crowdin 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Crowdin、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Crowdin + Meta Muse
通过 API v2 使用 crowdin.com 和 Crowdin Enterprise 本地化:项目及各语言进度、文件、源字符串、翻译和审批、评论和问题、任务、报告、翻译构建和导出、翻译记忆库、术语表以及项目成员。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
CROWDIN_PERSONAL_ACCESS_TOKEN, CROWDIN_API_HOST
步骤 1 — 获取凭证
设置大约需要 2 分钟。你需要一个 crowdin.com 或 Crowdin Enterprise 账户。
- 创建个人访问令牌。在 crowdin.com 上:Account Settings > API > New Token。在 Crowdin Enterprise 中:在你的组织内打开 profile > Settings > API > New Token。
- 选择所需的权限范围:Projects、Source files and strings、Translations、Tasks、Reports、Translation memory、Glossaries。只选只读范围即可得到只读配置。复制令牌:它只显示一次。
- 把它粘贴到
CROWDIN_PERSONAL_ACCESS_TOKEN;它以Authorization: Bearer <token>的形式发送。 CROWDIN_API_HOST:crowdin.com 用api.crowdin.com,Enterprise 用<organization>.api.crowdin.com,其中组织名来自你的 Enterprise URLhttps://<organization>.crowdin.com。- 安装连接器并运行
crowdin_get_authenticated_user:它会显示令牌所属的用户,并确认令牌和主机正确。
Crowdin 自己的 MCP 服务器:Crowdin 也提供官方 MCP 服务器(https://mcp.crowdin.com/v2/mcp,Enterprise 为 https://<organization>.mcp.crowdin.com/v2/mcp,以个人访问令牌作为 Bearer)。这个连接器直接使用 API v2。
读取的内容:
- 项目,包括源语言和目标语言、类型(基于文件或基于字符串)以及工作流、QA 检查、机器翻译和翻译记忆库等设置;整个项目或单个文件的各语言进度;所有支持的语言及其 Crowdin ID。
- 分支、目录和源文件,以及指向文件源版本的短期链接(
crowdin_download_file)。 - 源字符串,包括键、文本、上下文、最大长度、标签和复数形式,可按文件、分支、目录、标签、任务、文本匹配或 CroQL 表达式筛选。
- 每次一种语言的翻译(建议)及其作者和评分,以及带审批人和时间的审批记录。
- 字符串上的评论和问题,例如未解决的上下文请求。
- 任务,包括类型、状态、语言、负责人、进度和截止时间;项目成员及其角色和语言。
- 翻译记忆库及其片段、用于查看某个短语以前如何翻译的语料检索(
crowdin_search_tm)、术语表及其术语。
写入的内容:
crowdin_add_string向文件添加源字符串(基于文件的项目)。crowdin_edit_string通过对/text、/identifier、/context、/isHidden、/maxLength或/labelIds的 JSON Patch 修改它;update_option决定文本变化时已有翻译如何处理。crowdin_add_translation添加一条建议;crowdin_approve_translation审批它,使其进入导出的文件(需要该语言的校对权限)。crowdin_add_comment对字符串发表评论或报告问题:提问、翻译或源文本错误、上下文请求。crowdin_create_task为某一种语言的文件(基于字符串的项目中为字符串)创建翻译或校对任务,带负责人和截止时间;在 Enterprise 中用workflow_step_id代替type。crowdin_edit_task通过 JSON Patch 修改任务,例如把/status改为done。crowdin_add_tm_segment把同一句话的多种语言版本添加到翻译记忆库;crowdin_add_glossary_term添加术语,也可以作为已有术语的翻译或加入某个概念。
报告和已翻译文件:报告在后台生成。crowdin_generate_report 返回 data.identifier;AI 反复查询 crowdin_get_report_status,直到 status 为 finished,再用 crowdin_download_report 获取链接。crowdin_export_project_translation 立即把一种语言导出为一个文件。crowdin_build_project_translations 把所有文件和语言构建为一个 zip:AI 查询 crowdin_get_build_status,然后调用 crowdin_download_build。下载链接很快就会过期(expireIn),所以 AI 会直接交给你,而不是保存下来。这些调用虽然是 POST,但不会修改内容。
安装时没有关闭任何工具:没有删除工具。
ID 和格式:项目、文件、字符串、翻译、任务和用户的 ID 都是数字;报告标识是字符串。语言使用 Crowdin ID,例如 de、fr、es-ES、pt-BR 或 zh-CN。时间为带偏移量的 ISO 8601。PATCH 类工具接受 JSON Patch 列表:[{"op": "replace", "path": "/status", "value": "done"}]。列表以 {"data": [{"data": {...}}, ...], "pagination": {"offset": 0, "limit": 25}} 返回,单个条目以 {"data": {...}} 返回。进度以 words 和 phrases 计数,translationProgress 和 approvalProgress 为百分比。
分页:使用 limit(默认 25,最多 500)和 offset。当一页包含 limit 条记录时,AI 用 offset + limit 请求下一页。
限制:在 crowdin.com 和 Enterprise 上,每个账户(合计其所有令牌)最多 20 个并发请求;429 表示需要等待。
常见错误:401 表示令牌错误或已过期,或主机错误。403 表示令牌缺少相应权限范围,或账户在项目中没有权限。404 表示 ID 不存在。400 和 422 是会指出字段的校验错误。
该连接器不会删除项目、文件、字符串或翻译,也不会上传源文件。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Muse 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
- 在聊天中,向 Muse 提出需要用到
Crowdin的工具的请求。
你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
crowdin_get_authenticated_user | The user the token belongs to: id, username, email, name and time zone |
crowdin_list_projects | Projects the token can reach, with id, name, identifier, source language, target language ids, type (file-based or string-based) and last… |
crowdin_get_project | One project with its settings: source language, target languages, workflow, QA checks, machine translation and translation memory settings |
crowdin_get_project_progress | Translation and approval progress per target language: words and phrases total, translated, approved, and the percentages |
crowdin_get_file_progress | Translation and approval progress of one file per target language |
crowdin_list_supported_languages | Every language Crowdin supports with its id (used everywhere else), name, locale, ISO codes and plural categories |
crowdin_list_branches | Branches of a project (file-based projects) with id, name, title and export pattern |
crowdin_list_directories | Directories of a project with id, name, path, branch and parent directory |
crowdin_list_files | Source files of a project with id, name, path, type, status, branch, directory and revision |
crowdin_get_file | One source file with its path, type, parser settings, export options, revision and timestamps |
crowdin_download_file | A short-lived download link (data.url, data.expireIn) for the source version of a file |
crowdin_list_strings | Source strings of a project with id, identifier (key), text, context, file, max length, labels, plural forms and hidden flag |
crowdin_get_string | One source string with identifier, text, context, plural forms, labels, max length and file |
crowdin_add_string | Add a source string to a file (file-based projects) with its text, key and context for translators |
crowdin_edit_string | Change a source string with JSON Patch operations on /text, /identifier, /context, /isHidden, /maxLength or /labelIds. update_option says… |
crowdin_list_translations | All translations (suggestions) of strings into one language, with text, author, rating, plural category and time |
crowdin_get_translation | One translation with its text, string, language, author, rating and provider |
crowdin_add_translation | Add a translation (suggestion) for a string in one language |
crowdin_list_approvals | Approvals of translations, filtered by string, file, language, label or translation, with the approver and time |
crowdin_approve_translation | Approve a translation, making it the one that goes into the exported files |
crowdin_list_comments | Comments and issues on strings: text, type (comment or issue), issue type and status, language, author and time |
crowdin_add_comment | Comment on a string, or report an issue (a question, a translation or source mistake, a request for context) |
crowdin_list_tasks | Tasks of a project with title, type (translate or proofread), status, language, assignees, progress, deadline and words count |
crowdin_get_task | One task with its files or strings, language, assignees, progress, deadline, cost estimate and status |
crowdin_create_task | Create a translate or proofread task for files (or, in string-based projects, strings) in one language, assigned to people, with a deadline |
crowdin_edit_task | Change a task with JSON Patch operations, e.g. its status (todo, in_progress, done, closed), title, description, deadline or assignees |
crowdin_generate_report | Start a project report: costs estimate, translation costs, top members, contribution raw data, translator accuracy, QA issues, translation… |
crowdin_get_report_status | Progress of a report being generated: status (created, inProgress, finished, failed) and progress percent |
crowdin_download_report | A short-lived download link (data.url) for a finished report |
crowdin_build_project_translations | Start a build of the translated files of a project (all or some languages, optionally a branch) as a zip |
crowdin_get_build_status | Status and progress of a translations build (created, inProgress, finished, failed, canceled) |
crowdin_download_build | A short-lived download link (data.url) for the zip of a finished build |
crowdin_export_project_translation | Export the translations of one language right away, as one file in a chosen format (e.g. xliff, json, android, macosx), for all or some… |
crowdin_list_tms | Translation memories with id, name, languages, segments count and the projects using them |
crowdin_get_tm | One translation memory with its languages, segments count and default project |
crowdin_list_tm_segments | Segments of a translation memory, each with its records (language id and text) |
crowdin_search_tm | Concordance search: find how phrases were translated before in the translation memories of a project |
crowdin_add_tm_segment | Add a segment to a translation memory: the same sentence in several languages |
crowdin_list_glossaries | Glossaries with id, name, languages, terms count and the projects using them |
crowdin_get_glossary | One glossary with its languages, terms count and default project |
crowdin_list_glossary_terms | Terms of a glossary with text, language, description, part of speech, status, type, note and concept id (terms of one concept are… |
crowdin_add_glossary_term | Add a term to a glossary, optionally as the translation of an existing term (translation_of_term_id) or into a concept |
crowdin_list_members | Members of a project with id, username, full name, role (manager, proofreader, translator, ...) and their languages |
crowdin_get_member | One project member with role, permissions per language and join date |
示例提示
- “我们应用项目的德语和日语翻译进展如何,已翻译和已审批分别多少?”
- “checkout 文件中哪些字符串有请求上下文的未解决问题?”
- “我们以前是怎么把“Sign in”翻译成法语的?在翻译记忆库里搜一下。”
- “为入门引导文件的西班牙语翻译创建一个校对任务,周五截止,分配给 Maria。”
- “为所有语言构建翻译文件,只包含已审批的翻译,并给我 zip 链接。”
FAQ
Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?