Collega VocaLingo a Claude, ChatGPT e Cursor tramite MCP

Dopo aver collegato VocaLingo, il tuo assistente IA può tradurre un messaggio vocale con la voce di chi parla, riassumere un video di YouTube, doppiare un testo con la tua stessa voce, doppiare un video o aggiungere sottotitoli. L'agente spende i gettoni del tuo normale saldo di VocaLingo, e ogni risultato compare anche nella cronologia dell'app: inizia un doppiaggio dal computer e riprendilo sul telefono.

Dettagli del server

Passaggio 1. Apri la schermata degli agenti IA

1. Apri VocaLingo su iOS, Android o web.vocalingo.app ed effettua l'accesso.

2. Vai su Impostazioni → Agenti IA (MCP). La schermata si intitola "Collega VocaLingo alla tua IA".

3. Sotto "Scegli la tua IA", tocca il tuo assistente: Claude, ChatGPT, Cursor, VS Code, Claude Code o Altro. La schermata mostrerà i passaggi necessari.

Collega Claude

Funziona per claude.ai, Claude Desktop e le app mobili di Claude.

1. Nella schermata degli agenti IA tocca Apri Claude. Si aprirà la finestra "Aggiungi connettore personalizzato" con nome e indirizzo già compilati.

2. Tocca Aggiungi, poi Connetti.

3. Claude aprirà la pagina di accesso di VocaLingo. Accedi come fai nell'app: con un codice inviato alla tua email, con Google o con un codice dall'app.

Manualmente: in Claude apri Personalizza → Connettori → Aggiungi connettore personalizzato, incolla https://nodejs.vocalingo.app/mcp e tocca Connetti. Dopodiché VocaLingo funzionerà in Claude su tutti i tuoi dispositivi.

Collega ChatGPT

1. Copia l'indirizzo del server nella schermata degli agenti IA.

2. Apri chatgpt.com/plugins in un browser, sul telefono o sul computer.

3. Tocca + → Aggiungi server MCP personalizzato.

4. Inserisci il nome VocaLingo, incolla l'indirizzo, scegli l'accesso tramite OAuth, conferma "Ho capito e voglio continuare" e tocca Crea.

5. Accedi a VocaLingo nella pagina che si apre.

I server MCP personalizzati non sono disponibili su tutti i piani di ChatGPT.

Come accedere da Claude o ChatGPT

La pagina di accesso accetta gli stessi metodi dell'app: un codice inviato alla tua email o Google. Se accedi all'app con Apple o non ricordi come hai effettuato l'accesso, tocca Ottieni un codice di accesso nella schermata degli agenti IA. Nella pagina di accesso scegli "Accedi con un codice dall'app VocaLingo" e inserisci il codice di 8 caratteri. Il codice è monouso ed è valido per 10 minuti.

Collega Cursor o VS Code

1. Apri web.vocalingo.app sul computer in cui è installato Cursor o VS Code ed effettua l'accesso.

2. Vai su Impostazioni → Agenti IA (MCP) e scegli Cursor o VS Code.

3. Fai clic su Installa in Cursor o Installa in VS Code. L'editor si aprirà proponendo di aggiungere il server VocaLingo: conferma.

L'installazione con un clic funziona solo su computer. Puoi anche toccare Copia configurazione e incollarla in ~/.cursor/mcp.json per Cursor, o in mcp.json per VS Code (comando "MCP: Apri configurazione utente"). La configurazione contiene già il tuo token.

Collega Claude Code

1. Nella schermata degli agenti IA scegli Claude Code e tocca Copia comando.

2. Eseguilo nel terminale. Ha questo aspetto:

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

Riavvia Claude Code. VocaLingo comparirà nell'elenco /mcp.

Altri client MCP

Windsurf, Cline e qualsiasi client che supporti server MCP remoti si collegano con l'indirizzo https://nodejs.vocalingo.app/mcp e l'intestazione Authorization: Bearer vlmcp_…. Scegli Altro nella schermata degli agenti IA per copiare il tuo token e una configurazione pronta. I plugin per Claude Code, Cursor, Codex e Gemini CLI con abilità già pronte sono disponibili nel repository vocalingo-mcp su GitHub.

Strumenti MCP di VocaLingo

L'agente sceglie lo strumento in base alla tua richiesta. Gli strumenti a pagamento consumano i gettoni di VocaLingo, la valuta interna all'app.

translate_video, caption_video e change_voice richiedono un file. Per un link di YouTube o TikTok l'agente chiama prima download_media e passa il file scaricato. I prezzi degli strumenti a pagamento sono gli stessi dell'app, consulta i prezzi in gettoni per ciascuno strumento.

Come l'agente chiede conferma per i costi

• Un'operazione che costa 50 gettoni o più mostra prima il prezzo, e l'attività inizia solo dopo la tua conferma. L'agente non può confermare al posto tuo.

• Puoi chiedere il prezzo in anticipo: "Quanto costerà doppiare questo video?". L'agente otterrà una stima senza avviare nulla.

• Ripetere la stessa richiesta entro 10 minuti non comporta un doppio addebito: l'agente recupera la stessa attività.

• Se il saldo si esaurisce, l'agente segnala "saldo insufficiente". Ricarica nell'app, consulta come acquistare gettoni. Non esiste una fatturazione separata per MCP.

Come inviare audio, foto e video all'agente

Un file caricato viene conservato per 48 ore, e l'agente può riutilizzarlo senza doverlo ricaricare. Limiti di dimensione: fino a 150 MB per translate_audio, 50 MB per speech_to_text e save_voice, 100 MB per gli strumenti video e change_voice, 20 MB per le immagini.

Se hai solo bisogno di leggere o tradurre il testo su una foto, Claude e ChatGPT possono farlo da soli gratuitamente. translate_image serve quando vuoi ottenere l'immagine stessa con il testo riscritto graficamente.

Attività lunghe

Gli strumenti per operazioni lunghe attendono circa 25 secondi e restituiscono il risultato se pronto. In caso contrario l'agente riceve un jobId e ne controlla l'avanzamento con check_job. Il doppiaggio può richiedere fino a 30 minuti. Se hai chiuso la chat durante un'attività, chiedi all'agente di chiamare check_job senza un jobId: elencherà le attività recenti. I link ai file dei risultati sono validi per 24 ore; i risultati rimangono comunque nella cronologia dell'app (senza Premium, gli ultimi 3 elementi per ciascuno strumento).

Accesso, token e come disattivarlo

Chiunque abbia il tuo token può spendere gettoni dal tuo saldo, quindi tienilo al sicuro. La sezione Accesso e token nella schermata degli agenti IA offre due opzioni:

• Crea un nuovo token: il vecchio token smette di funzionare entro un minuto. Sostituiscilo negli agenti collegati tramite token.

• Disattiva l'accesso MCP: tutti gli agenti perdono l'accesso entro un minuto, inclusi i connettori di Claude e ChatGPT. Per collegarli di nuovo, tocca Attiva l'accesso MCP e verrà emesso un nuovo token.

Clona solo la tua voce o una voce per cui hai un'autorizzazione esplicita. La stessa regola vale all'interno dell'app.

Domande frequenti