Collegare Crowdin a Meta Muse via MCP: traduzioni

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

Crowdin + Meta Muse

Localizzazione con Crowdin su crowdin.com e Crowdin Enterprise tramite API v2: progetti e avanzamento per lingua, file, stringhe sorgente, traduzioni e approvazioni, commenti e issue, task, report, build ed esportazioni delle traduzioni, translation memory, glossari e membri dei progetti.

Prerequisiti

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

CROWDIN_PERSONAL_ACCESS_TOKEN, CROWDIN_API_HOST

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account su crowdin.com o su Crowdin Enterprise.

1. Crea un personal access token. Su crowdin.com: Account Settings > API > New Token. Su Crowdin Enterprise: profile > Settings > API > New Token all'interno della tua organizzazione.
2. Scegli gli scope che ti servono: Projects, Source files and strings, Translations, Tasks, Reports, Translation memory, Glossaries. Con scope di sola lettura ottieni una configurazione di sola lettura. Copia il token: viene mostrato una sola volta.
3. Incollalo in CROWDIN_PERSONAL_ACCESS_TOKEN; viene inviato come Authorization: Bearer <token>.
4. CROWDIN_API_HOST: api.crowdin.com per crowdin.com, oppure <organization>.api.crowdin.com per Enterprise, con l'organizzazione presa dal tuo URL Enterprise https://<organization>.crowdin.com.
5. Installa il connettore ed esegui crowdin_get_authenticated_user: mostra l'utente a cui appartiene il token e conferma token e host.

Il server MCP di Crowdin: Crowdin gestisce anche un server MCP ufficiale (https://mcp.crowdin.com/v2/mcp, su Enterprise https://<organization>.mcp.crowdin.com/v2/mcp, con il personal access token come Bearer). Questo connettore lavora direttamente con l'API v2.

Cosa legge:

• I progetti con lingue sorgente e di destinazione, tipo (basato su file o su stringhe) e impostazioni come workflow, controlli QA, traduzione automatica e translation memory; l'avanzamento per lingua del progetto o di un singolo file; tutte le lingue supportate con il loro id Crowdin.
• Branch, directory e file sorgente, più un link di breve durata alla versione sorgente di un file (crowdin_download_file).
• Le stringhe sorgente con chiave, testo, contesto, lunghezza massima, etichette e forme plurali, filtrate per file, branch, directory, etichetta, task, una corrispondenza di testo o un'espressione CroQL.
• Le traduzioni (suggerimenti) in una lingua alla volta con autore e valutazione, e le approvazioni con chi ha approvato e quando.
• Commenti e issue sulle stringhe, per esempio richieste di contesto non risolte.
• I task con tipo, stato, lingua, assegnatari, avanzamento e scadenza; i membri del progetto con ruolo e lingue.
• Le translation memory e i loro segmenti, una ricerca per concordanza (crowdin_search_tm) su come una frase è stata tradotta in passato, i glossari e i loro termini.

Cosa scrive:

• crowdin_add_string aggiunge una stringa sorgente a un file (progetti basati su file). crowdin_edit_string la modifica con JSON Patch su /text, /identifier, /context, /isHidden, /maxLength o /labelIds; update_option decide cosa succede alle traduzioni esistenti quando il testo cambia.
• crowdin_add_translation aggiunge un suggerimento; crowdin_approve_translation lo approva, così finisce nei file esportati (servono i diritti di proofreader per quella lingua).
• crowdin_add_comment commenta una stringa o segnala un issue: una domanda, un errore di traduzione o del testo sorgente, una richiesta di contesto.
• crowdin_create_task crea un task di traduzione o di revisione per file (o stringhe nei progetti basati su stringhe) in una lingua, con assegnatari e scadenza; su Enterprise usa workflow_step_id al posto di type. crowdin_edit_task lo modifica con JSON Patch, per esempio /status a done.
• crowdin_add_tm_segment aggiunge a una translation memory la stessa frase in più lingue; crowdin_add_glossary_term aggiunge un termine, facoltativamente come traduzione di un termine esistente o in un concetto.

Report e file tradotti: i report girano in background. crowdin_generate_report restituisce data.identifier; l'AI controlla crowdin_get_report_status finché status è finished e poi recupera il link con crowdin_download_report. crowdin_export_project_translation esporta subito una lingua come un unico file. crowdin_build_project_translations costruisce tutti i file e le lingue in uno zip: l'AI controlla crowdin_get_build_status e poi chiama crowdin_download_build. I link di download scadono dopo poco (expireIn), quindi l'AI te li consegna invece di conservarli. Queste chiamate sono POST ma non modificano i contenuti.

Niente è disattivato all'installazione: non ci sono strumenti di eliminazione.

Id e formati: gli id di progetti, file, stringhe, traduzioni, task e utenti sono numeri; gli identificativi dei report sono stringhe. Le lingue usano gli id Crowdin come de, fr, es-ES, pt-BR o zh-CN. Gli orari sono ISO 8601 con offset. Gli strumenti PATCH accettano liste JSON Patch: [{"op": "replace", "path": "/status", "value": "done"}]. Le liste arrivano come {"data": [{"data": {...}}, ...], "pagination": {"offset": 0, "limit": 25}}, i singoli elementi come {"data": {...}}. L'avanzamento si conta in words e phrases, con translationProgress e approvalProgress in percentuale.

Paginazione: limit (25 di default, al massimo 500) e offset. Quando una pagina contiene limit elementi, l'AI chiede la successiva con offset + limit.

Limiti: 20 richieste contemporanee per account, sommando tutti i suoi token, su crowdin.com e su Enterprise; 429 significa aspettare.

Errori comuni: 401 indica un token sbagliato o scaduto, oppure l'host sbagliato. 403 indica un token senza lo scope o un account senza diritti nel progetto. 404 indica un id sconosciuto. 400 e 422 sono errori di validazione che nominano il campo.

Il connettore non elimina progetti, file, stringhe o traduzioni e non carica file sorgente.

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Crowdin.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "A che punto sono le traduzioni in tedesco e giapponese del nostro progetto app, tra tradotto e approvato?"
• "Quali stringhe nel file checkout hanno issue aperti che chiedono contesto?"
• "Come abbiamo tradotto "Sign in" in francese in passato? Cerca nella translation memory."
• "Crea un task di revisione per la traduzione spagnola del file di onboarding, con scadenza venerdì, e assegnalo a Maria."
• "Costruisci i file tradotti per tutte le lingue, solo con le traduzioni approvate, e dammi il link dello zip."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Microsoft Copilot