Índice
Cuando estás construyendo una función y añadiendo una nueva cadena de interfaz, el flujo de trabajo tradicional se ve así: escribes el código, añades una cadena provisional, haces el commit, abres el panel de tu TMS, añades manualmente la nueva clave, escribes la cadena fuente en inglés, solicitas traducciones, esperas, vuelves más tarde a revisar, publicas. La desconexion entre escribir código y gestionar traducciones es una fuente constante de friccion.
El Model Context Protocol (MCP) ofrece un modelo diferente. En lugar de cambiar entre tu entorno de desarrollo y un panel separado, tu asistente de IA — el mismo que te ayuda a escribir código — puede gestionar tus traducciones directamente, en la misma conversacion.
Esto es lo que habilita el servidor MCP de Better i18n.
¿Qué es MCP?
El Model Context Protocol es un estándar abierto desarrollado por Anthropic que permite a los modelos de IA interactuar con herramientas y fuentes de datos externas de forma estructurada. Un servidor MCP expone un conjunto de "herramientas" que un asistente de IA puede invocar — similar a como una API web expone endpoints.
Cuando configuras Claude (u otra IA compatible con MCP) para usar el servidor MCP de Better i18n, Claude gana la capacidad de:
- Listar tus proyectos y claves de traduccion
- Leer las traducciones actuales
- Añadir nuevas claves de traduccion
- Proponer traducciones para idiomas que faltan
- Publicar traducciones aprobadas
- Verificar el estado de sincronizacion con GitHub
Todo esto ocurre en lenguaje natural, dentro de tu conversacion de desarrollo.
Configurando Better i18n MCP
La instalacion tarda unos 2 minutos. Añade el servidor MCP a tu configuracion:
// .mcp.json (en la raiz de tu proyecto o ~/.mcp.json globalmente)
{
"mcpServers": {
"better-i18n": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@better-i18n/mcp@latest"],
"env": {
"BETTER_I18N_API_KEY": "tu-clave-api"
}
}
}
}
Eso es todo. Reinicia Claude y ahora tiene acceso a tu espacio de trabajo de Better i18n.
Qué Puedes Hacer Con él
Verificar qué falta
Tú: "¿Qué claves de traduccion les falta la traduccion al alemán en el proyecto de incorporacion?" Claude: [consulta better-i18n] Hay 12 claves sin traduccion al alemán: - onboarding.welcome.title - onboarding.welcome.subtitle - onboarding.step1.heading ... ¿Quieres que proponga traducciones al alemán para estas?
Añadir nuevas claves mientras escribes codigo
Tú: "Estoy añadiendo un nuevo estado de error para cuando se excede el limite de la API.
Añade una clave de traduccion para 'Has alcanzado tu limite de la API. Actualiza tu plan para continuar.'"
Claude: Clave `errors.api.rate_limit_exceeded` añadida. También he propuesto traducciones
para tus 6 idiomas activos:
- de: "Sie haben Ihr API-Limit erreicht..."
- fr: "Vous avez atteint votre limite API..."
- es: "Ha alcanzado su límite de API. Actualice su plan para continuar."
- ja: "APIレート制限に達しました。"
¿Publico estas, o prefieres revisarlas primero?
Revisar y publicar selectivamente
Tú: "Alemán y francés se ven bien. Deja el japonés — necesitamos un revisor nativo.
Publica los demás."
Claude: Traducciones de, fr, es publicadas para `errors.api.rate_limit_exceeded`.
El japonés está en cola como borrador pendiente de revision.
El Cambio en el Flujo de Trabajo del Desarrollador
El cambio fundamental que habilita MCP es la colocalización del trabajo de código y localización. Cuando la gestión de traducciones es un panel separado al que tienes que cambiar, crea sobrecarga cognitiva y una tendencia a diferir la localización.
Antes de MCP:
- Escribes el código de la función
- Usas una cadena provisional o codificas en inglés
- Haces el commit
- Abres el panel TMS (pestaña separada, contexto separado)
- Añades la clave, escribes la fuente en inglés, solicitas traducción
- Esperas, vuelves, publicas
Con MCP:
- Escribes el código de la función
- Le dices a Claude: "Añade clave de traducción con traducciones AI para todos los idiomas activos"
- Revisas en la misma conversación
- Publicas o pones en cola para revisión
- Continúas programando
El paso de localización pasa de "tarea diferida" a "parte del flujo de trabajo de programación".
Casos de Uso Más Allá del Desarrollo
MCP no es solo para ingenieros. Las mismas herramientas pueden ser usadas por:
Gestores de producto verificando la cobertura de traducciones antes de un lanzamiento:
"Dame un informe de cobertura de traducción para el módulo de facturación en los 8 idiomas"
Equipos de contenido gestionando textos de marketing:
"¿Qué claves de las páginas de marketing no tienen traducción al español?" "Propón traducciones al español para todas las claves faltantes de la página de inicio"
Éxito del cliente gestionando correcciones urgentes:
"Hay un error tipográfico en el asunto del correo de bienvenida en francés. Corrígelo: 'Bienvenue chez Better i18n' debería ser 'Bienvenue sur Better i18n'"
Qué Expone el Servidor MCP
El paquete @better-i18n/mcp expone las siguientes herramientas:
| Herramienta | Descripción |
|---|---|
listProjects | Lista todos los proyectos en tu espacio de trabajo |
getProject | Obtiene detalles del proyecto incluyendo idiomas |
listKeys | Lista claves de traducción con opciones de filtrado |
getTranslations | Obtiene traducciones para una clave específica en todos los idiomas |
createKeys | Añade nuevas claves de traducción con texto fuente |
updateKeys | Actualiza claves existentes o sus traducciones |
proposeLanguageEdits | Propone traducciones AI para idiomas faltantes |
publishTranslations | Publica traducciones aprobadas a la CDN |
getSync | Obtiene el estado de sincronización con GitHub |
getPendingChanges | Lista claves pendientes de revisión o publicación |
El servidor MCP es de código abierto (packages/mcp en el repositorio OSS), por lo que puedes inspeccionar exactamente qué hace, extenderlo o contribuir mejoras.
Privacidad y Seguridad
Alcance de la clave API: Tu clave API de MCP puede tener alcance de solo lectura, solo borradores o acceso completo. Para herramientas de IA, recomendamos solo borradores en entornos de producción — la IA puede proponer traducciones, pero un humano debe publicarlas.
Registro de auditoría: Cada acción realizada por el servidor MCP queda registrada en tu espacio de trabajo de Better i18n con la clave API que la realizó.
Flujo de revisión: Las traducciones propuestas por IA se crean como borradores por defecto y pasan por el mismo flujo de revisión que las propuestas por humanos antes de ser publicadas.
La Visión General
MCP es una señal temprana de un cambio más amplio en cómo funciona las herramientas de software. Los equipos que integren la IA profundamente en su flujo de trabajo de localización se moverán significativamente más rápido en los mercados internacionales.
