Claude API YouTube-transkripsjoner via mcp_servers

Claude API kan hente YouTube-transkripsjoner selv hvis du gir den en MCP-server i forespørselen. Anthropics MCP-kobling gjør Messages API-ringer ut til en ekstern server, oppdager verktøyene og kaller dem midt i fullføringen — ingen verktøyekjørings-løkke på din side. Jeg verifiserte blokken nedenfor mot youtube2text.org sin vertskap MCP-server i dag.

Forespørselen

MCP-koblingen er en betafunksjon, så den trenger anthropic-beta: mcp-client-2025-11-20 headeren, og den tar to halvdeler som må referere til hverandre: mcp_servers-oppføringen erklærer forbindelsen, og en mcp_toolset-oppføring i tools gir tilgang til den etter navn. Utelat toolset og APIen avviser forespørselen med en valideringsfeil.

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

To nøkkler er i spill og de er ikke utskiftbare. x-api-key i headeren er din Anthropic-nøkkel. authorization_token inne i mcp_servers er din youtube2text-nøkkel — den blir videresendt til transkripsjon-serveren som en bearer-token. Få en via Google-innlogging på youtube2text.org/app/keys, eller trekk den delte demo-nøkkelen fra GET https://youtube2text.org/api/demo-key (5 videoer/måned per IP).

Hva kommer tilbake

Responsen content-matrisen sammenfletter verktøyaktiviteten med svaret: en mcp_tool_use-blokk som viser Claude som kaller transcribe_video med URLen den hentet fra prompten din, en mcp_tool_result-blokk som inneholder {title, content, contentSize, videoId, pubDate, truncated}, deretter en text-blokk med det faktiske sammendraget. Anthropic kjører hele verktøy rundt-turen på server-siden — koden din gjør ett HTTP-kall og leser det endelige meldingen.

Fordi koblingen er beta, behandle den deretter: headeren er obligatorisk, og forespørselsformen har allerede endret seg en gang (eldre skrifter viser mcp_servers uten mcp_toolset-oppføringen — det skjemaet er før gjeldende header). Fest beta-strengen og sjekk responsen for mcp_tool_result-blokker før du antar transkripsjonen ankom.

Ingen-kode-stien

Bygger ikke mot APIen? To linjer: i claude.ai gå til Innstillinger → Koblinger → Legg til egendefinert kobling, lim inn https://youtube2text.org/mcp, fullfør Google-innloggen, klikk Tillat. Serveren snakker OAuth 2.1 med dynamisk klient-registrering og PKCE, så claude.ai håndterer hele handtrykket — detaljer og hva du gjør med det i gratis YouTube-transkripsjoner i Claude.

Claude Code-brukere får det samme verktøyet med:

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

deretter /mcp inne i en sesjon for å logge inn.

Når skal du bruke hvilken

Bruk mcp_servers-blokken når du bygger et produkt på Messages API og ønsker transkripsjon-tilgang inne i en eksisterende agent-løkke. Bruk REST-endepunktet direkte når du bare trenger teksten — å lede en transkripsjon gjennom Claude for å hente den ut igjen er en dyr identitets-funksjon. Og hvis stakken din er OpenAI-siden, tar Responses API den samme MCP-serveren med en nesten identisk blokk.

Bruk måles mot youtube2text-planen: gratis dekker 5 videoer per måned, basic er $5.99/50, pro $9.99/500, unlimited $19.99. Nøkkler på youtube2text.org/app/keys.