Documentos Integração de Agente

Integração de Agente

Configure agentes de codificação de IA (Cursor, Claude Code, Windsurf, GitHub Copilot, Codex) para lidar com a localização automaticamente — incluindo integração nativa do MCP.

Visão geral

i1n é a primeira ferramenta de localização criada para a era agêntica. Ela se integra com agentes de codificação de IA em dois níveis: regras de contexto que ensinam aos agentes as convenções de i18n do seu projeto e um servidor MCP nativo que permite aos agentes executar comandos i18n diretamente.

Após a configuração, os agentes usam automaticamente chaves de tradução em vez de strings codificadas, colocam as chaves nos arquivos de namespace corretos, preservam variáveis de interpolação e podem enviar, traduzir e receber sem sair do IDE.

Regras de Contexto (setup-ai)

i1n gera regras de contexto para Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) e Antigravity (.antigravity/rules.md).

Cada arquivo de regras é adaptado ao formato e às capacidades específicas do agente. Execute i1n setup-ai para gerar todos os arquivos de uma vez.

Servidor MCP

i1n inclui um servidor nativo do Model Context Protocol (MCP) que expõe 7 ferramentas para assistentes de codificação de IA. Inicie-o com i1n mcp e configure seu editor para conectar. Para Claude Code: claude mcp add i1n -- npx i1n mcp. Para Cursor: adicione a .cursor/mcp.json.

Ferramentas MCP disponíveis: i1n_status (status e limites do projeto), i1n_push (envia arquivos locais), i1n_pull (baixa traduções e gera tipos), i1n_translate (tradução por IA para idiomas especificados), i1n_add_language (adiciona novos idiomas), i1n_extract_and_translate (extrai strings, envia, traduz e gera tipos em uma única etapa) e i1n_search (encontra chaves de tradução existentes).

O Fluxo de Trabalho Definitivo: Internacionalize em Segundos

O recurso de destaque é i1n_extract_and_translate. Diga ao seu agente "internacionalize este componente" — o agente lê o arquivo, identifica strings codificadas, chama a ferramenta MCP com os pares chave-valor extraídos e o i1n cuida de tudo: enviando chaves, traduzindo para todos os idiomas ativos e regenerando definições TypeScript. O agente então reescreve seu código com chamadas t().

Uma tarefa que tradicionalmente leva 60 minutos —extrair strings, criar entradas JSON, traduzir, atualizar tipos— acontece em 30 segundos. Este fluxo de trabalho funciona com Cursor, Claude Code, Windsurf e qualquer assistente compatível com MCP.

Fluxo de Trabalho Agentivo

Dê ao seu agente uma tarefa como "Adicionar uma página de configurações com preferências de notificação. Traduzir para espanhol e japonês." O agente cria o componente com as chaves de tradução adequadas e, em seguida, usa as ferramentas MCP ou executa i1n push --translate es,ja.

Todo o processo de localização — da criação de chaves à tradução por IA — acontece sem intervenção manual. Este fluxo de trabalho é suportado por todos os principais agentes de codificação de IA por meio de regras de contexto e integração 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"]
    }
  }
}

Relacionado