Lokalise MCP con Claude: task di traduzione

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Lokalise, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Lokalise + Claude

Gestione delle traduzioni con Lokalise tramite API v2: progetti con avanzamento per lingua, chiavi e traduzioni con flag di revisione, lingue, collaboratori, task di traduzione e revisione, esportazioni di file come processi in background, commenti, metadati degli screenshot, branch, stati di traduzione personalizzati e glossario.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

LOKALISE_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Lokalise con accesso ai progetti.

1. In Lokalise clicca sulla tua immagine del profilo, apri Profile settings > API tokens e genera un token. Per gli strumenti di lettura basta un token di sola lettura; le modifiche richiedono un token di lettura e scrittura.
2. Incollalo in LOKALISE_API_TOKEN. Viene inviato nell'header X-Api-Token e agisce con i tuoi diritti in ogni progetto.
3. Installa il connettore ed esegui lokalise_list_projects per verificare il token.

I server MCP di Lokalise: Lokalise gestisce anche dei server MCP in beta (https://mcp.lokalise.com/mcp/project-management e /mcp/software-development, con OAuth o un header apikey). Questo connettore lavora con l'API v2 e il tuo token.

Cosa legge:

• I progetti con tipo, lingua di base e team; con include_statistics: 1 avanzamento, chiavi, parole e problemi QA per lingua. Le lingue del progetto, tutte le lingue supportate da Lokalise con codice ISO e forme plurali, e gli stati di traduzione personalizzati.
• Le chiavi con nome per piattaforma, descrizione, tag, nomi file, contesto, limite di caratteri e, con include_translations: 1, i relativi testi. Filtri: nome della chiave, tag, nome file, piattaforma, non tradotte, problemi QA o archiviate.
• Le traduzioni, una riga per chiave e lingua, filtrate per lingua, revisionate, non verificate, non tradotte, problemi QA o task attivo.
• I collaboratori con diritti e lingue, e lokalise_get_my_contributor per il titolare del token, a nome del quale avvengono le scritture.
• I task con tipo, stato, scadenza, lingue, assegnatari e avanzamento; i file con numero di chiavi e ultimo import; i commenti per progetto o per chiave; i metadati degli screenshot con le chiavi collegate; i branch; i termini del glossario con traduzioni, tag e flag.

Cosa scrive:

• lokalise_create_keys aggiunge nuove stringhe con piattaforme e testo sorgente. lokalise_update_key e lokalise_bulk_update_keys modificano nomi, descrizioni, tag (merge_tags aggiunge invece di sostituire), piattaforme, nomi file, contesto, limiti di caratteri e traduzioni.
• lokalise_update_translation modifica un testo e i suoi flag di revisionato, non verificato o stato personalizzato. Le chiavi plurali accettano una stringa JSON con le forme (one, other, ...).
• lokalise_add_languages per codice ISO; lokalise_add_contributors, che invia email di invito; lokalise_create_task per un task translation, review o automatic_translation su alcune chiavi e lingue, assegnato a utenti o gruppi con una scadenza; lokalise_update_task, dove {"close_task": true} lo chiude.
• lokalise_add_key_comments (una domanda ai traduttori o contesto per una stringa), lokalise_create_branch, lokalise_create_glossary_terms (per esempio nomi di marchi da non tradurre, o parole vietate) e lokalise_update_glossary_terms.

Esportazione dei file: lokalise_download_files avvia un'esportazione in un formato come json, xliff, strings, xml, po o yaml e restituisce un process_id. L'AI chiama lokalise_get_process finché status è finished e ti consegna il link zip di details.download_url, che scade dopo un po'. L'esportazione è un POST ma non modifica il progetto.

Disattivato all'installazione: lokalise_delete_key, che elimina una chiave con tutte le sue traduzioni e non si può annullare. Un admin del workspace lo attiva quando serve al team.

Id e formati: gli id dei progetti hanno la forma 767946315e9866d013c1d0.08299127; per lavorare su un branch passa <project id>:<branch name>. Gli id di chiavi, traduzioni, task, lingue e utenti sono numeri. Le lingue sono codici ISO come en, de o pt_BR. Le risposte delle liste racchiudono gli elementi (projects, keys, translations, ...). Gli orari arrivano come YYYY-MM-DD HH:MM:SS (Etc/UTC) più un ..._timestamp Unix. I flag nei filtri sono 0 o 1.

Paginazione: limit e page; i totali arrivano negli header x-pagination-total-count e x-pagination-page-count, mostrati sotto _headers. Chiavi e traduzioni accettano anche pagination: cursor: l'AI passa il valore di x-pagination-next-cursor come cursor finché non manca. I termini del glossario si paginano solo con cursor.

Limiti: 6 richieste al secondo per token e per indirizzo IP, e al massimo 10 richieste contemporanee per progetto; 429 significa rallentare.

Errori comuni: 401 indica un token sbagliato. 403 indica un token di sola lettura usato per una scrittura, o diritti mancanti nel progetto. 404 indica un progetto o un elemento sconosciuto. 400 è un errore di validazione che nomina il campo; compare anche quando il valore di X-Api-Token non è un token valido, per esempio con spazi o virgolette.

Il connettore non carica file di traduzione (servirebbe contenuto in base64) né screenshot, e non elimina progetti, lingue, task o termini del glossario.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Lokalise, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Qual è l'avanzamento delle traduzioni del progetto dell'app mobile per lingua?"
• "Quali chiavi con il tag checkout non sono ancora tradotte in tedesco e francese?"
• "Esporta il progetto web come file JSON per de e it e dammi il link per scaricarli."
• "Crea un task di revisione per le traduzioni spagnole delle chiavi dell'onboarding, con scadenza venerdì prossimo."
• "Aggiungi "AnythingMCP" al glossario come nome di marchio da non tradurre."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot