VocaLingo über MCP mit Claude, ChatGPT und Cursor verbinden

Nachdem du VocaLingo verbunden hast, kann dein KI-Assistent eine Sprachnachricht mit der Stimme des Sprechers übersetzen, ein YouTube-Video zusammenfassen, einen Text mit deiner eigenen Stimme vertonen, ein Video synchronisieren oder Untertitel hinzufügen. Der Agent verbraucht Tokens von deinem normalen VocaLingo-Guthaben, und jedes Ergebnis erscheint auch im App-Verlauf: Starte eine Synchronisation am Computer und setze sie auf deinem Smartphone fort.

Serverdetails

Schritt 1. Den Bildschirm für KI-Agenten öffnen

1. Öffne VocaLingo auf iOS, Android oder web.vocalingo.app und melde dich an.

2. Gehe zu Einstellungen → KI-Agenten (MCP). Der Bildschirm heißt „VocaLingo mit deiner KI verbinden“.

3. Tippe unter „Wähle deine KI“ auf deinen Assistenten: Claude, ChatGPT, Cursor, VS Code, Claude Code oder Andere. Der Bildschirm zeigt die passenden Schritte.

Claude verbinden

Dies funktioniert für claude.ai, Claude Desktop und die mobilen Claude-Apps.

1. Tippe auf dem Bildschirm für KI-Agenten auf Claude öffnen. Das Fenster „Benutzerdefinierten Connector hinzufügen“ öffnet sich mit bereits eingetragenem Namen und Adresse.

2. Tippe auf Hinzufügen, dann auf Verbinden.

3. Claude öffnet die VocaLingo-Anmeldeseite. Melde dich wie in der App an: mit einem an deine E-Mail gesendeten Code, mit Google oder mit einem Code aus der App.

Manuell: Öffne in Claude Anpassen → Connectors → Benutzerdefinierten Connector hinzufügen, füge https://nodejs.vocalingo.app/mcp ein und tippe auf Verbinden. Danach funktioniert VocaLingo in Claude auf all deinen Geräten.

ChatGPT verbinden

1. Kopiere die Serveradresse auf dem Bildschirm für KI-Agenten.

2. Öffne chatgpt.com/plugins im Browser auf deinem Smartphone oder Computer.

3. Tippe auf + → Benutzerdefinierten MCP-Server hinzufügen.

4. Gib den Namen VocaLingo ein, füge die Adresse ein, wähle OAuth-Anmeldung, bestätige „Ich verstehe und möchte fortfahren“ und tippe auf Erstellen.

5. Melde dich auf der sich öffnenden Seite bei VocaLingo an.

Benutzerdefinierte MCP-Server sind nicht in jedem ChatGPT-Abo verfügbar.

So meldest du dich über Claude oder ChatGPT an

Die Anmeldeseite unterstützt dieselben Methoden wie die App: ein an deine E-Mail gesendeter Code oder Google. Wenn du dich in der App mit Apple anmeldest oder nicht mehr weißt, wie du dich angemeldet hast, tippe auf dem Bildschirm für KI-Agenten auf Anmeldecode anfordern. Wähle auf der Anmeldeseite „Mit Code aus der VocaLingo-App anmelden“ und gib den 8-stelligen Code ein. Der Code ist einmalig nutzbar und 10 Minuten lang gültig.

Cursor oder VS Code verbinden

1. Öffne web.vocalingo.app auf dem Computer, auf dem Cursor oder VS Code installiert ist, und melde dich an.

2. Gehe zu Einstellungen → KI-Agenten (MCP) und wähle Cursor oder VS Code.

3. Klicke auf In Cursor installieren oder In VS Code installieren. Der Editor öffnet sich und bietet an, den VocaLingo-Server hinzuzufügen: bestätige dies.

Die 1-Klick-Installation funktioniert nur auf einem Computer. Du kannst auch auf Konfiguration kopieren tippen und sie für Cursor in ~/.cursor/mcp.json einfügen oder für VS Code in mcp.json (Befehl „MCP: Open User Configuration“). Die Konfiguration enthält bereits dein Token.

Claude Code verbinden

1. Wähle auf dem Bildschirm für KI-Agenten Claude Code und tippe auf Befehl kopieren.

2. Führe ihn im Terminal aus. Er sieht so aus:

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

Starte Claude Code neu. VocaLingo erscheint in der Liste /mcp.

Andere MCP-Clients

Windsurf, Cline und jeder Client, der entfernte MCP-Server unterstützt, verbinden sich mit der Adresse https://nodejs.vocalingo.app/mcp und dem Header Authorization: Bearer vlmcp_…. Wähle Andere auf dem Bildschirm für KI-Agenten, um dein Token und eine fertige Konfiguration zu kopieren. Plugins für Claude Code, Cursor, Codex und Gemini CLI mit vorgefertigten Fähigkeiten findest du im vocalingo-mcp-Repository auf GitHub.

VocaLingo-MCP-Tools

Der Agent wählt das passende Tool anhand deiner Anfrage aus. Kostenpflichtige Tools verbrauchen VocaLingo-Tokens, die In-App-Währung.

translate_video, caption_video und change_voice benötigen eine Datei. Bei einem Link zu YouTube oder TikTok ruft der Agent zuerst download_media auf und übergibt die heruntergeladene Datei. Die Preise der kostenpflichtigen Tools entsprechen denen in der App, siehe Token-Preise für jedes Tool.

Wie der Agent nach den Kosten fragt

• Ein Vorgang, der 50 Tokens oder mehr kostet, meldet zuerst den Preis, und die Ausführung beginnt erst nach deiner Zustimmung. Der Agent kann nicht für dich bestätigen.

• Du kannst den Preis vorab erfragen: „Wie viel kostet es, dieses Video zu synchronisieren?“. Der Agent holt eine Schätzung ein, ohne etwas zu starten.

• Wiederholst du dieselbe Anfrage innerhalb von 10 Minuten, wird nichts doppelt berechnet: Der Agent greift auf denselben Auftrag zu.

• Wenn das Guthaben aufgebraucht ist, meldet der Agent „Guthaben nicht ausreichend“. Lade dein Guthaben in der App auf, siehe Tokens kaufen. Es gibt keine separate Abrechnung für MCP.

So sendest du Audio, Fotos und Videos an den Agenten

Eine hochgeladene Datei wird 48 Stunden lang gespeichert, und der Agent kann sie ohne erneuten Upload wiederverwenden. Größenbeschränkungen: bis zu 150 MB für translate_audio, 50 MB für speech_to_text und save_voice, 100 MB für Video-Tools und change_voice, 20 MB für Bilder.

Wenn du den Text auf einem Foto nur lesen oder übersetzen lassen möchtest, erledigen Claude und ChatGPT das selbst kostenlos. translate_image ist dafür gedacht, wenn du das Bild selbst mit neu eingefügtem Text haben möchtest.

Längere Aufträge

Tools mit längerer Laufzeit warten etwa 25 Sekunden und liefern das Ergebnis zurück, falls es fertig ist. Andernfalls erhält der Agent eine jobId und prüft sie mit check_job. Das Synchronisieren kann bis zu 30 Minuten dauern. Wenn du den Chat während eines Auftrags geschlossen hast, bitte den Agenten, check_job ohne jobId aufzurufen: Dadurch werden die letzten Aufträge aufgelistet. Links zu Ergebnisdateien sind 24 Stunden lang gültig; die Ergebnisse selbst bleiben im Verlauf der App gespeichert (ohne Premium die letzten 3 Einträge pro Tool).

Zugriff, Token und Deaktivierung

Jeder, der dein Token hat, kann Tokens von deinem Guthaben verbrauchen, halte es daher geheim. Der Bereich Zugriff und Tokens auf dem Bildschirm für KI-Agenten bietet zwei Aktionen:

• Neues Token erstellen: Das alte Token wird innerhalb einer Minute ungültig. Ersetze es in den per Token verbundenen Agenten.

• MCP-Zugriff deaktivieren: Alle Agenten verlieren innerhalb einer Minute den Zugriff, einschließlich der Connectors für Claude und ChatGPT. Um sie wieder zu verbinden, tippe auf MCP-Zugriff aktivieren, woraufhin ein neues Token ausgestellt wird.

Klone nur deine eigene Stimme oder eine Stimme, für die du eine ausdrückliche Erlaubnis hast. Dieselbe Regel gilt auch in der App.

Häufig gestellte Fragen