Claude API YouTube Transkriptiot mcp_servers:n kautta

Claude API voi hakea YouTube-transkriptioita itse, jos annat sille MCP-palvelimen pyynnössä. Anthropicin MCP-liitin tekee Messages API:sta soittaa etäpalvelimelle, löytää sen työkalut ja kutsua niitä keskustelun aikana — ei työkalun suoritussilmukkaa sinussa. Tarkistin alla olevan lohkon youtube2text.org:n isännöidyllä MCP-palvelimella tänään.

Pyyntö

MCP-liitin on beeta-ominaisuus, joten se vaatii anthropic-beta: mcp-client-2025-11-20 -otsikon ja se vie kaksi puolta, joiden on oltava viitattava toisiinsa: mcp_servers-merkintä julistaa yhteyden ja tools:n mcp_toolset-merkintä myöntää pääsyn siihen nimellä. Jätä toolset pois ja API hylkää pyynnön validointivirheellä.

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

Kaksi avainta ovat pelissä ja ne eivät ole vaihdettavissa. x-api-key otsikossa on Anthropic-avaimesi. authorization_token mcp_servers:ssa on youtube2text-avaimesi — se välitetään transkription palvelimelle kanta-tunnisteena. Hanki yksi Google-kirjautumisen kautta youtube2text.org/app/keys, tai vetää jaettu demonäppäin GET https://youtube2text.org/api/demo-key (5 videota/kuukausi per IP).

Mitä tulee takaisin

Vastaus content-taulukko kerää työkalun toiminnan vastauksen kanssa: mcp_tool_use-lohko, joka näyttää Claudea kutsuvansa transcribe_video-komentoa kehotteestasi poimimallaan URL:lla, mcp_tool_result-lohko jossa on {title, content, contentSize, videoId, pubDate, truncated}, sitten text-lohko varsinaisella yhteenvedolla. Anthropic ajaa koko työkalun kierroksen palvelinpuolella — koodisi tekee yhden HTTP-pyynnön ja lukee lopullisen viestin.

Koska liitin on beeta, käsittele se siten: otsikko on pakollinen ja pyynnön muoto on jo muuttunut kerran (vanhat kirjoitukset näyttävät mcp_servers:n ilman mcp_toolset-merkintää — että muoto on ennen nykyisen otsikon). Kiinnitä beeta-merkkijono ja tarkista vastaus mcp_tool_result-lohkoista ennen kuin oletetaan transkription saapuvan.

Ilmainen polku

Ei rakenna API:tä vastaan? Kaksi riviä: claude.ai:ssa mene Asetukset → Liittimet → Lisää mukautettu liitin, liitä https://youtube2text.org/mcp, suorita Google-kirjautuminen, napsauta Salli. Palvelin puhuu OAuth 2.1:stä dynaamisen asiakasrekisteröinnin ja PKCE:n kanssa, joten claude.ai käsittelee koko kättelyt — tiedot ja mitä tehdä sen kanssa kohdassa ilmaiset YouTube-transkriptiot Claudessa.

Claude Code -käyttäjät saavat saman työkalun:

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

sitten /mcp istunnossa kirjautua sisään.

Milloin käyttää mitä

Käytä mcp_servers-lohkoa, kun olet rakentamassa tuotetta Messages API:ssa ja haluat transkriptioiden pääsyn olemassa olevan agent-silmukan sisällä. Käytä REST-päätepistettä suoraan, kun tarvitset vain tekstin — transkription kauttakuvailu Claudella poimimaan se takaisin on kallis identiteettifunktio. Ja jos pinoosi on OpenAI-puolella, Responses API vie saman MCP-palvelimen lähes identtisellä lohkolla.

Käyttö mitataan youtube2text-suunnitelmaa vastaan: ilmainen kattaa 5 videota kuukaudessa, perus on 5,99 $/50, pro 9,99 $/500, rajoittamaton 19,99 $. Avaimet osoitteessa youtube2text.org/app/keys.