¿Cómo uso el servidor MCP con agentes de codificación IA?

El servidor MCP (Model Context Protocol) de Better i18n permite a los agentes de codificación IA gestionar directamente tus traducciones. Crea claves, actualiza traducciones, verifica el estado de sincronización — todo con comandos en lenguaje natural desde tu IDE.

¿Qué es MCP?

MCP es un protocolo que permite a los agentes IA interactuar con herramientas externas. Al conectar el servidor MCP de Better i18n, tu agente IA puede:

• Listar y buscar claves de traducción
• Crear nuevas claves con valores
• Actualizar traducciones en todos los idiomas
• Verificar el estado de sincronización y encontrar traducciones faltantes
• Publicar cambios en el CDN
• Gestionar contenido a través del Content SDK

Configuración

Claude Code

Agrega a tu .mcp.json del proyecto:

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp"],
      "env": {
        "BETTER_I18N_API_KEY": "sk_..."
      }
    }
  }
}

Cursor / Windsurf

Agrega a la configuración MCP de tu IDE (generalmente en Configuración → Servidores MCP):

{
  "better-i18n": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Nota: Usa una clave secreta (sk_...) para el servidor MCP, no una clave pública. El servidor MCP necesita acceso de escritura.

Ejemplos de flujos de trabajo

Agregar claves mientras se codifica

Tú: "Estoy añadiendo una página de configuración. Crea claves de traducción para
     settings.title, settings.save_button y settings.cancel_button
     con valores en inglés."

Agente: Usa la herramienta createKeys para añadir las tres claves con sus valores.

Traducir

Tú: "Traduce todas las claves sin traducir en el espacio de nombres 'settings' al turco."

Agente: Usa getTranslations para encontrar las lagunas, luego proposeLanguageEdits
        para añadir traducciones en turco.

Verificar el estado

Tú: "¿Hay claves sin traducción al turco?"

Agente: Usa listKeys con filtro de idioma para encontrar claves sin traducir.

Publicar

Tú: "Publica todas las traducciones pendientes."

Agente: Usa publishTranslations para enviar cambios al CDN.

Gestión de contenido

También existe un servidor MCP separado para la gestión de contenido:

{
  "better-i18n-content": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp-content"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Esto permite gestionar modelos de contenido estructurado y entradas — publicaciones de blog, registros de cambios, artículos de ayuda y más.

Consideraciones de seguridad

• El servidor MCP se ejecuta localmente en tu máquina
• Tu clave API permanece en tu entorno local
• El agente solo puede realizar acciones dentro de los permisos de tu proyecto
• Todos los cambios se registran en el log de actividad del panel

Agentes compatibles

Cualquier agente compatible con MCP funciona, incluyendo:

• Claude Code (CLI)
• Claude Desktop
• Cursor
• Windsurf
• Continue
• Agentes personalizados construidos con el SDK de MCP

Próximos pasos

• Documentación de MCP
• Calidad de la traducción con IA