Integrazione Agente

i1n è il primo strumento di localizzazione creato per l'era degli agenti. Si integra con gli agenti di codifica AI a due livelli: regole di contesto che insegnano agli agenti le convenzioni i18n del tuo progetto e un server MCP nativo che consente agli agenti di eseguire comandi i1n direttamente.

Una volta configurati, gli agenti utilizzano automaticamente le chiavi di traduzione anziché le stringhe codificate, inseriscono le chiavi nei file di namespace corretti, preservano le variabili di interpolazione e possono eseguire push, traduzione ed estrazione senza uscire dall'IDE.

i1n genera regole di contesto per Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) e Antigravity (.antigravity/rules.md).

Ogni file di regole è personalizzato per il formato e le capacità specifiche dell'agente. Esegui i1n setup-ai per generare tutti i file contemporaneamente.

i1n include un server nativo Model Context Protocol (MCP) che espone 7 strumenti agli assistenti di codifica AI. Avvialo con i1n mcp e configura il tuo editor per la connessione. Per Claude Code: claude mcp add i1n -- npx i1n mcp. Per Cursor: aggiungi a .cursor/mcp.json.

Strumenti MCP disponibili: i1n_status (stato e limiti del progetto), i1n_push (invio file locali), i1n_pull (recupero traduzioni e generazione tipi), i1n_translate (traduzione AI nelle lingue specificate), i1n_add_language (aggiunta nuove lingue), i1n_extract_and_translate (estrazione stringhe, invio, traduzione e generazione tipi in un unico passaggio) e i1n_search (ricerca chiavi di traduzione esistenti).

La funzionalità principale è i1n_extract_and_translate. Dì al tuo agente "internazionalizza questo componente" — l'agente legge il file, identifica le stringhe hardcoded, chiama lo strumento MCP con le coppie chiave-valore estratte e i1n gestisce tutto: invio delle chiavi, traduzione in tutte le lingue attive e rigenerazione delle definizioni TypeScript. L'agente riscrive quindi il tuo codice con chiamate t().

Un'attività che tradizionalmente richiede 60 minuti —estrazione di stringhe, creazione di voci JSON, traduzione, aggiornamento dei tipi— avviene in 30 secondi. Questo flusso di lavoro funziona con Cursor, Claude Code, Windsurf e qualsiasi assistente compatibile con MCP.

Assegna al tuo agente un'attività come "Aggiungi una pagina delle impostazioni con preferenze di notifica. Traduci in spagnolo e giapponese." L'agente crea il componente con le chiavi di traduzione appropriate, quindi utilizza gli strumenti MCP o esegue i1n push --translate es,ja.

L'intero processo di localizzazione —dalla creazione delle chiavi alla traduzione AI— avviene senza intervento manuale. Questo flusso di lavoro è supportato da tutti i principali agenti di codifica AI sia tramite regole di contesto che integrazione MCP.