Transkrypcje YouTube w Claude API przez mcp_servers

Claude API może sam pobierać transkrypcje YouTube, jeśli dasz mu serwer MCP w żądaniu. Konektor MCP Anthropic sprawia, że Messages API dzwoni do serwera zdalnego, odkrywa jego narzędzia i wywołuje je w trakcie realizacji — bez pętli wykonania narzędzi po Twojej stronie. Zweryfikowałem blok poniżej względem hostowanego serwera MCP youtube2text.org dzisiaj.

Żądanie

Konektor MCP jest funkcją beta, więc potrzebuje nagłówka anthropic-beta: mcp-client-2025-11-20 i ma dwie części, które muszą się odwoływać: wpis mcp_servers deklaruje połączenie, a wpis mcp_toolset w tools udziela dostępu do niego według nazwy. Pomiń zestaw narzędzi, a API odrzuci żądanie z błędem walidacji.

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

Dwa klucze są w grze i nie są zamienne. x-api-key w nagłówku to Twój klucz Anthropic. authorization_token wewnątrz mcp_servers to Twój klucz youtube2text — jest on przekazywany do serwera transkrypcji jako token nośnika. Uzyskaj jeden poprzez logowanie Google na youtube2text.org/app/keys, lub weź wspólny klucz demo z GET https://youtube2text.org/api/demo-key (5 filmów/miesiąc na IP).

Co wraca

Tablica content odpowiedzi przeplatać aktywność narzędzia z odpowiedzią: blok mcp_tool_use pokazujący Claude'a wywołującego transcribe_video z URL wyodrębnionym z Twojego promptu, blok mcp_tool_result niosący {title, content, contentSize, videoId, pubDate, truncated}, następnie blok text z rzeczywistym podsumowaniem. Anthropic prowadzi całą rundę narzędzia po stronie serwera — Twój kod robi jedno żądanie HTTP i odczytuje ostatnią wiadomość.

Ponieważ konektor jest beta, traktuj go odpowiednio: nagłówek jest obowiązkowy, a forma żądania już raz się zmieniła (starsze posty pokazują mcp_servers bez wpisu mcp_toolset — ta forma poprzedza obecny nagłówek). Przypnij ciąg beta i sprawdź odpowiedź dla bloków mcp_tool_result przed założeniem, że transkrypcja się pojawiła.

Ścieżka bez kodu

Nie budujesz przeciwko API? Dwie linie: w claude.ai przejdź do Settings → Connectors → Add custom connector, wklej https://youtube2text.org/mcp, ukończ logowanie Google, kliknij Allow. Serwer mówi OAuth 2.1 z dynamiczną rejestracją klienta i PKCE, więc claude.ai obsługuje całe handshake — szczegóły i co z tym zrobić w bezpłatnych transkrypcjach YouTube w Claude.

Użytkownicy Claude Code otrzymują to samo narzędzie z:

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

a następnie /mcp wewnątrz sesji, aby się zalogować.

Kiedy używać którego

Użyj bloku mcp_servers, gdy budujesz produkt na Messages API i chcesz dostępu transkrypcji wewnątrz istniejącej pętli agenta. Użyj bezpośrednio punktu końcowego REST, gdy po prostu potrzebujesz tekstu — przepuszczenie transkrypcji przez Claude w celu wyodrębnienia jej z powrotem to droga funkcja tożsamości. A jeśli Twój stos jest po stronie OpenAI, Responses API przyjmuje ten sam serwer MCP z prawie identycznym blokiem.

Użycie jest mierzone względem Twojego planu youtube2text: bezpłatny obejmuje 5 filmów na miesiąc, podstawowy to 5,99 USD/50, pro 9,99 USD/500, nieograniczony 19,99 USD. Klucze na youtube2text.org/app/keys.