Configuração do motor com o MCP de localização

O servidor MCP da Lingo.dev dá aos assistentes de programação com IA acesso direto à configuração do seu motor de localização. Este guia mostra-lhe como configurar um motor de localização de raiz — desde a instalação até um motor totalmente configurado, com vozes da marca por idioma, termos de glossário, regras linguísticas e encaminhamento de modelos.

O que vai configurar#

Os primeiros três pertencem à sua organização, não a um motor: um glossário, um conjunto de regras ou uma voz da marca chegam a um motor por associação, o que permite a um segundo motor aplicar a mesma configuração em vez de uma cópia. O encaminhamento de modelos continua a pertencer ao motor.

O resultado é uma API de tradução com estado. Pode chamá-la a partir do código através da API de localização, da linha de comandos através da CLI, ou automaticamente em cada pull request através de CI/CD. Cada pedido aplica automaticamente todas as camadas.

O problema#

Cada motor de localização precisa de vozes da marca por idioma, termos de glossário, regras linguísticas e encaminhamento de modelos. Configurar tudo isto num painel de controlo é moroso e repetitivo — sobretudo da primeira vez, quando ainda está a perceber o papel de cada camada e como se articulam entre si.

O servidor MCP da Lingo.dev permite que o seu assistente de programação com IA trate da configuração inicial numa única conversa. Basta apontá-lo para o conteúdo do seu produto e ele cria o motor, escreve os textos da voz da marca, identifica termos para o glossário, adiciona regras específicas de cada idioma e configura o encaminhamento de modelos — tudo de uma só vez. Depois, só tem de fazer a revisão do resultado e ajustá-lo a partir daí.

Passo 1: Instalar o MCP#

Gere uma chave de API na secção API Keys do dashboard da Lingo.dev. Em seguida, adicione o servidor MCP à configuração do seu agente de programação.

{
  "lingo": {
    "type": "http",
    "url": "https://mcp.lingo.dev/account",
    "headers": {
      "x-api-key": "your_api_key"
    }
  }
}

Reinicie o seu agente e verifique a ligação pedindo-lhe para listar os motores de localização existentes. Se o MCP estiver ativo, devolve resultados (ou uma lista vazia, no caso de organizações novas).

Passo 2: Configurar o motor#

Copie o prompt abaixo e cole-o no seu assistente de programação com IA. Substitua o URL no fim pelo website, documentação ou README do seu produto — o agente precisa de conteúdo representativo para inferir a sua voz, terminologia e público.

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.com

O agente lê o seu conteúdo, cria o motor e configura todas as camadas de uma só vez. Os próximos passos focam-se na revisão e no ajuste do que foi gerado.

Passo 3: Ajustar a voz da marca#

Faça a revisão da voz da marca que o agente criou. Uma voz da marca inclui um texto por idioma, que define como o seu produto comunica nessa língua — tom, formalidade e estilo. O agente infere estes elementos a partir do seu conteúdo, mas vale a pena confirmar as nuances culturais.

O que verificar:

Um texto de voz da marca em alemão, bem configurado, tem este aspeto:

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).

Se o registo estiver errado, diga-o diretamente ao seu assistente:

The German brand voice is too informal for our enterprise docs.
Switch it to formal "Sie" register.

Passo 4: Ajustar o glossário#

Faça a revisão dos termos do glossário que o agente criou. O glossário dá ao motor controlo rigoroso sobre termos específicos — quer para impor uma tradução, quer para impedir totalmente a tradução. O agente identifica termos a partir do seu conteúdo, mas pode não detetar alguns termos específicos do produto ou escolher traduções incorretas.

Um glossário típico após a primeira passagem:

O que verificar:

• Termos em falta — nomes de funcionalidades do produto, jargão interno que o agente não encontrou
• Traduções erradas — o agente pode escolher um sinónimo que não corresponde ao uso já estabelecido
• Não traduzíveis em falta — nomes de marcas, nomes de protocolos ou acrónimos que devem manter-se inalterados

Os termos são associados por semelhança semântica — um termo para "Deploy" também corresponde a "Deploying", "deployment" e "deploy your application", sem precisar de entradas separadas. Utilize os wildcards * para termos que se aplicam a todos os idiomas.

Add a glossary term: 'checkout' should stay as 'Checkout' in
German - it's our product feature name, not the shopping action.

Passo 5: Ajustar as regras#

Faça a revisão das regras que o agente criou. As regras são convenções específicas, discretas e testáveis para determinados idiomas, agrupadas num conjunto de regras que o motor aplica. Ao contrário da voz da marca, que define o tom geral, as regras codificam o que os modelos genéricos tendem a falhar — pontuação, abreviaturas, largura de caracteres, formatação de números.

Um conjunto típico de regras após a primeira passagem:

Cada regra trata de uma questão específica, o que permite testá-las individualmente — se as abreviaturas em alemão falharem, atualize apenas essa regra sem mexer em mais nada.

O que verificar:

• Regras em falta — formatação de números, formatos de data, convenções monetárias para os seus idiomas de destino
• Idioma de origem — muitas vezes faltam regras em inglês para vírgula de Oxford, capitalização em estilo título ou formatação de números

In French, there should always be a non-breaking space before
colons and semicolons. Add that as a rule for fr.

Passo 6: Configurar o encaminhamento de modelos (opcional)#

Os novos motores vêm pré-configurados com predefinições de modelo otimizadas para qualidade em línguas comuns e em línguas com menos recursos. A maioria das equipas não precisa de as alterar.

Se tiver requisitos específicos — um modelo com bom desempenho no seu domínio, uma restrição orçamental ou uma necessidade de conformidade — substitua as predefinições:

Set Claude Sonnet as the primary model for European language pairs,
with GPT-4o as fallback for Japanese.

Cada configuração de modelo suporta alternativas ordenadas. Se o modelo principal falhar (interrupção, limite de taxa, descontinuação), o motor tenta automaticamente o seguinte.

Próximos passos#