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
Hızlı yanıt
MCP gerçekte nedir
Model Context Protocol, bir AI istemcisinin harici araçları nasıl keşfedip çağıracağını standartlaştırır. Perde arkasında bu JSON-RPC 2.0'dır - istemci sunucuya hangi araçların ve giriş şemalarının bulunduğunu sorar, ardından bunları yapılandırılmış argümanlarla adıyla çağırır ve aynı sohbet turunda yapılandırılmış bir sonuç alır.
MCP sunucuları iki taşıma türünden biri üzerinde çalışır: istemcinin sunucuyu yerel bir alt işlem olarak başlattığı stdio (yerel dosya sistemi erişimi gereken araçlar için tipiktir) veya sunucunun uzak olduğu ve HTTPS üzerinden aynı anda herhangi bir sayıda istemci tarafından erişilebildiği Streamable HTTP - bu sunucunun kullandığı da budur. (Bazı dokümantasyonlarda daha eski bir HTTP+SSE taşıması bulunur ancak bu, Streamable HTTP lehine kullanımdan kaldırılmıştır.) Pratikte bu, bu sunucuyu kullanmak için yerel olarak hiçbir şey çalıştırmadığınız anlamına gelir - sadece istemcinizi URL'ye yönlendirin.
Mevcut araçlar
| Araç | Ne yapar | Maliyet |
|---|---|---|
get_youtube_transcript | Tam transkript artı başlık, yazar ve küçük resim meta verisi | 1 kredi |
search_youtube | YouTube'da videolarda veya kanallarda arama, sayfalı | 1 kredi |
get_channel_latest_videos | Bir kanalın meta verileri artı en son yüklemeleri | Ücretsiz |
search_channel_videos | Bir kanal içinde bir sorgu araması, sayfalı | 1 kredi |
list_channel_videos | Bir kanalın yüklediği her videoyu listele, sayfalı | 1 kredi |
list_playlist_videos | Bir çalma listesindeki her videoyu al, sayfalı | 1 kredi |
Sayfalanan araçlar (search, list-channel, list-playlist), bir sonraki sayfayı almak için bir offset/limit çifti yerine önceki bir yanıttan gelen bir continuation token'ı kabul eder.
Bir API anahtarı alın
Panelden kaydolun ve bir API anahtarı oluşturun - 100 kredi ücretsiz dahildir, kart gerekmez. Bu anahtar, MCP sunucusunun çoğu istemci için kimlik doğrulamasında kullandığı bearer token'dır.
Sunucuyu Claude Desktop veya Claude Code'a ekleyin
Bunu MCP istemcinizin yapılandırmasına ekleyin (örneğin claude_desktop_config.json, veya Claude Code için claude mcp add ile):
{
"mcpServers": {
"getyoutubetranscript": {
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}sk_live_... yerine kendi API anahtarınızı koyun. İstemciyi tamamen yeniden başlatın; yukarıdaki 6 araç otomatik olarak görünür - çoğu istemci bu yapılandırmayı yalnızca başlangıçta okur, sıcak yeniden yüklemede değil.
Diğer istemciler: Cursor, Windsurf ve özel ajanlar
Özel başlıklarla Streamable HTTP üzerinden uzak bir MCP sunucusunu destekleyen herhangi bir istemci aynı yapılandırma şeklini kullanır - yalnızca çevresindeki dosya ve alan adları farklıdır (örneğin Cursor'un .cursor/mcp.json'ı, Windsurf'ün MCP ayarlar paneli). Bir istemci, statik bir bearer başlığı yerine yalnızca OAuth tabanlı sunucuları destekliyorsa, bunun yerine aşağıda açıklanan OAuth akışını kullanın.
ChatGPT bağlayıcıları ve yalnızca OAuth kullanan istemciler
MCP sunucularını yapıştırılmış bir API anahtarı yerine OAuth ile kimlik doğrulayan istemciler için (örneğin ChatGPT'nin özel bağlayıcıları), bu sunucu ayrıca Dinamik İstemci Kaydı ile OAuth 2.1'i destekler - istemciyi aynı sunucu URL'sine yönlendirin, OAuth meta verilerini keşfedip doğrudan bir bearer token istemek yerine sizi bir yetkilendirme akışından geçirir.
Bir araç kullanmasını isteyin
Bağlandıktan sonra, doğal komutlar yeterlidir - model hangi aracı çağıracağına karar verir:
- "youtube.com/watch?v=dQw4w9WgXcQ videosunun transkriptini al ve 3 madde halinde özetle."
- "YouTube'da 'Next.js server actions' ara ve ilk 5 sonucu listele."
- "@mkbhd'nin yüklediği tüm videoları listele ve 'battery' kelimesinden bahsedenleri bul."
Sorun Giderme
Bir sohbet istemcisi kullanmak yerine özel bir ajan mı inşa ediyorsunuz? Aynı sunucu, Streamable HTTP üzerinden herhangi bir MCP uyumlu istemciyle çalışır. Tam REST uç nokta referansı, krediler ve hız sınırları API dokümanlarında yer alır.
MCP sunucusu SSS
MCP sunucusu nedir ve YouTube transkriptleri için neden bir tane kullanayım?
MCP (Model Context Protocol), Claude gibi bir AI asistanının bir sohbet sırasında harici araçları doğrudan çağırmasına izin verir. Bir transkripti sohbete yapıştırmak yerine, Claude'dan onu almasını istersiniz - aracı çağırır, transkripti geri alır ve aynı turda özetleyebilir, çevirebilir veya arayabilir.
MCP, düz bir REST API sarmalayıcısıyla aynı şey mi?
Hayır. MCP, uyumlu herhangi bir istemci genelinde araç keşfini ve çağrısını standartlaştırır - aynı sunucu, istemciye özel bağlayıcı kod yazmadan Claude Desktop, Claude Code, Cursor, Windsurf veya özel bir ajanla çalışır. Bir REST API hâlâ sizin (veya modelin) tam uç nokta şeklini bilmesini gerektirir; MCP araçları kendini tanımlar, bu yüzden istemci bunları ve giriş şemalarını otomatik olarak listeler.
Bu MCP sunucusu hangi taşımayı kullanıyor?
Streamable HTTP - uzak, çoklu istemcili MCP sunucuları için güncel taşıma (daha eski HTTP+SSE taşıması kullanımdan kaldırılmıştır). Perde arkasında, MCP mesajları JSON-RPC 2.0'dır ve taşıma katmanı yalnızca bu mesajların sunucuya gidip gelmesini yönetir; onu kullanmak için JSON-RPC bilmenize gerek yok, sadece aşağıdaki yapılandırmayı bilmeniz yeterli.
MCP sunucusunu kullanmak için bir API anahtarına ihtiyacım var mı?
Çoğu araç için evet. İstekler bir bearer token ile kimlik doğrulanır - REST API için kullanacağınız aynı API anahtarı. Panelden 100 ücretsiz kredi için kaydolun, kart gerekmez. Bu sunucu ayrıca statik bir başlık yerine bir OAuth akışıyla kimlik doğrulayan ChatGPT bağlayıcıları gibi istemciler için OAuth 2.1'i (Dinamik İstemci Kaydı) destekler.
Bu, REST API ile aynı şekilde kredi harcar mı?
Evet - her başarılı ölçümlü araç çağrısı 1 kredi harcar, REST API ile aynı muhasebe. get_channel_latest_videos ücretsizdir ve asla kredi harcamaz. Başarısız çağrılar asla ücretlendirilmez.
Yapılandırmayı ekledikten sonra araçlar görünmüyor - neyi kontrol etmeliyim?
İstemciyi tamamen yeniden başlatın (yalnızca pencereyi yeniden yüklemek değil) - çoğu istemci MCP sunucusu yapılandırmasını yalnızca başlangıçta okur. Ardından bearer token'ın geçerli olduğunu kontrol edin (süresi dolmuş veya hatalı biçimlendirilmiş bir anahtar, eksik araç semptomu değil 401 döndürür) ve URL'de yazım hatası olmadığını kontrol edin - yanlış bir yol, kimlik doğrulama kontrol edilmeden önce bile 404 döndürür.
API anahtarımı bir yapılandırma dosyasına koymak güvenli mi?
Bir MCP yapılandırma dosyasını diğer herhangi bir kimlik bilgisi dosyası gibi ele alın - herkese açık bir depoya kaydetmeyin ve sunuyorsa, sabit kodlanmış bir anahtar yerine istemcinizin gizli/ortam değişkeni desteğini tercih edin. Bağlantının kendisi HTTPS üzerinden çalışır, bu yüzden token aktarım sırasında ifşa olmaz.
İlgili
- YouTube API Quota Exceeded: Causes and Fixes
- YouTube Transcript API Rate Limit: What It Is and How to Handle 429s
- YouTube Transcripts in n8n: HTTP Request Workflow Guide
- GetYouTubeTranscript ve TranscriptAPI karşılaştırması
- GetYouTubeTranscript ve youtubetotranscript.com karşılaştırması
- GetYouTubeTranscript ve youtube-transcript.io karşılaştırması