El servidor MCP de Lingo.dev les da a los asistentes de programación con IA acceso directo a la configuración de tu motor de localización. En esta guía verás cómo configurar un motor de localización desde cero: desde la instalación hasta un motor totalmente configurado 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 formalidad por idioma | "du" informal para desarrolladores en alemán, tono formal y cortés para japonés |
| Glosario | Traducciones personalizadas + términos no traducibles | "Deploy" → "Bereitstellen" en alemán; "OAuth" se mantiene igual en todas partes |
| 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 respaldos | Claude Sonnet para pares europeos, GPT-4o como respaldo para japonés |
Los primeros tres pertenecen a tu organización, no a un solo motor: un glosario, un conjunto de reglas o una voz de marca se incorporan a un motor al adjuntarse, 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ámalo desde código a través de la API de localización, desde la línea de comandos con la CLI o automáticamente 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. Configurar todo esto desde un panel lleva tiempo y resulta repetitivo, especialmente la primera vez, cuando todavía estás entendiendo qué hace cada capa y cómo interactúan 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. Solo tienes que apuntarlo al contenido de tu producto, y crea el motor, redacta los textos de voz de marca, identifica términos para el glosario, agrega reglas específicas por idioma y configura el enrutamiento de modelos, todo de una sola vez. Luego 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. Luego agrega el servidor MCP a la configuración de tu agente de programación.
Agrégalo a tu .claude/settings.json o a tu .mcp.json a nivel de proyecto:
{
"lingo": {
"type": "http",
"url": "https://mcp.lingo.dev/account",
"headers": {
"x-api-key": "your_api_key"
}
}
}Alcance de la organización
La clave de API determina qué organización administra el servidor MCP. Todas las operaciones se ejecutan automáticamente dentro de esa organización; tu asistente nunca necesita especificar un ID de organización.
Reinicia tu agente y verifica la conexión pidiéndole que liste tus motores de localización existentes. Si el MCP está activo, devolverá resultados (o una lista vacía en el caso de organizaciones nuevas).
Paso 2: Configura el motor#
Copia el prompt de abajo y pégalo en tu asistente de programación con IA. Reemplaza la URL del final con el sitio web, la documentación o el README de tu producto; el agente necesita contenido representativo para inferir tu voz, terminología y 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 ejemplo. Reemplázala por un enlace a contenido que refleje la voz real de tu producto: documentación, README, flujo de onboarding o sitio 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 en una sola pasada. Los siguientes pasos se centran en revisar y ajustar lo que produjo.
Paso 3: Ajusta las voces de marca#
Revisa la voz de marca que creó el agente. Una voz de marca incluye un texto por idioma que define cómo habla tu producto en ese idioma: tono, formalidad y estilo. El agente lo infiere a partir de tu contenido, pero vale la pena revisar los matices culturales.
Qué revisar:
| Idioma | Ajuste común |
|---|---|
| Alemán | "du" (informal) vs. "Sie" (formal): depende de tu audiencia |
| Francés | "tu" (informal) vs. "vous" (formal): consumo vs. empresas |
| Japonés | Nivel de cortesía: el tono formal y cortés (です/ます) es una apuesta segura para la mayoría de los productos |
| Inglés | El texto del idioma de origen suele faltar; agrega uno para mantener la consistencia |
Así se ve un buen texto de voz de marca en alemán:
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 creó el agente. El glosario le da al motor control preciso sobre términos específicos: ya sea para imponer una traducción o para evitar que se traduzcan por completo. El agente identifica términos a partir de tu contenido, pero puede pasar por alto algunos propios de tu producto o elegir traducciones incorrectas.
Un glosario típico después de la primera pasada:
| Texto origen | Texto destino | Idioma origen | Idioma 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é revisar:
- Términos faltantes: nombres de funciones del producto o jerga interna que el agente no encontró
- Traducciones incorrectas: el agente puede elegir un sinónimo que no coincida con el uso que ya tienes establecido
- No traducibles faltantes: nombres de marca, nombres de protocolos o siglas que deben mantenerse igual
Los términos se relacionan por similitud semántica: un término para "Deploy" también coincide con "Deploying", "deployment" y "deploy your application" sin necesidad de 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 creó el agente. Las reglas son convenciones concretas y comprobables para idiomas específicos, agrupadas en un conjunto de reglas que el motor aplica. A diferencia de una voz de marca, que define el tono general, las reglas capturan lo que los modelos genéricos suelen pasar por alto: puntuación, abreviaturas, ancho de caracteres y formato de números.
Un conjunto típico de reglas después de la primera pasada:
| Idioma | Nombre | Regla |
|---|---|---|
| fr | Espaciado de 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 solo aspecto, lo que permite probarlas de forma individual. Si las abreviaturas en alemán fallan, actualiza solo esa regla sin tocar nada más.
Qué revisar:
- Reglas faltantes: formato numérico, formatos de fecha y convenciones de moneda para tus idiomas de destino
- Idioma de origen — suelen faltar reglas de inglés sobre la coma de Oxford, las mayúsculas en títulos o el formato de 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 modelos predeterminados optimizados para ofrecer calidad en idiomas comunes y de bajos recursos. La mayoría de los equipos no necesita cambiarlos.
Si tienes requisitos específicos —como un modelo que funcione bien para tu dominio, una restricción de presupuesto o una necesidad de cumplimiento—, reemplaza 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 respaldos en orden de prioridad. Si el modelo principal falla (caída del servicio, límite de tasa o desuso), el motor prueba automáticamente el siguiente.
