YouTube-MCP-Server
Eine einzige Remote-URL gibt Claude, ChatGPT, Cursor und jedem anderen MCP-kompatiblen Client echten YouTube-Zugriff - Transkripte, Suche, Kanäle und Playlists - direkt in der Unterhaltung.
- ✓100 Gratis-Credits zum Start, keine Kreditkarte nötig
- ✓Ein API-Schlüssel funktioniert sowohl für den MCP-Server als auch für die REST-API
- ✓Die neuesten Uploads eines Kanals abzufragen ist immer kostenlos
- ✓Funktioniert mit Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline und Codex
Was ist MCP?
Das Model Context Protocol lässt einen KI-Assistenten mitten im Gespräch Tools aufrufen, statt dass du Daten von Hand kopierst und einfügst. Dieser Server ist gehostet - ein Client zeigt einfach auf eine URL und entdeckt die verfügbaren Tools automatisch. Nichts zu installieren oder lokal auszuführen.
In etwa einer Minute verbunden
Streamable HTTP. Jeder Client unten zeigt auf dieselbe URL:
https://getyoutubetranscript.com/api/mcpClaude (Web & Desktop)
Einstellungen -> Connectors -> Benutzerdefinierten Connector hinzufügen, dann die URL unten einfügen. Claude fordert dich auf, dich anzumelden und zu verbinden - kein Schlüssel zum Kopieren.
https://getyoutubetranscript.com/api/mcpChatGPT
Einstellungen -> Connectors -> Erweitert -> Entwicklermodus, einen Connector mit der URL unten hinzufügen, dann verbinden und anmelden.
https://getyoutubetranscript.com/api/mcpClaude Code
Ein einzelner Befehl, mit einem API-Schlüssel aus deinem Dashboard:
claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
--header "Authorization: Bearer sk_live_..."Cursor
In ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (nur dieses Projekt) einfügen:
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}VS Code (Copilot)
In .vscode/mcp.json einfügen. VS Code fragt den Schlüssel einmal über die Eingabe unten ab und speichert ihn sicher, statt ihn in die Datei zu schreiben:
{
"inputs": [
{
"type": "promptString",
"id": "gyt-api-key",
"description": "GetYouTubeTranscript API key",
"password": true
}
],
"servers": {
"getyoutubetranscript": {
"type": "http",
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:gyt-api-key}"
}
}
}
}Codex CLI
In ~/.codex/config.toml einfügen, dann die referenzierte Umgebungsvariable exportieren:
[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"export GYT_API_KEY="sk_live_..."Windsurf & Cline
Gleiches mcpServers-JSON-Format wie bei Cursor oben, in der eigenen MCP-Konfigurationsdatei von Windsurf oder Cline.
Verfügbare Tools
| Tool | Was es tut | Kosten |
|---|---|---|
get_youtube_transcript | Vollständiges Transkript plus Titel, Autor, Thumbnail | 1 Credit |
search_youtube | Videos oder Kanäle durchsuchen, paginiert | 1 Credit |
get_channel_latest_videos | Metadaten eines Kanals und aktuelle Uploads | Kostenlos |
search_channel_videos | Innerhalb eines Kanals suchen | 1 Credit |
list_channel_videos | Jedes von einem Kanal hochgeladene Video | 1 Credit |
list_playlist_videos | Jedes Video in einer Playlist | 1 Credit |
get_credits | Verbleibendes Credit-Guthaben für den Schlüssel | Kostenlos |
Gleiche Tools, gleiche Credit-Kosten wie die REST-API - die entsprechenden Endpunkte stehen in der API-Dokumentation.
So sieht es in der Unterhaltung aus
Ich schaue im Kanal nach dem neuesten Upload und hole dann dessen Transkript.
get_channel_latest_videos(channel: "@3blue1brown")
get_youtube_transcript(video_url: "...")
Preise
100 Gratis-Credits zum Start. Danach 5 $/Monat für 1.000 Credits (4,50 $/Monat bei jährlicher Abrechnung). Ein Credit entspricht einem erfolgreichen Tool-Aufruf - fehlgeschlagene oder rate-limitierte Aufrufe werden nie berechnet. Die vollständige Aufschlüsselung inklusive Rate-Limits pro Tarif steht in der API-Dokumentation.
Hinweis
MCP-Server-FAQ
Mit welchen MCP-Clients funktioniert das?
Mit jedem Client, der Streamable-HTTP-MCP spricht: Claude (Web, Desktop, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline und Codex CLI sind oben abgedeckt. Unterstützt ein Client einen entfernten HTTP-MCP-Server, funktioniert es auch hier.
Muss ich etwas installieren oder ausführen?
Nein. Der Server ist unter getyoutubetranscript.com gehostet - ein Client braucht nur die URL (und, für Clients ohne OAuth, einen API-Schlüssel). Kein lokaler Prozess, kein yt-dlp, kein Proxy zu verwalten.
Wie unterscheidet sich das von einem Open-Source-MCP-Server, den ich selbst betreibe?
Ein selbst gehosteter Server läuft auf deiner eigenen Maschine oder deinem eigenen Server und verlangt meist, dass du den YouTube-Zugriff (Cookies, Proxys, Rate-Limits) selbst verwaltest. Dieser hier ist gehostet: Die Anmeldung ist selbstbedienend, Anfragen laufen über unsere Infrastruktur, und du zahlst in Credits statt Scraping-Infrastruktur zu betreiben.
Ich bekomme einen 401-Fehler - was tun?
Bei OAuth-Clients (Claude, ChatGPT) den Connector auf seiner Einstellungsseite neu verbinden - die Verbindung ist wahrscheinlich abgelaufen oder wurde widerrufen. Bei API-Schlüssel-Clients (Cursor, VS Code, Claude Code, Codex) prüfen, ob der Schlüssel korrekt ohne zusätzliche Leerzeichen eingefügt wurde und im Dashboard nicht widerrufen wurde.
Mein Assistent hat aus dem Gedächtnis geantwortet statt ein Tool aufzurufen
Modelle nehmen manchmal an, den Inhalt eines Videos schon zu kennen. Fordere es explizit auf: "nutze das YouTube-MCP-Tool, um zuerst das Transkript zu holen" - das reicht meist, um den Tool-Aufruf zu erzwingen.
Was passiert, wenn ein Video keine Untertitel in der angefragten Sprache hat?
get_youtube_transcript gibt einen TRANSCRIPT_NOT_FOUND-Fehler zurück statt einer falschsprachigen Vermutung. Versuche es ohne Sprachparameter (Standard ist Englisch) oder prüfe zuerst auf YouTube, ob das Video wirklich Untertitel in dieser Sprache hat.
Verbraucht das mein YouTube-Data-API-Kontingent?
Nein. Es leitet captions.download nicht mit deinem eigenen Schlüssel weiter, daher gibt es kein tägliches 10.000-Einheiten-Limit zu verwalten - nur das Anfragen-Rate-Limit deines Tarifs.
Kann ich denselben API-Schlüssel für MCP und die REST-API verwenden?
Ja - ein Schlüssel, ein gemeinsames Credit-Guthaben für beide. Auch eine Verbindung über OAuth (Claude/ChatGPT-Connectors) statt eines Schlüssels greift auf dasselbe Kontoguthaben zu; wir legen im Hintergrund einen eigenen Schlüssel an, der in der Schlüsselliste deines Dashboards erscheint, sodass du diese Verbindung wie jeden anderen Schlüssel einsehen oder widerrufen kannst.