YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools
How the Model Context Protocol works, how to connect the GetYouTubeTranscript MCP server to Claude Desktop, Claude Code, Cursor, Windsurf, or ChatGPT, and how to troubleshoot the connection.
00:08:00 · SEP 13, 2026
Jawaban singkat
Apa itu MCP sebenarnya
Model Context Protocol menstandardisasi bagaimana sebuah klien AI menemukan dan memanggil tool eksternal. Di baliknya adalah JSON-RPC 2.0 - klien bertanya kepada server tool apa saja yang tersedia beserta skema inputnya, lalu memanggilnya berdasarkan nama dengan argumen terstruktur dan mendapatkan hasil terstruktur kembali, semuanya dalam satu giliran percakapan yang sama.
Server MCP berjalan lewat salah satu dari dua transport: stdio, di mana klien menjalankan server sebagai subprocess lokal (umum untuk tool yang butuh akses filesystem lokal), atau Streamable HTTP, di mana server berada jarak jauh dan bisa diakses lewat HTTPS oleh berapa pun klien sekaligus - inilah yang digunakan server ini. (Transport HTTP+SSE yang lebih lama masih ada di sebagian dokumentasi tetapi sudah usang, digantikan Streamable HTTP.) Secara praktis, ini berarti Anda tidak pernah menjalankan apa pun secara lokal untuk menggunakan server ini - cukup arahkan klien Anda ke URL-nya.
Tool yang tersedia
| Tool | Apa fungsinya | Biaya |
|---|---|---|
get_youtube_transcript | Transkrip lengkap plus metadata judul, pembuat, dan thumbnail | 1 kredit |
search_youtube | Cari video atau channel di YouTube, dengan pagination | 1 kredit |
get_channel_latest_videos | Metadata channel plus upload terbarunya | Gratis |
search_channel_videos | Cari kata kunci di dalam satu channel, dengan pagination | 1 kredit |
list_channel_videos | Daftar setiap video yang diunggah sebuah channel, dengan pagination | 1 kredit |
list_playlist_videos | Ambil setiap video dalam sebuah playlist, dengan pagination | 1 kredit |
Semua tool berpaginasi (search, list-channel, list-playlist) menerima token continuation dari response sebelumnya untuk mengambil halaman berikutnya, alih-alih pasangan offset/limit.
Dapatkan API key
Daftar dari dashboard dan buat API key - 100 kredit sudah termasuk gratis, tanpa perlu kartu. Key ini adalah bearer token yang digunakan server MCP untuk autentikasi pada kebanyakan klien.
Tambahkan server ke Claude Desktop atau Claude Code
Tambahkan ini ke konfigurasi klien MCP Anda (misalnya claude_desktop_config.json, atau lewat claude mcp add untuk Claude Code):
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}Ganti sk_live_... dengan API key Anda sendiri. Mulai ulang klien sepenuhnya dan 6 tool di atas akan muncul secara otomatis - kebanyakan klien hanya membaca konfigurasi ini saat startup, bukan saat hot reload.
Klien lain: Cursor, Windsurf, dan agent custom
Klien mana pun yang mendukung server MCP jarak jauh lewat Streamable HTTP dengan header custom menggunakan bentuk konfigurasi yang sama - hanya nama file dan field di sekitarnya yang berbeda (misalnya .cursor/mcp.json pada Cursor, panel pengaturan MCP pada Windsurf). Jika sebuah klien hanya mendukung server berbasis OAuth alih-alih header bearer statis, gunakan alur OAuth yang dijelaskan berikutnya.
Konektor ChatGPT dan klien khusus OAuth
Untuk klien yang melakukan autentikasi server MCP lewat OAuth alih-alih API key yang ditempel (misalnya, konektor custom ChatGPT), server ini juga mendukung OAuth 2.1 dengan Dynamic Client Registration - arahkan klien ke URL server yang sama dan klien akan menemukan metadata OAuth-nya lalu memandu Anda melalui alur otorisasi, bukan langsung meminta bearer token.
Minta agar menggunakan sebuah tool
Setelah terhubung, prompt yang alami sudah cukup - modelnya yang memutuskan tool mana yang dipanggil:
- "Ambilkan transkrip untuk youtube.com/watch?v=dQw4w9WgXcQ dan ringkas dalam 3 poin."
- "Cari di YouTube untuk 'Next.js server actions' dan tampilkan 5 hasil teratas."
- "Daftar semua video yang diunggah @mkbhd dan temukan yang menyebut 'baterai'."
Pemecahan Masalah
Sedang membangun agent custom alih-alih menggunakan klien chat? Server yang sama berfungsi dengan klien kompatibel MCP mana pun lewat Streamable HTTP. Referensi endpoint REST lengkap, kredit, dan rate limit ada di dokumentasi API.
FAQ Server MCP
Apa itu server MCP, dan mengapa saya perlu memakainya untuk transkrip YouTube?
MCP (Model Context Protocol) memungkinkan asisten AI seperti Claude memanggil tool eksternal langsung selama percakapan. Alih-alih menempel transkrip ke dalam chat, Anda meminta Claude untuk mengambilnya - ia memanggil tool, mendapatkan transkrip kembali, dan bisa meringkas, menerjemahkan, atau mencarinya dalam giliran yang sama.
Apakah MCP sama dengan sekadar wrapper REST API biasa?
Tidak. MCP menstandardisasi penemuan dan pemanggilan tool di semua klien yang kompatibel - server yang sama berfungsi dengan Claude Desktop, Claude Code, Cursor, Windsurf, atau agent custom tanpa menulis kode penghubung khusus klien. REST API tetap mengharuskan Anda (atau model) mengetahui bentuk endpoint yang pasti; tool MCP bersifat self-describing, sehingga klien mendaftarkannya beserta skema inputnya secara otomatis.
Transport apa yang digunakan server MCP ini?
Streamable HTTP - transport terkini untuk server MCP jarak jauh multi-klien (transport HTTP+SSE yang lebih lama sudah usang). Di baliknya, pesan MCP adalah JSON-RPC 2.0, dan lapisan transport hanya menangani pengiriman pesan tersebut ke dan dari server; Anda tidak perlu memahami JSON-RPC untuk menggunakannya, cukup konfigurasi di bawah.
Apakah saya perlu API key untuk menggunakan server MCP?
Ya untuk kebanyakan tool. Request diautentikasi dengan bearer token - API key yang sama yang Anda gunakan untuk REST API. Daftar untuk 100 kredit gratis dari dashboard, tanpa perlu kartu. Server ini juga mendukung OAuth 2.1 (Dynamic Client Registration) untuk klien seperti konektor ChatGPT yang melakukan autentikasi lewat alur OAuth alih-alih header statis.
Apakah ini mengurangi kredit dengan cara yang sama seperti REST API?
Ya - setiap panggilan tool berbasis kredit yang berhasil menghabiskan 1 kredit, dengan perhitungan yang sama seperti REST API. get_channel_latest_videos gratis dan tidak pernah mengenakan kredit. Panggilan yang gagal tidak pernah dikenakan biaya.
Tool tidak muncul setelah saya menambahkan konfigurasi - apa yang harus diperiksa?
Mulai ulang klien sepenuhnya (bukan hanya reload window) - kebanyakan klien hanya membaca konfigurasi server MCP saat startup. Kemudian periksa apakah bearer token valid (key yang kedaluwarsa atau salah format mengembalikan 401, bukan gejala tool yang hilang) dan pastikan URL-nya tidak salah ketik - path yang salah mengembalikan 404 bahkan sebelum autentikasi diperiksa.
Amankah menaruh API key saya dalam berkas konfigurasi?
Perlakukan berkas konfigurasi MCP seperti berkas kredensial lainnya - jangan commit ke repo publik, dan lebih baik gunakan dukungan secrets/environment-variable klien Anda daripada key yang di-hardcode jika tersedia. Koneksinya sendiri berjalan lewat HTTPS, jadi token tidak terekspos saat transit.
Terkait