Comment utiliser le serveur MCP avec les agents de codage IA ?

Le serveur MCP (Model Context Protocol) Better i18n permet aux agents de codage IA de gérer directement vos traductions. Créez des clés, mettez à jour les traductions, vérifiez le statut de synchronisation — le tout avec des commandes en langage naturel depuis votre IDE.

Qu'est-ce que MCP ?

MCP est un protocole qui permet aux agents IA d'interagir avec des outils externes. En connectant le serveur MCP Better i18n, votre agent IA peut :

• Lister et rechercher des clés de traduction
• Créer de nouvelles clés avec des valeurs
• Mettre à jour les traductions dans toutes les langues
• Vérifier le statut de synchronisation et trouver les traductions manquantes
• Publier les modifications sur le CDN
• Gérer le contenu via le Content SDK

Configuration

Claude Code

Ajoutez à votre .mcp.json du projet :

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp"],
      "env": {
        "BETTER_I18N_API_KEY": "sk_..."
      }
    }
  }
}

Cursor / Windsurf

Ajoutez aux paramètres MCP de votre IDE (généralement dans Paramètres → Serveurs MCP) :

{
  "better-i18n": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Note : Utilisez une clé secrète (sk_...) pour le serveur MCP, pas une clé publique. Le serveur MCP a besoin d'un accès en écriture.

Exemples de workflows

Ajouter des clés en codant

Vous : « J'ajoute une page de paramètres. Crée des clés de traduction pour
        settings.title, settings.save_button et settings.cancel_button
        avec des valeurs en anglais. »

Agent : Utilise l'outil createKeys pour ajouter les trois clés avec leurs valeurs.

Traduire

Vous : « Traduis toutes les clés non traduites dans l'espace de noms 'settings' en turc. »

Agent : Utilise getTranslations pour trouver les lacunes, puis proposeLanguageEdits
        pour ajouter les traductions en turc.

Vérifier le statut

Vous : « Y a-t-il des clés sans traduction en turc ? »

Agent : Utilise listKeys avec un filtre de langue pour trouver les clés non traduites.

Publier

Vous : « Publie toutes les traductions en attente. »

Agent : Utilise publishTranslations pour pousser les modifications vers le CDN.

Gestion de contenu

Il existe également un serveur MCP séparé pour la gestion de contenu :

{
  "better-i18n-content": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp-content"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Cela permet de gérer des modèles de contenu structuré et des entrées — articles de blog, journaux de modifications, articles d'aide, et plus encore.

Considérations de sécurité

• Le serveur MCP s'exécute localement sur votre machine
• Votre clé API reste dans votre environnement local
• L'agent ne peut effectuer que des actions dans les permissions de votre projet
• Toutes les modifications sont auditées dans le journal d'activité du tableau de bord

Agents supportés

Tout agent compatible MCP fonctionne, notamment :

• Claude Code (CLI)
• Claude Desktop
• Cursor
• Windsurf
• Continue
• Agents personnalisés construits avec le SDK MCP

Prochaines étapes

• Documentation MCP
• Qualité de la traduction IA