Claude API YouTube-Transkripte via mcp_servers

Die Claude API kann YouTube-Transkripte selbst abrufen, wenn du ihr einen MCP-Server in der Anfrage übergibst. Anthropics MCP-Connector ermöglicht der Messages API, sich zu einem Remote-Server zu verbinden, seine Tools zu entdecken und sie mid-Completion aufzurufen — ohne eine Tool-Execution-Loop auf deiner Seite. Ich habe den Block unten heute gegen den gehosteten MCP-Server von youtube2text.org verifiziert.

Die Anfrage

Der MCP-Connector ist ein Beta-Feature, daher braucht er den Header anthropic-beta: mcp-client-2025-11-20, und er braucht zwei Hälften, die sich gegenseitig referenzieren: Der mcp_servers-Eintrag deklariert die Verbindung, und ein mcp_toolset-Eintrag in tools gewährt Zugriff darauf nach Name. Lasse das Toolset weg und die API lehnt die Anfrage mit einem Validierungsfehler ab.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 16000,
    "mcp_servers": [{
      "type": "url",
      "url": "https://youtube2text.org/mcp",
      "name": "youtube2text",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "youtube2text"}],
    "messages": [{
      "role": "user",
      "content": "Summarize https://www.youtube.com/watch?v=dQw4w9WgXcQ in five bullets."
    }]
  }'

Zwei Schlüssel sind im Spiel und sie sind nicht austauschbar. x-api-key in der Kopfzeile ist dein Anthropic-Schlüssel. authorization_token in mcp_servers ist dein youtube2text-Schlüssel — er wird an den Transkript-Server als Bearer-Token weitergeleitet. Hole einen über Google-Anmeldung bei youtube2text.org/app/keys, oder hole den gemeinsamen Demo-Schlüssel von GET https://youtube2text.org/api/demo-key (5 Videos/Monat pro IP).

Was zurückkommt

Das content-Array der Antwort verschachtelt die Tool-Aktivität mit der Antwort: ein mcp_tool_use-Block, der Claude zeigt, wie er transcribe_video mit der URL aufruft, die er aus deinem Prompt extrahiert hat, ein mcp_tool_result-Block mit {title, content, contentSize, videoId, pubDate, truncated}, dann ein text-Block mit der eigentlichen Zusammenfassung. Anthropic läuft den ganzen Tool-Round-Trip serverseitig — dein Code macht eine HTTP-Anfrage und liest die letzte Nachricht.

Da der Connector Beta ist, behandle ihn entsprechend: Der Header ist obligatorisch, und die Anfragefom hat sich bereits einmal geändert (ältere Schreibweisen zeigen mcp_servers ohne den mcp_toolset-Eintrag — diese Form ist älter als der aktuelle Header). Fixiere die Beta-Zeichenkette und prüfe die Antwort auf mcp_tool_result-Blöcke, bevor du davon ausgehst, dass das Transkript ankam.

Der No-Code-Weg

Nicht gegen die API entwickeln? Zwei Zeilen: Gehe bei claude.ai zu Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, füge https://youtube2text.org/mcp ein, schließe die Google-Anmeldung ab, klicke Zulassen. Der Server spricht OAuth 2.1 mit dynamischer Clientregistrierung und PKCE, daher handhabt claude.ai den gesamten Handshake — Details und was man damit anfängt in freie YouTube-Transkripte in Claude.

Claude Code-Benutzer bekommen das gleiche Tool mit:

claude mcp add --transport http youtube2text https://youtube2text.org/mcp

dann /mcp in einer Sitzung zum Anmelden.

Wann man welches nutzt

Nutze den mcp_servers-Block, wenn du ein Produkt auf der Messages API aufbaust und Transkript-Zugriff in einer bestehenden Agent-Loop willst. Nutze den REST-Endpunkt direkt, wenn du nur den Text brauchst — ein Transkript durch Claude zu leiten, um es zurückzuextrahieren, ist eine teure Identitätsfunktion. Und wenn dein Stack auf der OpenAI-Seite ist, nimmt die Responses API den gleichen MCP-Server mit einem fast identischen Block.

Die Nutzung wird gegen deinen youtube2text-Plan gemessen: Kostenlos covers 5 Videos pro Monat, Basic ist $5.99/50, Pro $9.99/500, Unbegrenzt $19.99. Keys bei youtube2text.org/app/keys.