El servidor MCP de Lingo.dev ofrece a los asistentes de programación con IA acceso directo a la configuración de tu motor de localización. Esta guía te muestra cómo configurar un motor de localización desde cero: desde la instalación hasta tenerlo totalmente listo, con voces de marca por idioma, términos de glosario, reglas lingüísticas y enrutamiento de modelos.
Qué vas a configurar#
| Capa | Qué hace | Ejemplo |
|---|---|---|
| Voces de marca | Tono y nivel de formalidad por idioma | "du" informal para desarrolladores alemanes, tono formal y cortés en japonés |
| Glosario | Traducciones personalizadas + términos no traducibles | "Deploy" → "Bereitstellen" en alemán, "OAuth" se mantiene igual en todos los idiomas |
| Reglas | Convenciones lingüísticas específicas de cada idioma | Espacios de no separación antes de la puntuación francesa, caracteres de ancho completo en japonés |
| Enrutamiento de modelos | Selección de modelos por idioma con alternativas de respaldo | Claude Sonnet para pares europeos, GPT-4o como respaldo para japonés |
Los tres primeros pertenecen a tu organización, no a un motor concreto: un glosario, un conjunto de reglas o una voz de marca llegan a un motor al vincularlos, así que un segundo motor puede aplicar la misma configuración en lugar de usar una copia. El enrutamiento de modelos sigue siendo propio de cada motor.
El resultado es una API de traducción con estado. Llámala desde código a través de la API de localización, desde la línea de comandos con la CLI o de forma automática en cada pull request mediante CI/CD. Cada solicitud aplica todas las capas automáticamente.
El problema#
Cada motor de localización necesita voces de marca por idioma, términos de glosario, reglas lingüísticas y enrutamiento de modelos. Configurarlo todo desde un panel lleva tiempo y resulta repetitivo, sobre todo la primera vez, cuando aún estás entendiendo qué hace cada capa y cómo se relacionan entre sí.
El servidor MCP de Lingo.dev permite que tu asistente de programación con IA se encargue de la configuración inicial en una sola conversación. Le indicas el contenido de tu producto y crea el motor, redacta los textos de voz de marca, identifica términos para el glosario, añade reglas específicas por idioma y configura el enrutamiento de modelos, todo de una sola pasada. Después, revisas el resultado y lo ajustas a partir de ahí.
Paso 1: Instala el MCP#
Genera una clave de API desde la sección API Keys del panel de Lingo.dev. Después, añade el servidor MCP a la configuración de tu agente de programación.
Añádelo a tu .claude/settings.json o al .mcp.json del proyecto:
{
"lingo": {
"type": "http",
"url": "https://mcp.lingo.dev/account",
"headers": {
"x-api-key": "your_api_key"
}
}
}Ámbito de la organización
La clave de API determina qué organización gestiona el servidor MCP. Todas las operaciones se ejecutan automáticamente dentro de esa organización; tu asistente nunca tendrá que especificar un ID de organización.
Reinicia tu agente y comprueba la conexión pidiéndole que enumere tus motores de localización existentes. Si el MCP está activo, devolverá resultados (o una lista vacía si la organización es nueva).
Paso 2: Configura el motor#
Copia el prompt que aparece a continuación y pégalo en tu asistente de programación con IA. Sustituye la URL del final por el sitio web, la documentación o el README de tu producto: el agente necesita contenido representativo para inferir tu voz, tu terminología y tu audiencia.
Create a localization engine called 'My Product' for localizing into
German, French, Japanese, and Spanish. Study the content at the URL
below to understand our tone, terminology, and audience. Then configure
everything in one pass: brand voice texts for each locale (and English),
glossary terms that need consistent translations or should stay
untranslated, and locale-specific linguistic rules.
https://docs.yourproduct.comNo olvides la URL
El prompt termina con una URL de marcador de posición. Sustitúyela por un enlace a contenido que refleje la voz real de tu producto: documentación, README, flujo de onboarding o web de marketing. Sin eso, el agente generará una configuración genérica.
El agente lee tu contenido, crea el motor y configura todas las capas de una sola pasada. Los siguientes pasos consisten en revisar y ajustar lo que ha generado.
Paso 3: Ajusta las voces de marca#
Revisa la voz de marca que ha creado el agente. Una voz de marca incluye un texto por idioma que define cómo habla tu producto en esa lengua: tono, formalidad y estilo. El agente lo infiere a partir de tu contenido, pero merece la pena revisar los matices culturales.
Qué debes revisar:
| Idioma | Ajuste habitual |
|---|---|
| Alemán | «du» (informal) frente a «Sie» (formal): depende de tu audiencia |
| Francés | «tu» (informal) frente a «vous» (formal): consumo frente a empresa |
| Japonés | Nivel de cortesía: la forma cortés y formal (です/ます) es una apuesta segura para la mayoría de los productos |
| Inglés | A menudo falta el texto del idioma de origen: añade uno para mantener la coherencia |
Un texto de voz de marca en alemán bien configurado tiene este aspecto:
Use informal "du" address. Keep a direct, technical tone.
Prefer short sentences. Use active voice. When a German equivalent
exists for a technical term, use it (e.g., "Bereitstellung" for
deployment), but keep widely-adopted English terms as-is
(e.g., API, CLI, Token).Si el registro no es el adecuado, díselo directamente a tu asistente:
The German brand voice is too informal for our enterprise docs.
Switch it to formal "Sie" register.Paso 4: Ajusta el glosario#
Revisa los términos del glosario que ha creado el agente. El glosario da al motor un control preciso sobre términos concretos: puede imponer una traducción o evitar por completo que se traduzcan. El agente identifica términos a partir de tu contenido, pero puede pasar por alto algunos propios del producto o elegir traducciones incorrectas.
Un glosario típico tras la primera pasada:
| Texto de origen | Texto de destino | Idioma de origen | Idioma de destino | Tipo |
|---|---|---|---|---|
| Deploy | Bereitstellen | en | de | traducción personalizada |
| workspace | espace de travail | en | fr | traducción personalizada |
| Lingo.dev | Lingo.dev | * | * | no traducible |
| OAuth | OAuth | * | * | no traducible |
Qué debes revisar:
- Términos que faltan: nombres de funcionalidades del producto, jerga interna que el agente no haya encontrado
- Traducciones incorrectas: el agente puede elegir un sinónimo que no encaje con el uso que ya tienes establecido
- No traducibles que faltan: marcas, nombres de protocolos o siglas que deben mantenerse tal cual
Los términos se emparejan por similitud semántica: un término como "Deploy" también coincide con "Deploying", "deployment" y "deploy your application" sin necesidad de crear entradas separadas. Usa * comodines para términos que se apliquen a todos los idiomas.
Add a glossary term: 'checkout' should stay as 'Checkout' in
German - it's our product feature name, not the shopping action.Paso 5: Ajusta las reglas#
Revisa las reglas que ha creado el agente. Las reglas son convenciones concretas y verificables para idiomas específicos, agrupadas en un conjunto de reglas que aplica el motor. A diferencia de una voz de marca, que marca el tono general, las reglas recogen lo que a los modelos genéricos se les suele escapar: puntuación, abreviaturas, ancho de caracteres y formato de números.
Un conjunto típico de reglas tras la primera pasada:
| Idioma | Nombre | Regla |
|---|---|---|
| fr | Espaciado de la puntuación en francés | Usa siempre un espacio de no separación antes de :, ;, ! y ? |
| de | Abreviaturas de direcciones en alemán | Abrevia "Straße" como "Str." y "Nummer" como "Nr." |
| ja | Ancho de caracteres en japonés | Usa paréntesis de ancho completo （） en lugar de paréntesis de medio ancho () |
Cada regla aborda un único aspecto, así que puedes comprobarlas de forma individual: si fallan las abreviaturas en alemán, actualiza solo esa regla sin tocar nada más.
Qué debes revisar:
- Reglas que faltan: formato de números, formatos de fecha o convenciones monetarias para tus idiomas de destino
- Idioma de origen: a menudo faltan reglas en inglés sobre la coma de Oxford, el uso de mayúsculas en títulos o el formato de los números
In French, there should always be a non-breaking space before
colons and semicolons. Add that as a rule for fr.Paso 6: Configura el enrutamiento de modelos (opcional)#
Los motores nuevos vienen preconfigurados con valores predeterminados de modelo optimizados para ofrecer calidad tanto en idiomas comunes como en idiomas con menos recursos. La mayoría de los equipos no necesita cambiarlos.
Si tienes requisitos específicos —un modelo que funcione bien para tu dominio, una limitación presupuestaria o una necesidad de cumplimiento normativo—, sobrescribe los valores predeterminados:
Set Claude Sonnet as the primary model for European language pairs,
with GPT-4o as fallback for Japanese.Cada configuración de modelo admite alternativas de respaldo ordenadas. Si el modelo principal falla (caída del servicio, límite de tasa o retirada), el motor prueba automáticamente el siguiente.
