localize.dev

Documenti / Agenti / Lovable

Localizza un'app Lovable

Collega Lovable al server MCP localize.dev ospitato, e il suo agente troverà il testo hardcoded nella tua app, gli darà delle chiavi, imposterà react-i18next e lo tradurrà. Le traduzioni rimangono nel tuo codice come file di localizzazione, senza script o proxy davanti al sito.

Come funziona

Lovable viene eseguito nel browser, quindi non può avviare npx. Si connette invece al server ospitato su https://uselocalize.dev/api/mcp: l'agente invia i file di cui uno strumento ha bisogno e riscrive i file restituiti.

Il connettore appartiene al tuo account Lovable, non all'app, quindi la tua chiave API non fa mai parte del sito pubblicato. check e config non utilizzano la tua quota; localize, translate e add_language sì.

Configuralo

Crea prima una chiave API nella dashboard. Crea una chiave

  1. In Connettori, scegli Aggiungi personalizzato, quindi server MCP e inserisci l'URL.
  2. Scegli token Bearer o chiave API, incolla la tua chiave API localize.dev e fai clic su Aggiungi server.
  3. Apri il tuo progetto e chiedi qualcosa come il prompt qui sotto. L'agente invia i file di cui lo strumento ha bisogno e riscrive i file che restituisce.
Connectors → Add custom → MCP server
Name            localize
URL             https://uselocalize.dev/api/mcp
Authentication  Bearer token or API key
Key             ldv_live_… (your localize.dev API key)

Cosa ottieni

Dove va il server
Connectors → Add custom → MCP server
Server
Il server ospitato su https://uselocalize.dev/api/mcp
Chiave
La tua chiave API localize.dev, come token bearer
Cosa aggiunge init --agent
Niente: un browser builder non può eseguire npx, quindi si connette al server ospitato.

Buono a sapersi

  • Chiedi prima un controllo. Elenca il testo hardcoded e le traduzioni mancanti file per file, in modo da poter scegliere le pagine da localizzare.
  • Se il progetto viene sincronizzato con GitHub, l'azione GitHub di localize.dev può anche tradurre ogni push e aprire una pull request con le chiavi e le traduzioni.

Provalo

Chiedi qualcosa del genere. L'agente dovrebbe chiamare lo strumento check.

“Controlla questa app per il testo hardcoded e dimmi cosa non è stato tradotto.”

Mantienilo tradotto

Il testo che l'agente lascia hardcoded viene comunque rilevato: npx localize-dev check in CI fallisce una pull request che aggiunge testo non tradotto e non necessita di una chiave.

npx localize-dev check

Tutti gli agenti e il riferimento allo strumento si trovano nella pagina del server MCP.

Guide del framework