i1n
Документация Интеграция агента

Интеграция агента

Настройте агентов ИИ-кодирования (Cursor, Claude Code, Windsurf, GitHub Copilot, Codex) для автоматической обработки локализации, включая нативную интеграцию MCP.

Обзор

i1n — это первый инструмент локализации, созданный для эпохи агентов. Он интегрируется с ИИ-агентами для написания кода на двух уровнях: правила контекста, которые обучают агентов соглашениям вашего проекта по интернационализации (i18n), и нативный сервер MCP, который позволяет агентам напрямую выполнять команды i1n.

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

Правила контекста (настройка ИИ)

i1n генерирует контекстные правила для Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) и Antigravity (.antigravity/rules.md).

Каждый файл правил адаптирован к конкретному формату и возможностям агента. Запустите i1n setup-ai, чтобы сгенерировать все файлы одновременно.

MCP Сервер

i1n включает нативный сервер Model Context Protocol (MCP), который предоставляет 7 инструментов для ИИ-помощников по кодированию. Запустите его с помощью i1n mcp и настройте ваш редактор для подключения. Для Claude Code: claude mcp add i1n -- npx i1n mcp. Для Cursor: добавьте в .cursor/mcp.json.

Доступные инструменты MCP: i1n_status (статус проекта и лимиты), i1n_push (отправка локальных файлов), i1n_pull (загрузка переводов и генерация типов), i1n_translate (AI-перевод на указанные языки), i1n_add_language (добавление новых языков), i1n_extract_and_translate (извлечение строк, отправка, перевод и генерация типов за один шаг) и i1n_search (поиск существующих ключей перевода).

Убойный рабочий процесс: интернационализация за секунды

Главная особенность — функция i1n_extract_and_translate. Скажите вашему агенту «интернационализировать этот компонент» — агент прочитает файл, определит жестко закодированные строки, вызовет инструмент MCP с извлеченными парами ключ-значение, а i1n позаботится обо всем: отправке ключей, переводе на все активные языки и регенерации определений TypeScript. Затем агент перепишет ваш код с вызовами t().

Задача, которая традиционно занимает 60 минут — извлечение строк, создание записей JSON, перевод, обновление типов — выполняется за 30 секунд. Этот рабочий процесс работает с Cursor, Claude Code, Windsurf и любым MCP-совместимым помощником.

Агентный рабочий процесс

Поставьте вашему агенту задачу, например: «Добавить страницу настроек с предпочтениями уведомлений. Перевести на испанский и японский языки». Агент создаст компонент с правильными ключами перевода, а затем воспользуется инструментами MCP или выполнит команду i1n push --translate es,ja.

Весь процесс локализации — от создания ключей до AI-перевода — происходит без ручного вмешательства. Этот рабочий процесс поддерживается всеми основными AI-агентами для написания кода как через правила контекста, так и через интеграцию с MCP.

terminal 
i1n setup-ai
# Generates:
# .cursor/rules/i1n.mdc
# CLAUDE.md
# .windsurfrules
# .github/copilot-instructions.md
# AGENTS.md
.mcp.json 
{
  "mcpServers": {
    "i1n": {
      "command": "npx",
      "args": ["i1n", "mcp"]
    }
  }
}

Связанное

ИИ-перевод

Перевод на базе ИИ с настраиваемой защитой, единообразием фирменного стиля и интеллектуальным кэшированием.

Bring Your Own Key (BYOK)

Использование собственного ключа (BYOK) для плана Enterprise: подключите ключ API Google Gemini, чтобы получить дополнительные кредиты, расширенный выбор моделей и прямое выставление счетов.

Журнал аудита

Неизменяемая запись всех изменений в вашей организации i1n — различия переводов по ключам, события команды и биллинга, атрибуция ИИ-агентов и экспорт CSV в один клик. Доступно в корпоративных планах.
Предыдущий
ИИ-перевод
Далее
Bring Your Own Key (BYOK)