Claude API YouTube-transkriptioner via mcp_servers

Claude API kan hämta YouTube-transkriptioner av sig själv om du ger den en MCP-server i begäran. Anthropics MCP-anslutning gör att Messages API ringer ut till en fjärrserver, upptäcker dess verktyg och anropar dem mitt i färdigheten — ingen verktygskörningsloop på din sida. Jag verifierade blocket nedan mot youtube2texts hosted MCP-server idag.

Begäran

MCP-kopplingen är en betafunktion, så den behöver headern anthropic-beta: mcp-client-2025-11-20, och den tar två halvor som måste referera till varandra: posten mcp_servers deklarerar kopplingen, och en post mcp_toolset i tools beviljar åtkomst till den efter namn. Utelämna verktygssatsen och API:t avvisar begäran med ett valideringsfel.

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."
    }]
  }'

Två nycklar är i spel och de är inte utbytbara. x-api-key i headern är din Anthropic-nyckel. authorization_token inuti mcp_servers är din youtube2text-nyckel — den vidarebefordras till transkriptionsservern som en bärtoken. Få en via Google-inloggning på youtube2text.org/app/keys, eller dra den delade demo-nyckeln från GET https://youtube2text.org/api/demo-key (5 videor/månad per IP).

Vad som kommer tillbaka

Svaret content array förbinder verktygaktiviteten med svaret: ett mcp_tool_use block som visar Claude som anropar transcribe_video med URL:en den extraherade från din prompt, ett mcp_tool_result block som bär {title, content, contentSize, videoId, pubDate, truncated}, och sedan ett text block med det faktiska sammanfattningen. Anthropic kör hela verktygetsrundan på serversidan — din kod gör en HTTP-begäran och läser det slutliga meddelandet.

Eftersom kopplingen är beta, behandla den i enlighet med detta: headern är obligatorisk, och begärandens form har redan ändrats en gång (äldre skrifter visar mcp_servers utan mcp_toolset posten — den formen föregår den aktuella headern). Fäst betasträngen och kontrollera svaret för mcp_tool_result block innan du antar att transkriptionen anlände.

Vägen utan kod

Inte bygger mot API:t? Två rader: gå till Settings → Connectors → Add custom connector i claude.ai, klistra in https://youtube2text.org/mcp, slutför Google-inloggningen, klicka Tillåt. Servern talar OAuth 2.1 med dynamisk klientregistrering och PKCE, så claude.ai hanterar hela handskakningen — detaljer och vad du gör med det i gratis YouTube-transkriptioner i Claude.

Claude Code-användare får samma verktyg med:

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

sedan /mcp inuti en session för att logga in.

När du använder vilken

Använd mcp_servers blocket när du bygger en produkt på Messages API och vill ha transkriptåtkomst inuti en befintlig agentloop. Använd REST-slutpunkten direkt när du bara behöver texten — att leda en transkription genom Claude för att extrahera den tillbaka är en dyr identitetsfunktion. Och om din stack är på OpenAI-sidan, tar Responses API samma MCP-server med ett nästan identiskt block.

Användningen mäts mot din youtube2text-plan: gratis täcker 5 videor per månad, basic är $5,99/50, pro $9,99/500, unlimited $19,99. Nycklar på youtube2text.org/app/keys.