Назад в блог

MCP-сервер для переводов: управляем строками из Claude Code

MCP-сервер для переводов: управляем строками из Claude Code

Добавить строку в приложение — небольшая правка в коде, за которой следует отдельный поход туда, где живут переводы. Ownlate держит облачный MCP-сервер для переводов по адресу https://mcp.ownlate.com/, так что этот поход может совершить ассистент, который уже работает в вашем репозитории. Подключите Claude Code, Cursor или любой другой MCP-клиент — и он получит инструменты для ключей, переводов, утверждений, поиска по памяти переводов, проверок качества и релизов в вашем рабочем пространстве Ownlate.

В этом руководстве — настройка, что доступно агенту, разбор одной новой строки от промпта до релиза и предохранители, благодаря которым локализация с ИИ-агентами остаётся проверяемой.

Настройка MCP-сервера для переводов в Claude Code

В Claude Code это одна команда:

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

Сервер говорит по streamable HTTP и авторизует через OAuth 2.1, включая динамическую регистрацию клиента, поэтому копировать ключ не нужно. Первый вызов возвращает 401 с адресом метаданных защищённого ресурса. Клиент идёт по нему, регистрируется и отправляет вас на экран согласия, где вы выбираете две вещи:

  • Какие пространства доступны токену. Никакого другого он не увидит, в скольких бы вы ни состояли.
  • Какие права он может применять — из тех же кодов прав, что и всё остальное в вашем пространстве.

На устройстве без браузера сервер вместо этого поддерживает device-поток: клиент показывает код, а вы подтверждаете его на platform.ownlate.com/device.

Другим клиентам нужен только адрес. В VS Code .vscode/mcp.json выглядит так:

{
  "servers": {
    "ownlate": {
      "type": "http",
      "url": "https://mcp.ownlate.com/"
    }
  }
}

Конфигурация для Claude Desktop есть в документации по MCP.

Что умеет агент

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

  • Осмотреться: list_workspaces, list_projects, get_project (с исходным и целевыми языками), list_languages, create_project и add_target_languages.
  • Чтение: list_segments с фильтром по языку и статусу, search_segments_by_keys, get_project_progress, get_translation_history и export_translations, который возвращает целую локаль в форме файла локализации.
  • Запись: create_segment, import_segments, update_segment_source_text, translate_segment, save_draft_translation и действия проверки mark_translation_reviewed, approve_translation и reject_translation.
  • Качество: search_translation_memory, list_glossary_entries, find_glossary_matches, check_segment_quality и инструменты для комментариев к сегментам.
  • Релизы: list_releases, create_release, recreate_latest_release и get_ota_distribution.

Два промпта собирают работу, которую обычно просят у ассистента. Оба принимают projectId и language. translate_missing проходит непереведённые ключи, сверяется с памятью переводов и глоссарием и пишет черновики. review_translations проверяет язык по глоссарию и правилам качества и сообщает, что не так, ничего не меняя.

Инструмент предлагается, только если у токена есть соответствующее право. Для translate_segment нужно translation:write, для approve_translation — translation:approve, а для create_release — project:create. Предохранители, о которых ниже, построены на этом соответствии.

Пошагово: одна новая строка от промпта до релиза

Допустим, вы делаете сценарий возврата и вам нужна подпись кнопки checkout.refund.cta в проекте, где целевые языки — немецкий и сербский. Короткая версия — один промпт:

› Добавь checkout.refund.cta "Request a refund",
  переведи на de и sr, утверди оба перевода
  и опубликуй релиз.

  create_segment       checkout.refund.cta
  translate_segment    de  Rückerstattung anfordern
  translate_segment    sr  Zatraži povraćaj
  approve_translation  de, sr
  create_release       15  published

Это работает, если у вас есть translation:approve и вы выдали его ассистенту. Для большинства команд лучше по умолчанию более медленный вариант. Вот он по шагам.

1. Проверьте ключ, затем создайте его

search_segments_by_keys ищет список ключей и отдельно сообщает о тех, у которых нет сегмента, поэтому агент ещё до записи знает, существует ли checkout.refund.cta. Затем create_segment добавляет ключ с исходным текстом. Для фичи с десятком строк import_segments без языка записывает все исходные тексты одним вызовом.

2. Посмотрите, что команда уже решила

search_translation_memory показывает, как похожие исходные тексты переводили раньше, — каждый с оценкой совпадения. find_glossary_matches перечисляет записи глоссария, которые встречаются в исходном тексте. Если в глоссарии уже решено, как переводится «refund», агент переиспользует эту формулировку, а не выдумывает синоним.

3. Запишите переводы

translate_segment сохраняет перевод одного сегмента на одном языке, так что это один вызов для de и один для sr. Если человек должен сначала всё прочитать, пусть агент вместо этого использует save_draft_translation: текст сохраняется черновиком, и в очередь проверки ничего не попадает непрочитанным. Когда ключей много, import_segments с языком записывает переводы этого языка одним вызовом.

4. Прогоните проверки качества

check_segment_quality возвращает правила QA, которые нарушает перевод: пропущенная или лишняя подстановка, HTML-теги, не совпадающие с источником, пробельный символ в конце, перевод, идентичный источнику, запрещённый термин глоссария или одно из ваших правил на регулярных выражениях. У подписи кнопки подстановок нет, а у {{count}} refunds pending они были бы. Проверки сообщают, а не запрещают, поэтому попросите агента показать вам результат, а не молча продолжать.

5. Утверждение: решает человек

Проверяющий читает немецкий и сербский переводы и утверждает их — в редакторе или попросив агента вызвать approve_translation после прочтения. До тех пор переводы не пригодны к выпуску.

6. Опубликуйте релиз

get_project_progress показывает долю переведённого и утверждённого по языкам. Затем create_release снимает утверждённые переводы в новый релиз, либо recreate_latest_release пересобирает последний релиз из того, что утверждено сейчас, сохраняя его версию. Приложения, которые загружают переводы по OTA, получают их из раздачи проекта; get_ota_distribution описывает её, не возвращая ключ доступа.

Тот же порядок для интерфейса самого Ownlate

Строки интерфейса Ownlate живут на платформе, а не в репозитории. Закоммичен только английский исходный файл, а все остальные языки приложения берут из OTA-бандла проекта. Для новой строки команда даёт агенту, который пишет код, инструкцию из четырёх шагов:

  1. search_segments_by_keys — проверить, что ключа ещё нет.
  2. import_segments без language — создать ключи с исходным текстом.
  3. import_segments с language, по одному вызову на язык, — записать переводы.
  4. recreate_latest_release, потому что бандл собирается из того, что утверждено на момент релиза.

Ключи разделяются точками (notifications.type.taskAssigned), а подстановки пишутся как {{name}}. Утверждение — только по решению человека. Неутверждённый перевод в бандл не попадает и ждёт проверки.

Предохранители для локализации с ИИ-агентами

Вход — персональный. Каждый грант исходит от человека, который вошёл, и токен никогда не может больше, чем этот человек. Выдать ассистенту translation:approve, не имея его самому, — значит не выдать ничего. Если у вас в пространстве отобрали право, инструмент пропадает со следующего же вызова, перевыпускать токен не нужно.

Доступ отзывается, как ключ API. Гранты перечислены на platform.ownlate.com в вашем профиле, в подключённых приложениях. После отзыва гранта его токены перестают работать со следующего вызова.

Изменения попадают в аудит. Каждый изменяющий вызов записывается в журнал аудита пространства как mcp.<tool> — вместе с клиентом и грантом, от которого он пришёл.

Утверждение остаётся за человеком. В релиз попадают только утверждённые переводы. Язык, который никто не дописал, уходит с готовыми ключами и без остальных. К тому же утверждение не просто меняет статус: пара «исходный текст → перевод» записывается в память переводов, а слова засчитываются в лимит тарифа. Предперевод потом сам применяет и утверждает точное совпадение из памяти, так что ошибочное утверждение не остаётся в одной строке. Если не хотите, чтобы ассистент утверждал, выдайте ему только translation:write и пусть работает через черновики.

Помните, что читает модель. Всё, что возвращает инструмент, читает модель подключённого клиента: исходные тексты, переводы, ключи, термины глоссария, комментарии и имена тех, кто их написал. Ключ OTA-раздачи проекта, учётные данные интеграций и всё, что касается оплаты, не возвращаются никогда. Если пространство работает по договору, который это запрещает, не подключайте ассистента.

Кроме того, грант может делать 120 вызовов в минуту. Сверх этого сервер отвечает 429 с Retry-After.

Что почитать дальше

Тарифы и их лимиты — на странице с ценами.