Configurer un moteur avec le MCP de localisation

Le serveur MCP de Lingo.dev donne aux assistants de code IA un accès direct à la configuration de votre moteur de localisation. Ce guide vous montre comment configurer un moteur de localisation de A à Z : de l’installation à un moteur entièrement paramétré avec des voix de marque par langue, des termes de glossaire, des règles linguistiques et le routage des modèles.

Ce que vous allez configurer#

Les trois premiers éléments appartiennent à votre organisation, et non à un seul moteur : un glossaire, un jeu de règles ou une voix de marque sont rattachés à un moteur, ce qui permet à un second moteur de réutiliser la même configuration au lieu d’en créer une copie. Le routage des modèles, lui, reste propre au moteur.

Le résultat : une API de traduction avec état. Appelez-la dans votre code via l’API de localisation, en ligne de commande via le CLI, ou automatiquement sur chaque pull request via CI/CD. Chaque requête applique automatiquement l’ensemble des couches.

Le problème#

Chaque moteur de localisation a besoin de voix de marque par langue, de termes de glossaire, de règles linguistiques et d’un routage des modèles. Tout configurer depuis un tableau de bord prend du temps et devient vite répétitif—surtout la première fois, quand vous découvrez le rôle de chaque couche et la façon dont elles interagissent.

Le serveur MCP de Lingo.dev permet à votre assistant de code IA de prendre en charge la configuration initiale en une seule conversation. Vous lui indiquez le contenu de votre produit, et il crée le moteur, rédige les textes de voix de marque, repère les termes à ajouter au glossaire, ajoute des règles propres à chaque langue et configure le routage des modèles—le tout en une seule passe. Il vous suffit ensuite de relire le résultat et de l’affiner.

Étape 1 : Installer le MCP#

Générez une clé API depuis la section API Keys du tableau de bord Lingo.dev. Ajoutez ensuite le serveur MCP à la configuration de votre agent de code.

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

Redémarrez votre agent, puis vérifiez la connexion en lui demandant de lister vos moteurs de localisation existants. Si le MCP est actif, il renverra des résultats (ou une liste vide pour les nouvelles organisations).

Étape 2 : Configurer le moteur#

Copiez le prompt ci-dessous et collez-le dans votre assistant de code IA. Remplacez l’URL à la fin par le site web, la documentation ou le README de votre produit : l’agent a besoin d’un contenu représentatif pour déduire votre ton, votre terminologie et votre audience.

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

L’agent lit votre contenu, crée le moteur et configure toutes les couches en une seule passe. Les étapes suivantes consistent à relire et à affiner ce qu’il a produit.

Étape 3 : Affiner les voix de marque#

Relisez la voix de marque créée par l’agent. Une voix de marque comporte un texte par langue, qui définit la manière dont votre produit s’exprime dans cette langue : ton, niveau de formalité et style. L’agent les déduit à partir de votre contenu, mais ces nuances culturelles méritent d’être vérifiées.

Points à vérifier :

Voici à quoi ressemble un bon texte de voix de marque en allemand :

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 le registre n’est pas le bon, dites-le directement à votre assistant :

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

Étape 4 : Affiner le glossaire#

Relisez les termes du glossaire créés par l’agent. Le glossaire donne au moteur un contrôle précis sur certains termes—soit en imposant une traduction, soit en empêchant toute traduction. L’agent repère les termes à partir de votre contenu, mais il peut passer à côté de termes propres à votre produit ou choisir des traductions incorrectes.

Voici un glossaire typique après la première passe :

Points à vérifier :

• Termes manquants - noms de fonctionnalités produit, jargon interne que l’agent n’a pas rencontré
• Mauvaises traductions - l’agent peut choisir un synonyme qui ne correspond pas à votre usage établi
• Éléments non traduisibles manquants - noms de marque, noms de protocoles ou acronymes qui doivent rester inchangés

Les termes sont rapprochés selon leur similarité sémantique : un terme pour "Deploy" correspond aussi à "Deploying", "deployment" et "deploy your application", sans nécessiter d’entrées distinctes. Utilisez les caractères génériques * pour les termes qui s’appliquent à toutes les langues.

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

Étape 5 : Affiner les règles#

Relisez les règles créées par l’agent. Les règles sont des conventions distinctes et testables pour des langues spécifiques, regroupées dans un jeu de règles appliqué par le moteur. Contrairement à une voix de marque, qui définit le ton d’ensemble, les règles formalisent ce que les modèles génériques laissent souvent de côté : ponctuation, abréviations, largeur des caractères, formatage des nombres.

Voici à quoi ressemble un ensemble de règles typique après le premier passage :

Chaque règle traite un seul point, ce qui permet de les tester individuellement—si les abréviations allemandes posent problème, mettez à jour cette seule règle sans toucher au reste.

Points à vérifier :

• Règles manquantes - formatage des nombres, formats de date, conventions monétaires pour vos langues cibles
• Langue source - Les règles en anglais sur la virgule d’Oxford, les majuscules dans les titres ou le formatage des nombres sont souvent absentes

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

Étape 6 : Configurer le routage des modèles (facultatif)#

Les nouveaux moteurs sont préconfigurés avec des modèles par défaut optimisés pour la qualité, aussi bien pour les langues courantes que pour celles disposant de peu de ressources. La plupart des équipes n’ont pas besoin de les modifier.

Si vous avez des exigences particulières — un modèle performant pour votre domaine, une contrainte budgétaire ou un impératif de conformité — remplacez les valeurs par défaut :

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

Chaque configuration de modèle prend en charge des replis hiérarchisés. Si le modèle principal échoue (panne, limite de débit, dépréciation), le moteur essaie automatiquement le suivant.

Étapes suivantes#