Localizzazione mentre il tuo agente di codifica scrive
Il server MCP di localize.dev e un hook post-modifica consentono a Claude Code, Cursor e altri agenti di tradurre il nuovo testo dell'interfaccia utente nello stesso commit in cui viene aggiunto.
Stephen Ufort · 11 novembre 2026 · 3 min di lettura

Gli agenti di codifica scrivono rapidamente il testo dell'interfaccia utente e quasi tutto è in inglese hardcoded. Un'app completamente localizzata il mese scorso può avere dozzine di stringhe non tradotte questo mese, e nessuno le ha digitate manualmente.
localize.dev fornisce agli agenti lo stesso motore usato dalla CLI, come server MCP, più un hook che informa l'agente quando un file appena modificato contiene testo non tradotto. Questo post spiega come si integrano i due.
Cinque strumenti
Il server MCP ha cinque strumenti. Due di essi sono gratuiti e non richiedono chiave:
check: copia hardcoded e traduzioni mancanti o obsolete, ciascuna con il suo file e linea. Passapathsper controllare solo i file modificati dall'agente.config: le convenzioni dell'app per la scrittura di testi dell'interfaccia utente, in modo che il nuovo codice chiamit()nello stesso modo del resto dell'app.localize: fornisce chiavi di testo hardcoded, riscrive il codice e traduce i nuovi messaggi.translate: riempie le traduzioni mancanti nei file di localizzazione.add_language: aggiunge una lingua alla configurazione e traduce ogni messaggio in essa.
Esegui localmente con npx -y localize-dev mcp, così la riscrittura del codice avviene sulla tua macchina. Costruttori di browser come Lovable, Bolt e v0 non possono avviare un processo locale, quindi si connettono al server ospitato a https://uselocalize.dev/api/mcp con OAuth o una chiave API.
Il hook che chiude il ciclo
Uno strumento MCP aiuta solo se l'agente ricorda di chiamarlo. In Claude Code, un hook post-modifica assicura che lo faccia. Dopo ogni modifica o scrittura, il hook esegue check sul file appena modificato dall'agente. Se il file è codice UI senza testo tradotto, il hook termina con codice 2, e Claude Code mostra il suo messaggio all'agente:
localize.dev: src/components/SignIn.tsx has UI text that isn't translated yet.
line 9: "We'll email you a 6-digit code. No password needed."
Call the localize tool of the localize-dev MCP server with paths ["components/SignIn.tsx"]: it gives this text translation keys, rewrites the code and translates it.
Without the MCP server, run in the project folder: npx localize-dev run --files src/components/SignIn.tsxL'agente chiama quindi localize con quel percorso. La frase ottiene una chiave, la riga viene riscritta per chiamare t() e il nuovo messaggio viene tradotto in ogni lingua disponibile nell'app, nello stesso cambiamento del codice che l'agente stava scrivendo.
Il hook non interferisce mai con l'agente. Un file che non è codice UI, un file pulito, e qualsiasi errore nel hook stesso escono tutti con codice 0 e non stampano nulla. Imposta LOCALIZE_DEV_HOOK=off per disattivarlo in una sessione.
Configurazione
Un comando aggiunge tutto al repository:
npx localize-dev init --agent- Il server MCP in
.mcp.jsonper Claude Code e.cursor/mcp.jsonper Cursor. - Il hook post-modifica in
.claude/settings.json, su Modifica, MultiModifica e Scrivi. - Una sezione in
AGENTS.mdeCLAUDE.md, e una regola Cursor per i file UI dell'app, che dice all'agente di localizzare mentre scrive e di eseguirecheckprima di finire.
Aggiunge solo a ciò che è presente. I tuoi altri server, hook e istruzioni rimangono, e eseguirlo di nuovo sostituisce la propria sezione invece di aggiungerne una seconda. Aggiungi --pre-commit per controllare anche i file in staging prima di ogni commit, per modifiche fatte senza un agente.
Perché non chiedere semplicemente all'agente
Puoi chiedere a un agente di estrarre e tradurre le stringhe senza tutto ciò, e per un file funziona spesso. In un'intera app, le chiavi si spostano tra i file, le forme plurali che l'agente non ha considerato vanno perse, e niente rileva la prossima frase non tradotta. Il server MCP fornisce all'agente lo stesso registro di chiavi, gli stessi controlli di traduzione e lo stesso controllo CI di una corsa completa.
Provalo sul tuo codice nell'area di gioco, non è necessario un account