Verbind VocaLingo met Claude, ChatGPT en Cursor via MCP

Nadat je VocaLingo hebt verbonden, kan je AI-assistent een spraakbericht vertalen in de stem van de spreker, een YouTube-video samenvatten, een tekst inspreken met je eigen stem, een video nasynchroniseren of ondertitels toevoegen. De agent gebruikt tokens van je reguliere VocaLingo-saldo, en elk resultaat verschijnt ook in de appgeschiedenis: start een nasynchronisatie vanaf je computer en bekijk het resultaat op je telefoon.

Servergegevens

Stap 1. Open het scherm voor AI-agents

1. Open VocaLingo op iOS, Android of web.vocalingo.app en log in.

2. Ga naar Instellingen → AI-agents (MCP). Het scherm heet “Verbind VocaLingo met je AI”.

3. Tik onder “Kies je AI” op je assistent: Claude, ChatGPT, Cursor, VS Code, Claude Code of Overig. Het scherm toont de bijbehorende stappen.

Claude verbinden

Dit werkt voor claude.ai, Claude Desktop en de mobiele apps van Claude.

1. Tik in het scherm voor AI-agents op Open Claude. Het venster “Aangepaste connector toevoegen” opent met de naam en het adres al ingevuld.

2. Tik op Toevoegen en vervolgens op Verbinden.

3. Claude opent de inlogpagina van VocaLingo. Log op dezelfde manier in als in de app: met een code via je e-mail, via Google, of met een code uit de app.

Handmatig: open in Claude Aanpassen → Connectors → Aangepaste connector toevoegen, plak https://nodejs.vocalingo.app/mcp en tik op Verbinden. Daarna werkt VocaLingo in Claude op al je apparaten.

ChatGPT verbinden

1. Kopieer het serveradres in het scherm voor AI-agents.

2. Open chatgpt.com/plugins in een browser, op je telefoon of computer.

3. Tik op + → Aangepaste MCP-server toevoegen.

4. Voer de naam VocaLingo in, plak het adres, kies OAuth-inloggen, bevestig “Ik begrijp het en wil doorgaan” en tik op Maken.

5. Log in bij VocaLingo op de pagina die opent.

Aangepaste MCP-servers zijn niet op elk abonnement van ChatGPT beschikbaar.

Hoe je inlogt vanuit Claude of ChatGPT

De inlogpagina ondersteunt dezelfde methoden als de app: een code die naar je e-mail wordt gestuurd, of Google. Als je inlogt op de app met Apple of niet meer weet hoe je bent ingelogd, tik dan op Vraag een inlogcode aan in het scherm voor AI-agents. Kies op de inlogpagina “Inloggen met een code uit de VocaLingo-app” en voer de code van 8 tekens in. De code werkt één keer en is 10 minuten geldig.

Cursor of VS Code verbinden

1. Open web.vocalingo.app op de computer waarop Cursor of VS Code is geïnstalleerd en log in.

2. Ga naar Instellingen → AI-agents (MCP) en kies Cursor of VS Code.

3. Klik op Installeren in Cursor of Installeren in VS Code. De editor opent en vraagt om de VocaLingo-server toe te voegen: bevestig dit.

Installatie met één klik werkt alleen op een computer. Je kunt ook op Configuratie kopiëren tikken en deze plakken in ~/.cursor/mcp.json voor Cursor, of in mcp.json voor VS Code (opdracht “MCP: Open User Configuration”). De configuratie bevat je token al.

Claude Code verbinden

1. Kies in het scherm voor AI-agents Claude Code en tik op Opdracht kopiëren.

2. Voer deze uit in de terminal. Het ziet er zo uit:

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

Herstart Claude Code. VocaLingo verschijnt in de lijst van /mcp.

Andere MCP-clients

Windsurf, Cline en elke client die externe MCP-servers ondersteunt, verbinden via het adres https://nodejs.vocalingo.app/mcp en de header Authorization: Bearer vlmcp_…. Kies Overig in het scherm voor AI-agents om je token en een kant-en-klare configuratie te kopiëren. Plug-ins voor Claude Code, Cursor, Codex en Gemini CLI met kant-en-klare skills vind je in de vocalingo-mcp repository op GitHub.

VocaLingo MCP-tools

De agent kiest de juiste tool aan de hand van je verzoek. Betaalde tools kosten VocaLingo-tokens, het tegoed binnen de app.

translate_video, caption_video en change_voice hebben een bestand nodig. Bij een link naar YouTube of TikTok roept de agent eerst download_media aan en geeft het gedownloade bestand vervolgens door. Prijzen van betaalde tools zijn hetzelfde als in de app, zie tokenprijzen voor elke tool.

Hoe de agent naar de kosten vraagt

• Een bewerking die 50 tokens of meer kost, geeft eerst de prijs aan. De taak start pas nadat je akkoord gaat. De agent kan dit niet voor jou bevestigen.

• Je kunt vooraf naar de prijs vragen: “Hoeveel kost het om deze video na te synchroniseren?”. De agent haalt een schatting op zonder iets te starten.

• Als je hetzelfde verzoek binnen 10 minuten herhaalt, wordt dit niet dubbel in rekening gebracht: de agent haalt dezelfde taak op.

• Als het saldo op is, meldt de agent “onvoldoende saldo”. Waardeer op in de app, zie hoe je tokens koopt. Er is geen aparte facturering voor MCP.

Audio, foto's en video's naar de agent sturen

Een geüpload bestand wordt 48 uur bewaard, en de agent kan het opnieuw gebruiken zonder opnieuw te uploaden. Maximale bestandsgroottes: tot 150 MB voor translate_audio, 50 MB voor speech_to_text en save_voice, 100 MB voor videotools en change_voice, 20 MB voor afbeeldingen.

Als je alleen tekst op een foto wilt lezen of vertalen, doen Claude en ChatGPT dat zelf gratis. translate_image is bedoeld voor wanneer je de afbeelding zelf wilt behouden met de opnieuw ingetekende tekst.

Langdurige taken

Langdurige tools wachten ongeveer 25 seconden en geven het resultaat direct terug als het klaar is. Anders ontvangt de agent een jobId en controleert deze met check_job. Nasynchronisatie kan tot 30 minuten duren. Als je de chat tijdens een taak hebt gesloten, vraag de agent dan om check_job aan te roepen zonder jobId: dit geeft een lijst met recente taken. Links naar resultaatbestanden zijn 24 uur geldig; de resultaten zelf blijven bewaard in de geschiedenis van de app (zonder Premium de laatste 3 items per tool).

Toegang, token en uitschakelen

Iedereen die jouw token heeft, kan tokens van je saldo verbruiken, dus houd deze geheim. Het onderdeel Toegang en tokens in het scherm voor AI-agents bevat twee acties:

• Nieuw token aanmaken: het oude token stopt binnen een minuut met werken. Werk dit bij in de agents die via een token zijn verbonden.

• MCP-toegang uitschakelen: alle agents verliezen binnen een minuut de toegang, inclusief de connectors voor Claude en ChatGPT. Om opnieuw verbinding te maken, tik je op MCP-toegang inschakelen, waarna er een nieuw token wordt aangemaakt.

Kloon alleen je eigen stem of een stem waarvoor je uitdrukkelijke toestemming hebt gekregen. Dezelfde regel geldt in de app.

Veelgestelde vragen