YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools
How the Model Context Protocol works, how to connect the GetYouTubeTranscript MCP server to Claude Desktop, Claude Code, Cursor, Windsurf, or ChatGPT, and how to troubleshoot the connection.
00:08:00 · SEP 13, 2026
Kurzantwort
Was MCP eigentlich ist
Das Model Context Protocol standardisiert, wie ein KI-Client externe Tools entdeckt und aufruft. Im Hintergrund handelt es sich um JSON-RPC 2.0 – der Client fragt den Server, welche Tools existieren und wie ihre Eingabeschemas aussehen, ruft sie dann namentlich mit strukturierten Argumenten auf und erhält ein strukturiertes Ergebnis zurück, alles innerhalb desselben Gesprächsschritts.
MCP-Server laufen über einen von zwei Transportwegen: stdio, bei dem der Client den Server als lokalen Subprozess startet (typisch für Tools, die lokalen Dateisystemzugriff benötigen), oder Streamable HTTP, bei dem der Server remote ist und über HTTPS von beliebig vielen Clients gleichzeitig erreicht werden kann – genau das verwendet dieser Server. (Ein älterer HTTP+SSE-Transport existiert in mancher Dokumentation, ist aber zugunsten von Streamable HTTP veraltet.) Praktisch bedeutet das: Sie führen nie etwas lokal aus, um diesen Server zu nutzen – richten Sie Ihren Client einfach auf die URL.
Verfügbare Tools
| Tool | Was es tut | Kosten |
|---|---|---|
get_youtube_transcript | Vollständiges Transkript plus Titel, Autor und Thumbnail-Metadaten | 1 Credit |
search_youtube | YouTube nach Videos oder Kanälen durchsuchen, paginiert | 1 Credit |
get_channel_latest_videos | Metadaten eines Kanals plus seine neuesten Uploads | Kostenlos |
search_channel_videos | Innerhalb eines Kanals nach einer Suchanfrage suchen, paginiert | 1 Credit |
list_channel_videos | Listet jedes von einem Kanal hochgeladene Video auf, paginiert | 1 Credit |
list_playlist_videos | Ruft jedes Video einer Playlist ab, paginiert | 1 Credit |
Die paginierten Tools (search, list-channel, list-playlist) akzeptieren alle ein continuation-Token aus einer vorherigen Antwort, um die nächste Seite abzurufen, statt eines Offset/Limit-Paars.
Einen API-Schlüssel holen
Melden Sie sich über das Dashboard an und erstellen Sie einen API-Schlüssel – 100 Credits sind kostenlos inbegriffen, keine Karte erforderlich. Dieser Schlüssel ist der Bearer-Token, mit dem sich der MCP-Server bei den meisten Clients authentifiziert.
Den Server zu Claude Desktop oder Claude Code hinzufügen
Fügen Sie dies zur Konfiguration Ihres MCP-Clients hinzu (z. B. claude_desktop_config.json, oder über claude mcp add für Claude Code):
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}Ersetzen Sie sk_live_... durch Ihren eigenen API-Schlüssel. Starten Sie den Client vollständig neu, dann erscheinen die 6 oben genannten Tools automatisch – die meisten Clients lesen diese Konfiguration nur beim Start, nicht bei einem Hot-Reload.
Andere Clients: Cursor, Windsurf und eigene Agenten
Jeder Client, der einen entfernten MCP-Server über Streamable HTTP mit benutzerdefinierten Headern unterstützt, verwendet dieselbe Konfigurationsform – nur die umgebende Datei und die Feldnamen unterscheiden sich (z. B. Cursors .cursor/mcp.json, Windsurfs MCP-Einstellungsbereich). Unterstützt ein Client nur OAuth-basierte Server statt eines statischen Bearer-Headers, verwenden Sie stattdessen den unten beschriebenen OAuth-Ablauf.
ChatGPT-Konnektoren und reine OAuth-Clients
Für Clients, die MCP-Server per OAuth statt eines eingefügten API-Schlüssels authentifizieren (zum Beispiel ChatGPTs benutzerdefinierte Konnektoren), unterstützt dieser Server auch OAuth 2.1 mit Dynamic Client Registration – richten Sie den Client einfach auf dieselbe Server-URL, und er entdeckt die OAuth-Metadaten und führt Sie durch einen Autorisierungsablauf, statt direkt nach einem Bearer-Token zu fragen.
Ihn bitten, ein Tool zu verwenden
Einmal verbunden, genügen natürliche Prompts – das Modell entscheidet, welches Tool es aufruft:
- "Hol das Transkript für youtube.com/watch?v=dQw4w9WgXcQ und fasse es in 3 Stichpunkten zusammen."
- "Durchsuche YouTube nach 'Next.js server actions' und liste die Top 5 Ergebnisse auf."
- "Liste jedes Video auf, das @mkbhd hochgeladen hat, und finde die, die 'battery' erwähnen."
Fehlerbehebung
Bauen Sie einen eigenen Agenten statt einen Chat-Client zu verwenden? Derselbe Server funktioniert mit jedem MCP-kompatiblen Client über Streamable HTTP. Die vollständige REST-Endpunktreferenz, Credits und Rate-Limits finden Sie in der API-Dokumentation.
FAQs zum MCP-Server
Was ist ein MCP-Server, und warum sollte ich einen für YouTube-Transkripte nutzen?
MCP (Model Context Protocol) erlaubt einem KI-Assistenten wie Claude, während eines Gesprächs direkt externe Tools aufzurufen. Statt ein Transkript in den Chat einzufügen, bitten Sie Claude, es abzurufen – es ruft das Tool auf, erhält das Transkript zurück und kann es im selben Gesprächsschritt zusammenfassen, übersetzen oder durchsuchen.
Ist MCP dasselbe wie ein einfacher REST-API-Wrapper?
Nein. MCP standardisiert Tool-Entdeckung und -Aufruf über jeden konformen Client hinweg – derselbe Server funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf oder einem eigenen Agenten, ohne clientspezifischen Verbindungscode zu schreiben. Eine REST-API erfordert weiterhin, dass Sie (oder das Modell) die genaue Endpunktform kennen; MCP-Tools sind selbstbeschreibend, sodass der Client sie und ihre Eingabeschemas automatisch auflistet.
Welchen Transport verwendet dieser MCP-Server?
Streamable HTTP – der aktuelle Transport für entfernte, mandantenfähige MCP-Server (der ältere HTTP+SSE-Transport ist veraltet). Im Hintergrund sind MCP-Nachrichten JSON-RPC 2.0, und die Transportschicht kümmert sich nur darum, diese Nachrichten zum und vom Server zu übertragen; Sie müssen JSON-RPC nicht kennen, um ihn zu nutzen, nur die Konfiguration unten.
Brauche ich einen API-Schlüssel, um den MCP-Server zu nutzen?
Ja, für die meisten Tools. Anfragen werden per Bearer-Token authentifiziert – demselben API-Schlüssel, den Sie auch für die REST-API verwenden würden. Melden Sie sich für 100 kostenlose Credits über das Dashboard an, keine Karte erforderlich. Dieser Server unterstützt außerdem OAuth 2.1 (Dynamic Client Registration) für Clients wie ChatGPT-Konnektoren, die sich per OAuth-Ablauf statt eines statischen Headers authentifizieren.
Kostet das genauso Credits wie die REST-API?
Ja – jeder erfolgreiche guthabenpflichtige Tool-Aufruf kostet 1 Credit, dieselbe Abrechnung wie bei der REST-API. get_channel_latest_videos ist kostenlos und berechnet nie einen Credit. Fehlgeschlagene Aufrufe werden nie berechnet.
Die Tools erscheinen nach dem Hinzufügen der Konfiguration nicht – was prüfe ich?
Starten Sie den Client vollständig neu (nicht nur das Fenster neu laden) – die meisten Clients lesen die MCP-Server-Konfiguration nur beim Start. Prüfen Sie dann, ob der Bearer-Token gültig ist (ein abgelaufener oder fehlerhafter Schlüssel liefert 401, nicht ein Symptom fehlender Tools) und dass die URL keinen Tippfehler enthält – ein falscher Pfad liefert 404, noch bevor die Authentifizierung überhaupt geprüft wird.
Ist es sicher, meinen API-Schlüssel in eine Konfigurationsdatei zu schreiben?
Behandeln Sie eine MCP-Konfigurationsdatei wie jede andere Zugangsdatendatei – committen Sie sie nicht in ein öffentliches Repository, und bevorzugen Sie, falls verfügbar, die Secrets-/Umgebungsvariablen-Unterstützung Ihres Clients gegenüber einem fest eingetragenen Schlüssel. Die Verbindung selbst läuft über HTTPS, sodass der Token während der Übertragung nicht offengelegt wird.
Verwandte Themen