Transkrip YouTube Claude API via mcp_servers

Claude API dapat mengambil transkrip YouTube sendiri jika Anda memberikan server MCP dalam permintaan. Konektor MCP Anthropic membuat Messages API terhubung ke server jarak jauh, menemukan toolnya, dan memanggilnya di tengah penyelesaian — tanpa loop eksekusi tool di sisi Anda. Saya memverifikasi blok di bawah terhadap server MCP yang dihosting youtube2text.org hari ini.

Permintaan

Konektor MCP adalah fitur beta, jadi membutuhkan header anthropic-beta: mcp-client-2025-11-20, dan membutuhkan dua bagian yang harus saling merujuk: entri mcp_servers mendeklarasikan koneksi, dan entri mcp_toolset di tools memberikan akses dengannya berdasarkan nama. Abaikan toolset dan API menolak permintaan dengan kesalahan validasi.

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

Dua kunci ada dalam permainan dan keduanya tidak dapat dipertukarkan. x-api-key di header adalah kunci Anthropic Anda. authorization_token di dalam mcp_servers adalah kunci youtube2text Anda — dikembalikan ke server transkrip sebagai token bearer. Dapatkan satu melalui sign-in Google di youtube2text.org/app/keys, atau tarik kunci demo bersama dari GET https://youtube2text.org/api/demo-key (5 video/bulan per IP).

Apa yang kembali

Array content respons menyelipkan aktivitas tool dengan jawaban: blok mcp_tool_use menunjukkan Claude memanggil transcribe_video dengan URL yang diekstraknya dari prompt Anda, blok mcp_tool_result membawa {title, content, contentSize, videoId, pubDate, truncated}, kemudian blok text dengan ringkasan aktual. Anthropic menjalankan seluruh putaran tool server-side — kode Anda membuat satu permintaan HTTP dan membaca pesan terakhir.

Karena konektor adalah beta, perlakukan sesuai dengan itu: header wajib ada, dan bentuk permintaan sudah berubah sekali (tulisan lebih lama menunjukkan mcp_servers tanpa entri mcp_toolset — bentuk itu mendahului header saat ini). Kunci string beta dan periksa respons untuk blok mcp_tool_result sebelum mengasumsikan transkrip tiba.

Jalur tanpa kode

Tidak membangun terhadap API? Dua baris: di claude.ai buka Pengaturan → Konektor → Tambah konektor khusus, tempel https://youtube2text.org/mcp, selesaikan sign-in Google, klik Izinkan. Server berbicara OAuth 2.1 dengan pendaftaran klien dinamis dan PKCE, jadi claude.ai menangani seluruh handshake — detail dan apa yang harus dilakukan dengannya dalam transkrip YouTube gratis di Claude.

Pengguna Claude Code mendapatkan tool yang sama dengan:

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

kemudian /mcp di dalam sesi untuk masuk.

Kapan menggunakan yang mana

Gunakan blok mcp_servers ketika Anda membangun produk di Messages API dan menginginkan akses transkrip di dalam loop agen yang ada. Gunakan endpoint REST secara langsung ketika Anda hanya membutuhkan teksnya — menyalurkan transkrip melalui Claude untuk mengekstraknya kembali adalah fungsi identitas yang mahal. Dan jika tumpukan Anda adalah sisi OpenAI, Responses API mengambil server MCP yang sama dengan blok yang hampir identik.

Penggunaan diukur terhadap rencana youtube2text Anda: gratis mencakup 5 video sebulan, dasar adalah $5,99/50, pro $9,99/500, unlimited $19,99. Kunci di youtube2text.org/app/keys.