
Добавить строку в приложение — небольшая правка в коде, за которой следует отдельный поход туда, где живут переводы. 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-бандла проекта. Для новой строки команда даёт агенту, который пишет код, инструкцию из четырёх шагов:
search_segments_by_keys— проверить, что ключа ещё нет.import_segmentsбезlanguage— создать ключи с исходным текстом.import_segmentsсlanguage, по одному вызову на язык, — записать переводы.recreate_latest_release, потому что бандл собирается из того, что утверждено на момент релиза.
Ключи разделяются точками (notifications.type.taskAssigned), а подстановки пишутся как {{name}}. Утверждение — только по решению человека. Неутверждённый перевод в бандл не попадает и ждёт проверки.
Предохранители для локализации с ИИ-агентами
Вход — персональный. Каждый грант исходит от человека, который вошёл, и токен никогда не может больше, чем этот человек. Выдать ассистенту translation:approve, не имея его самому, — значит не выдать ничего. Если у вас в пространстве отобрали право, инструмент пропадает со следующего же вызова, перевыпускать токен не нужно.
Доступ отзывается, как ключ API. Гранты перечислены на platform.ownlate.com в вашем профиле, в подключённых приложениях. После отзыва гранта его токены перестают работать со следующего вызова.
Изменения попадают в аудит. Каждый изменяющий вызов записывается в журнал аудита пространства как mcp.<tool> — вместе с клиентом и грантом, от которого он пришёл.
Утверждение остаётся за человеком. В релиз попадают только утверждённые переводы. Язык, который никто не дописал, уходит с готовыми ключами и без остальных. К тому же утверждение не просто меняет статус: пара «исходный текст → перевод» записывается в память переводов, а слова засчитываются в лимит тарифа. Предперевод потом сам применяет и утверждает точное совпадение из памяти, так что ошибочное утверждение не остаётся в одной строке. Если не хотите, чтобы ассистент утверждал, выдайте ему только translation:write и пусть работает через черновики.
Помните, что читает модель. Всё, что возвращает инструмент, читает модель подключённого клиента: исходные тексты, переводы, ключи, термины глоссария, комментарии и имена тех, кто их написал. Ключ OTA-раздачи проекта, учётные данные интеграций и всё, что касается оплаты, не возвращаются никогда. Если пространство работает по договору, который это запрещает, не подключайте ассистента.
Кроме того, грант может делать 120 вызовов в минуту. Сверх этого сервер отвечает 429 с Retry-After.
Что почитать дальше
- MCP-сервер: полный список инструментов, права для каждого из них, ресурсы и промпты
- Рабочий процесс: статусы, проверка и что делает утверждение
- Проверки качества и глоссарий
- Память переводов
- Релизы и OTA
- Начало работы
Тарифы и их лимиты — на странице с ценами.