Documents Intégration de l'agent

Intégration de l'agent

Configurez des agents de codage IA (Cursor, Claude Code, Windsurf, GitHub Copilot, Codex) pour gérer automatiquement la localisation – y compris l'intégration native de MCP.

Vue d'ensemble

i1n est le premier outil de localisation conçu pour l'ère des agents. Il s'intègre aux agents de codage IA à deux niveaux : des règles de contexte qui enseignent aux agents les conventions i18n de votre projet, et un serveur MCP natif qui permet aux agents d'exécuter directement les commandes i1n.

Une fois configurés, les agents utilisent automatiquement les clés de traduction au lieu des chaînes codées en dur, placent les clés dans les fichiers de namespace corrects, préservent les variables d'interpolation et peuvent pousser, traduire et extraire sans quitter l'IDE.

Règles de contexte (setup-ai)

i1n génère des règles de contexte pour Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) et Antigravity (.antigravity/rules.md).

Chaque fichier de règles est adapté au format et aux capacités spécifiques de l'agent. Exécutez i1n setup-ai pour générer tous les fichiers en une seule fois.

Serveur MCP

i1n inclut un serveur natif Model Context Protocol (MCP) qui expose 7 outils aux assistants de codage IA. Lancez-le avec `i1n mcp` et configurez votre éditeur pour vous connecter. Pour Claude Code : `claude mcp add i1n -- npx i1n mcp`. Pour Cursor : ajoutez à `.cursor/mcp.json`.

Outils MCP disponibles : i1n_status (statut et limites du projet), i1n_push (envoi de fichiers locaux), i1n_pull (récupération des traductions et génération des types), i1n_translate (traduction IA vers les langues spécifiées), i1n_add_language (ajout de nouvelles langues), i1n_extract_and_translate (extraction des chaînes, envoi, traduction et génération des types en une seule étape), et i1n_search (recherche des clés de traduction existantes).

Le flux de travail ultime : internationalisez en quelques secondes

La fonctionnalité phare est i1n_extract_and_translate. Dites à votre agent « internationaliser ce composant » — l'agent lit le fichier, identifie les chaînes codées en dur, appelle l'outil MCP avec les paires clé-valeur extraites, et i1n gère tout : la poussée des clés, la traduction dans toutes les langues actives et la régénération des définitions TypeScript. L'agent réécrit ensuite votre code avec des appels t().

Une tâche qui prend traditionnellement 60 minutes — extraction de chaînes, création d'entrées JSON, traduction, mise à jour des types — est réalisée en 30 secondes. Ce flux de travail fonctionne avec Cursor, Claude Code, Windsurf et tout assistant compatible MCP.

Flux de travail agentique

Donnez à votre agent une tâche telle que « Ajouter une page de paramètres avec les préférences de notification. Traduire en espagnol et en japonais. ». L'agent crée le composant avec les clés de traduction appropriées, puis utilise les outils MCP ou exécute la commande i1n push --translate es,ja.

L'intégralité du processus de localisation — de la création des clés à la traduction par IA — se déroule sans intervention manuelle. Ce flux de travail est pris en charge par tous les principaux agents de codage IA, à la fois par des règles de contexte et par l'intégration MCP.

terminal
i1n setup-ai
# Generates:
# .cursor/rules/i1n.mdc
# CLAUDE.md
# .windsurfrules
# .github/copilot-instructions.md
# AGENTS.md
.mcp.json
{
  "mcpServers": {
    "i1n": {
      "command": "npx",
      "args": ["i1n", "mcp"]
    }
  }
}

Associé