better-i18n MCP Server: gestiona traducciones desde tu IDE de IA

MCP Server: Gestiona traducciones desde tu IDE de IA

Los desarrolladores pasan la mayor parte de su jornada laboral en un editor de código. Cuando la localización vive en una aplicación web separada, cambiar de contexto para gestionar traducciones cuesta tiempo y rompe el flujo de trabajo. Un desarrollador que quiere comprobar si una nueva cadena ya está traducida, agregar una clave al archivo de traducción, o revisar cómo se ve una cadena en alemán, tiene que salir del editor, iniciar sesión en la plataforma de localización, encontrar el proyecto, encontrar la cadena y volver.

Multiplica esa fricción por cientos de cadenas por sprint, por cada desarrollador del equipo, y la carga es significativa. Peor aún, la fricción lleva a los desarrolladores a aplazar el trabajo de localización — a marcar cosas como "hacerlo después" — lo que crea un backlog que crece hasta convertirse en una crisis antes de un lanzamiento.

better-i18n resuelve esto con un servidor MCP (Model Context Protocol) integrado. Tu IDE de IA — Claude, Cursor, Windsurf o Zed — se conecta directamente a tu espacio de trabajo de traducción y puede leer y escribir en él usando lenguaje natural. La gestión de traducciones se convierte en parte del flujo de desarrollo, no en un ejercicio separado de cambio de contexto.

Cómo funciona

¿Qué es Model Context Protocol?

Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que define cómo los asistentes de IA pueden conectarse a herramientas externas y fuentes de datos. Cuando una aplicación expone un servidor MCP, los IDEs de IA pueden descubrir sus capacidades e interactuar con él mediante llamadas a herramientas estructuradas.

El servidor MCP de better-i18n expone tu espacio de trabajo de traducción como un conjunto de herramientas que cualquier IDE de IA compatible con MCP puede llamar. La IA puede leer tus cadenas de traducción, enviar nuevas, comprobar la cobertura, ejecutar verificaciones de calidad y gestionar entradas del glosario — todo a través de la interfaz de lenguaje natural que ya usas para escribir código.

Esto es significativamente diferente de un plugin o una API. No escribes código para llamar a la API. Simplemente describes lo que quieres en la misma interfaz conversacional que ya usas con tu asistente de IA, y el asistente gestiona las llamadas a herramientas en segundo plano.

Conectar tu IDE

La configuración lleva unos minutos. Agregas la URL del servidor MCP de better-i18n y tu token de API del proyecto a la configuración MCP de tu IDE. En Cursor, esto es un archivo mcp.json. En Claude Desktop, es el panel de configuración MCP. En Windsurf y Zed, se aplican archivos de configuración similares.

Una vez conectado, tu asistente de IA toma conciencia de tu espacio de trabajo de traducción. Conoce la estructura de tu proyecto, tu idioma fuente, tus idiomas destino, tu glosario y tus traducciones aprobadas existentes. Este contexto está disponible sin ningún mensaje adicional — la IA lo lee automáticamente desde la conexión MCP.

Leer el estado de las traducciones

Con la conexión MCP activa, puedes hacerle preguntas a tu asistente de IA sobre tus traducciones directamente:

• "¿Qué cadenas en este archivo aún no están traducidas al francés?"
• "¿Ya existe una traducción para la clave auth.login.button.label?"
• "Muéstrame todas las traducciones que están pendientes de revisión en japonés."
• "¿Cuál es la traducción alemana de la cadena en la línea 47?"

La IA llama a las herramientas MCP apropiadas, recupera los datos de tu espacio de trabajo de better-i18n y presenta la respuesta en la conversación. Sin cambio de pestañas, sin búsquedas en una interfaz web.

Enviar nuevas cadenas

Cuando agregas una nueva cadena de cara al usuario a tu base de código, puedes enviarla a tu espacio de trabajo de better-i18n sin salir del editor:

• "Agrega la cadena en la línea 83 a better-i18n como checkout.summary.total.label con el valor 'Total del pedido'."
• "Extrae todas las cadenas codificadas de forma fija de este componente y envíalas a better-i18n."
• "Crea claves de traducción para todas las cadenas de esta nueva función, siguiendo nuestra convención de nomenclatura existente."

La IA lee tu código, identifica las cadenas, infiere nombres de claves apropiados basándose en tus convenciones existentes y crea las entradas en tu espacio de trabajo de better-i18n en una sola operación. Este es el tipo de trabajo tedioso que los desarrolladores actualmente hacen manualmente o aplazan indefinidamente.

Para la extracción a gran escala, la herramienta CLI es más apropiada — puede escanear toda tu base de código en una sola pasada. La integración MCP es más adecuada para el flujo de trabajo continuo de agregar cadenas individuales mientras escribes código.

Traducción asistida por IA

Con acceso a tu espacio de trabajo de traducción, glosario y memoria de traducción, tu asistente de IA puede proponer traducciones de alta calidad:

• "Traduce esta nueva cadena a todos nuestros idiomas destino, usando el glosario para términos de marca."
• "Sugiere una traducción al alemán que coincida con el tono de nuestras cadenas aprobadas existentes."
• "Comprueba si la traducción al francés de esta cadena es coherente con cómo hemos traducido cadenas similares."

La IA tiene acceso a tu memoria de traducción completa, por lo que sus sugerencias no son genéricas — reflejan el vocabulario específico, el tono y las convenciones de tu producto. Las traducciones sugeridas se crean como borradores en better-i18n y son inmediatamente visibles para tus revisores humanos en el flujo de colaboración.

Ejecutar verificaciones de calidad

También puedes activar operaciones de garantía de calidad desde el IDE:

• "Ejecuta una verificación de calidad en todas las cadenas que agregué hoy."
• "Comprueba si alguna de las nuevas cadenas tiene problemas de formato de marcador de posición."
• "Encuentra todas las traducciones al francés que son más de 40 caracteres más largas que su cadena fuente."

Estas operaciones usan el mismo motor de QA que se ejecuta automáticamente en el editor web. La diferencia es que los estás activando programáticamente, desde tu entorno de desarrollo, como parte de tu flujo normal de revisión de código.

@mención en hilos de colaboración

La integración MCP también potencia el sistema de @mención en la interfaz de colaboración de better-i18n. Cuando un revisor deja un comentario sobre una traducción y escribe @claude verifica el tono de esta cadena con nuestra guía de estilo, la IA lee la cadena, la guía de estilo y las traducciones aprobadas existentes a través de la conexión MCP y responde directamente en el hilo.

Esto se describe con más detalle en la página de función colaboración.

Beneficios clave

Cero cambio de contexto

El mayor beneficio práctico es que los desarrolladores nunca tienen que salir de su editor para gestionar tareas relacionadas con la traducción. Comprobar la cobertura, agregar claves, enviar cadenas, obtener resultados de QA — todo ocurre en la interfaz conversacional del IDE de IA. La carga mental de gestionar traducciones cae a casi cero.

Adopción de localización más rápida

Cuando la localización es fluida, los desarrolladores realmente la hacen en tiempo real en lugar de aplazarla. Los equipos que usan la integración MCP informan consistentemente que su recuento de "cadenas no traducidas en producción" cae significativamente dentro del primer sprint de uso.

IA con contexto real

Las herramientas de traducción de IA genéricas no tienen conocimiento del vocabulario específico, las directrices de tono o las traducciones existentes de tu producto. La integración MCP de better-i18n le da a la IA acceso completo a tu memoria de traducción y glosario antes de que genere cualquier sugerencia. La diferencia de calidad entre las sugerencias de IA con y sin contexto es sustancial.

Convenciones de nomenclatura coherentes

Cuando la IA crea nuevas claves de traducción, lee tu estructura de claves existente y sigue las mismas convenciones automáticamente. Claves como auth.login.button.label y checkout.summary.total.label siguen un patrón predecible. Sin automatización, los desarrolladores aplican convenciones de forma inconsistente, especialmente bajo presión de plazos.

Integración con el conjunto completo de funciones

La integración MCP no es un subconjunto limitado de las capacidades de better-i18n. Todo lo accesible a través de la interfaz web también es accesible a través de las herramientas MCP. Historial de versiones, datos de análisis, resultados de QA, gestión de glosarios — todo está disponible desde tu IDE.

Casos de uso

Desarrollo activo: Mientras un desarrollador escribe un nuevo componente, usa la IA para extraer cadenas codificadas de forma fija, generar nombres de claves apropiados, enviar las claves a better-i18n y solicitar traducciones iniciales de IA — todo en una sesión conversacional sin salir del editor.

Revisión de código: Un revisor ve un PR que agrega nuevas cadenas de cara al usuario. Le piden a su IA que compruebe si las cadenas han sido enviadas a better-i18n y si existen traducciones para todos los idiomas destino. La IA comprueba e informa en menos de un segundo.

Refactorización: Un desarrollador cambia el nombre de un componente y necesita actualizar las claves de traducción para que coincidan. Le piden a la IA que encuentre todas las claves con el prefijo antiguo, las renombre en better-i18n y actualice las referencias en la base de código.

QA previa al lanzamiento: El día antes de un lanzamiento, un desarrollador le pide a la IA que genere un informe de cobertura completo para todos los idiomas y marque las cadenas agregadas en la última semana que no tienen traducciones aprobadas. La IA devuelve una lista priorizada.

Gestión del glosario: Un product manager actualiza la terminología de marca y le pide a la IA que actualice el glosario de better-i18n y marque todas las traducciones que usan el término antiguo en todos los idiomas.

Cómo better-i18n implementa MCP

El servidor MCP de better-i18n está implementado contra la especificación MCP completa. Expone un conjunto de herramientas con nombre — get_string, create_string, update_string, search_strings, get_coverage, run_qa, get_glossary_entries, create_glossary_entry y otras — cada una con un JSON schema que describe sus parámetros y tipos de retorno.

Cuando una IA compatible con MCP llama a una de estas herramientas, el servidor autentica la solicitud usando el token de API del proyecto, aplica los mismos controles de acceso basados en roles que se aplican a la interfaz web y devuelve datos estructurados que la IA puede usar para formular su respuesta.

El servidor es sin estado y horizontalmente escalable. Cada llamada a herramienta es una solicitud de API independiente. No hay estado de sesión que gestionar, y la conexión puede interrumpirse y reanudarse sin perder contexto.

La autenticación usa tokens de API con alcance por proyecto. Un token emitido para un proyecto no puede usarse para acceder a otro proyecto, incluso si ambos proyectos pertenecen a la misma organización.

Comparación con alternativas

Plugins de Lokalise y Phrase: Ambas plataformas ofrecen plugins de editor para algunos IDEs, pero estos son plugins de UI tradicionales — barras laterales o paneles que replican la interfaz web dentro del editor. No admiten interacción en lenguaje natural ni operaciones asistidas por IA.

Scripts de API personalizados: Los equipos a veces escriben scripts personalizados que llaman a la API de una plataforma de localización para enviar o recuperar cadenas. Esto requiere mantenimiento continuo, no admite consultas en lenguaje natural y no está disponible para miembros no técnicos del equipo.

Traducción de IA sin contexto: Usar una IA de propósito general para traducir cadenas sin acceso a tu memoria de traducción, glosario o traducciones aprobadas existentes produce resultados inconsistentes. La integración MCP resuelve esto dándole a la IA todo el contexto que necesita.

Edición directa de archivos: Editar archivos de traducción JSON o YAML directamente en la base de código es el enfoque más simple pero crea problemas de sincronización, dificulta la colaboración y no proporciona QA. La herramienta CLI es una alternativa mejor estructurada para flujos de trabajo basados en archivos, y la integración MCP se construye sobre ella.

Preguntas frecuentes

¿Qué IDEs de IA admiten MCP? A principios de 2026, MCP es compatible con Claude Desktop, Cursor, Windsurf, Zed y una lista creciente de otros entornos de desarrollo potenciados por IA. El protocolo es abierto y está siendo adoptado activamente en toda la industria.

¿Necesito una clave de API separada para cada desarrollador de mi equipo? No. Los tokens de API pueden tener alcance de proyecto y compartirse, o puedes emitir tokens individuales por desarrollador para fines de auditoría. La gestión de tokens está disponible en el panel de configuración del proyecto.

¿Puede la IA modificar las traducciones de producción directamente? El servidor MCP respeta tu configuración de flujo de trabajo. Si tu proyecto requiere un paso de revisión antes de publicar, las traducciones creadas o editadas por IA se colocan en estado "pendiente de revisión", no se publican directamente. La IA trabaja dentro de los mismos controles de acceso que cualquier otro colaborador.

¿Es segura la conexión MCP? Sí. Toda la comunicación entre el IDE y el servidor MCP de better-i18n usa HTTPS. Los tokens de API están limitados a proyectos específicos y pueden revocarse en cualquier momento desde la configuración del proyecto. El servidor aplica acceso basado en roles en cada llamada a herramienta.

¿Qué pasa si tengo miles de cadenas? ¿Se abruma la IA? Las herramientas MCP están diseñadas para acceso eficiente y dirigido — no para recuperación completa del conjunto de datos. Cuando la IA necesita encontrar cadenas relevantes, usa las herramientas de búsqueda y filtro en lugar de cargar todo. Para operaciones masivas, la herramienta CLI es más apropiada.

Lleva tus traducciones a tu flujo de desarrollo

La gestión de traducciones no debería ser una aplicación separada. Debería ser parte de las herramientas que ya usas para construir tu producto. La integración MCP de better-i18n lo hace posible hoy, con cualquier IDE de IA compatible con MCP.

Comienza tu prueba gratuita y conecta tu IDE en minutos.