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/mcp

Claude (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/mcp

ChatGPT

Einstellungen -> Connectors -> Erweitert -> Entwicklermodus, einen Connector mit der URL unten hinzufügen, dann verbinden und anmelden.

https://getyoutubetranscript.com/api/mcp

Claude 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

ToolWas es tutKosten
get_youtube_transcriptVollständiges Transkript plus Titel, Autor, Thumbnail1 Credit
search_youtubeVideos oder Kanäle durchsuchen, paginiert1 Credit
get_channel_latest_videosMetadaten eines Kanals und aktuelle UploadsKostenlos
search_channel_videosInnerhalb eines Kanals suchen1 Credit
list_channel_videosJedes von einem Kanal hochgeladene Video1 Credit
list_playlist_videosJedes Video in einer Playlist1 Credit
get_creditsVerbleibendes Credit-Guthaben für den SchlüsselKostenlos

Gleiche Tools, gleiche Credit-Kosten wie die REST-API - die entsprechenden Endpunkte stehen in der API-Dokumentation.

So sieht es in der Unterhaltung aus

> Was hat das neueste 3Blue1Brown-Video über neuronale Netze gesagt?

Ich schaue im Kanal nach dem neuesten Upload und hole dann dessen Transkript.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

Das neueste Video erklärt Backpropagation als wiederholtes Fragen: "Wie verändert eine kleine Änderung dieser Zahl die Endkosten?" - mit Kettenregel, Gradientenvektoren und warum tiefere Netze eine sorgfältigere Initialisierung brauchen ...

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

Baust du deinen eigenen Client oder fütterst das in Codegen? Der vollständige REST-Endpunkt-Vertrag ist unter /openapi.json (OpenAPI 3.0) veröffentlicht - dieselben Endpunkte, die diese MCP-Tools im Hintergrund aufrufen. Für Menschen lesbare Version: API-Dokumentation.

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.