Documentación Integración de agentes

Integración de agentes

Configure agentes de codificación de IA (Cursor, Claude Code, Windsurf, GitHub Copilot, Codex) para manejar la localización automáticamente, incluida la integración nativa de MCP.

Descripción general

i1n está construido agent-first. Se integra con los agentes de codificación de IA en dos niveles: reglas de contexto que enseñan a los agentes las convenciones i18n de tu proyecto, y un servidor MCP nativo que les permite ejecutar comandos i1n directamente.

Una vez configurados, los agentes utilizan automáticamente claves de traducción en lugar de cadenas codificadas, colocan las claves en los archivos de namespace correctos, conservan las variables de interpolación y pueden enviar, traducir y recibir sin salir del IDE.

Reglas de contexto (setup-ai)

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

Cada archivo de reglas está adaptado al formato y las capacidades específicas del agente. Ejecute i1n setup-ai para generar todos los archivos a la vez.

Servidor MCP

i1n incluye un servidor nativo del Protocolo de Contexto de Modelo (MCP) que expone 7 herramientas a los asistentes de codificación de IA. Inícialo con i1n mcp y configura tu editor para conectarte. Para Claude Code: claude mcp add i1n -- npx i1n mcp. Para Cursor: agrégalo a .cursor/mcp.json.

Herramientas MCP disponibles: i1n_status (estado y límites del proyecto), i1n_push (enviar archivos locales), i1n_pull (descargar traducciones y generar tipos), i1n_translate (traducción por IA a idiomas especificados), i1n_add_language (agregar nuevos idiomas), i1n_extract_and_translate (extraer cadenas, enviar, traducir y generar tipos en un solo paso) y i1n_search (buscar claves de traducción existentes).

El flujo de trabajo definitivo: Internacionalice en segundos

La característica destacada es i1n_extract_and_translate. Indíquele a su agente "internacionaliza este componente": el agente lee el archivo, identifica las cadenas codificadas de forma rígida, llama a la herramienta MCP con los pares clave-valor extraídos e i1n se encarga de todo: enviar las claves, traducir a todos los idiomas activos y regenerar las definiciones de TypeScript. Luego, el agente reescribe su código con llamadas t().

Una tarea que tradicionalmente lleva 60 minutos —extraer cadenas, crear entradas JSON, traducir, actualizar tipos— se realiza en 30 segundos. Este flujo de trabajo funciona con Cursor, Claude Code, Windsurf y cualquier asistente compatible con MCP.

Flujo de trabajo de agentes

Asigne a su agente una tarea como "Agrega una página de configuración con preferencias de notificación. Traduce al español y al japonés". El agente crea el componente con las claves de traducción adecuadas y luego utiliza las herramientas MCP o ejecuta i1n push --translate es,ja.

Todo el proceso de localización —desde la creación de claves hasta la traducción por IA— se realiza sin intervención manual. Este flujo de trabajo es compatible con los principales agentes de codificación de IA, tanto a través de reglas de contexto como de integración 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