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

Le serveur MCP (Model Context Protocol) de Better i18n permet aux agents de codage IA comme Claude Code et Cursor de gérer vos traductions directement — création de clés, traduction de contenu, publication et gestion des entrées de contenu.

Installation du serveur MCP

npx @better-i18n/mcp

Ou ajoutez-le à votre fichier de configuration MCP :

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp"],
      "env": {
        "BETTER_I18N_API_KEY": "sk_votre_clé_secrète"
      }
    }
  }
}

Outils disponibles

Gestion des clés de traduction

Outil	Ce qu'il fait
listProjects	Lister tous vos projets
getProject	Obtenir les détails du projet (langues, nombre de clés)
listKeys	Parcourir les clés de traduction avec des filtres
createKeys	Créer de nouvelles clés de traduction avec des valeurs
updateKeys	Mettre à jour des clés existantes ou ajouter des traductions
deleteKeys	Supprimer des clés de votre projet
publishTranslations	Envoyer les traductions vers le CDN

CMS de contenu

Outil	Ce qu'il fait
listContentModels	Lister les schémas de modèles de contenu
getContentEntry	Obtenir une entrée avec toutes ses traductions
listContentEntries	Lister les entrées avec des filtres
createContentEntry	Créer une nouvelle entrée (toutes les langues à la fois)
updateContentEntry	Mettre à jour une entrée existante
bulkUpdateEntries	Mettre à jour jusqu'à 20 entrées en un seul appel
bulkCreateEntries	Créer plusieurs entrées à la fois
publishContentEntry	Publier une entrée sur le CDN

Exemples de prompts pour agents

"Ajoute une clé de traduction common.save_button avec la valeur 'Save' et traduis-la en turc, français et espagnol"

"Trouve toutes les clés non traduites dans l'espace de noms 'auth' et traduis-les en allemand"

"Crée un article d'aide sur la prise en main de Better i18n, traduis dans toutes les langues du projet et publie"

"Vérifie si toutes les clés sont synchronisées avec le code source et corrige les manquantes"

Authentification

Le serveur MCP utilise votre clé API secrète (sk_...). Gardez-la sécurisée — ne la commitez pas dans git.

Pour Claude Code, ajoutez la clé dans votre .claude/settings.json sous env.

Pour Cursor, ajoutez-la dans les paramètres MCP sous env.

Ce que les agents peuvent et ne peuvent pas faire

Les agents utilisant le serveur MCP peuvent :

• Créer, lire, mettre à jour, supprimer des clés de traduction
• Traduire du contenu avec l'IA
• Gérer les entrées et modèles de contenu
• Publier sur le CDN de production

Les agents ne peuvent pas :

• Accéder aux paramètres de facturation ou de paiement
• Supprimer des projets ou des organisations
• Inviter des membres d'équipe
• Accéder aux données privées d'autres utilisateurs

Journalisation de l'activité MCP

Toutes les opérations MCP sont enregistrées dans le journal d'activité de votre projet avec le label « Agent » pour que vous puissiez voir ce que l'IA a fait.