Подключить Crowdin MCP к Meta Muse: переводы

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Crowdin, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Crowdin + Meta Muse

Локализация в Crowdin на crowdin.com и в Crowdin Enterprise через API v2: проекты и прогресс по языкам, файлы, исходные строки, переводы и утверждения, комментарии и замечания, задачи, отчёты, сборки и экспорт переводов, памяти переводов, глоссарии и участники проектов.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CROWDIN_PERSONAL_ACCESS_TOKEN, CROWDIN_API_HOST

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт на crowdin.com или в Crowdin Enterprise.

1. Создайте personal access token. На crowdin.com: Account Settings > API > New Token. В Crowdin Enterprise: profile > Settings > API > New Token внутри вашей организации.
2. Выберите нужные scopes: Projects, Source files and strings, Translations, Tasks, Reports, Translation memory, Glossaries. Scopes только для чтения дают настройку только для чтения. Скопируйте токен: он показывается один раз.
3. Вставьте его в CROWDIN_PERSONAL_ACCESS_TOKEN; он передаётся как Authorization: Bearer <token>.
4. CROWDIN_API_HOST: api.crowdin.com для crowdin.com или <organization>.api.crowdin.com для Enterprise, где организация берётся из вашего URL Enterprise https://<organization>.crowdin.com.
5. Установите коннектор и запустите crowdin_get_authenticated_user: он покажет пользователя, которому принадлежит токен, и подтвердит токен и хост.

Собственный MCP-сервер Crowdin: Crowdin также предоставляет официальный MCP-сервер (https://mcp.crowdin.com/v2/mcp, в Enterprise https://<organization>.mcp.crowdin.com/v2/mcp, с personal access token как Bearer). Этот коннектор работает с API v2 напрямую.

Что он читает:

• Проекты с исходным и целевыми языками, типом (на основе файлов или строк) и настройками вроде workflow, проверок QA, машинного перевода и памяти переводов; прогресс по языкам для проекта или одного файла; все поддерживаемые языки с их id в Crowdin.
• Ветки, каталоги и исходные файлы, а также короткоживущую ссылку на исходную версию файла (crowdin_download_file).
• Исходные строки с ключом, текстом, контекстом, максимальной длиной, метками и формами множественного числа, с фильтрами по файлу, ветке, каталогу, метке, задаче, совпадению текста или выражению CroQL.
• Переводы (предложения) на один язык за раз с автором и оценкой, а также утверждения с тем, кто утвердил, и временем.
• Комментарии и замечания к строкам, например нерешённые запросы контекста.
• Задачи с типом, статусом, языком, исполнителями, прогрессом и сроком; участников проекта с ролью и языками.
• Памяти переводов и их сегменты, поиск совпадений (crowdin_search_tm), чтобы узнать, как фразу переводили раньше, глоссарии и их термины.

Что он записывает:

• crowdin_add_string добавляет исходную строку в файл (проекты на основе файлов). crowdin_edit_string меняет её через JSON Patch по /text, /identifier, /context, /isHidden, /maxLength или /labelIds; update_option определяет, что будет с существующими переводами при изменении текста.
• crowdin_add_translation добавляет предложение; crowdin_approve_translation утверждает его, чтобы оно попало в экспортируемые файлы (нужны права корректора для этого языка).
• crowdin_add_comment комментирует строку или сообщает о замечании: вопрос, ошибка перевода или исходного текста, запрос контекста.
• crowdin_create_task создаёт задачу на перевод или вычитку файлов (или строк в проектах на основе строк) на одном языке с исполнителями и сроком; в Enterprise вместо type передаётся workflow_step_id. crowdin_edit_task меняет её через JSON Patch, например /status на done.
• crowdin_add_tm_segment добавляет в память переводов одно и то же предложение на нескольких языках; crowdin_add_glossary_term добавляет термин, при желании как перевод существующего термина или в концепт.

Отчёты и переведённые файлы: отчёты готовятся в фоне. crowdin_generate_report возвращает data.identifier; ИИ опрашивает crowdin_get_report_status, пока status не станет finished, и затем получает ссылку через crowdin_download_report. crowdin_export_project_translation сразу экспортирует один язык одним файлом. crowdin_build_project_translations собирает все файлы и языки в zip: ИИ опрашивает crowdin_get_build_status, затем вызывает crowdin_download_build. Ссылки на скачивание быстро истекают (expireIn), поэтому ИИ передаёт их вам, а не хранит. Эти вызовы это POST, но контент они не меняют.

При установке ничего не отключено: инструментов удаления нет.

Идентификаторы и форматы: id проектов, файлов, строк, переводов, задач и пользователей это числа; идентификаторы отчётов это строки. Языки задаются id Crowdin, например 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 элементов, ИИ запрашивает следующую с offset + limit.

Ограничения: 20 одновременных запросов на аккаунт с учётом всех его токенов, на crowdin.com и в Enterprise; 429 означает, что нужно подождать.

Частые ошибки: 401 означает неверный или истёкший токен либо неверный хост. 403 означает токен без нужного scope или аккаунт без прав в проекте. 404 означает неизвестный id. 400 и 422 это ошибки валидации с названием поля.

Коннектор не удаляет проекты, файлы, строки и переводы и не загружает исходные файлы.

Шаг 2 — Установите адаптер

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.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси 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 не подойдёт.

Доступные инструменты

Примеры запросов

• «Насколько продвинулись переводы нашего проекта приложения на немецкий и японский, переведено и утверждено?»
• «У каких строк в файле checkout есть открытые замечания с запросом контекста?»
• «Как мы раньше переводили «Sign in» на французский? Поищи в памяти переводов.»
• «Создай задачу на вычитку испанского перевода файла онбординга со сроком в пятницу и назначь её Марии.»
• «Собери переведённые файлы для всех языков только с утверждёнными переводами и дай ссылку на zip.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Microsoft Copilot