Bloga dönEntegrasyonlar

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

Sunucu URL'sini ve API anahtarınızı bir bearer token olarak MCP istemcinizin yapılandırmasına ekleyin (tam JSON aşağıda), istemciyi yeniden başlatın ve URL ile bir transkript almasını isteyin - kopyala yapıştır gerekmez.

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 yaparMaliyet
get_youtube_transcriptTam transkript artı başlık, yazar ve küçük resim meta verisi1 kredi
search_youtubeYouTube'da videolarda veya kanallarda arama, sayfalı1 kredi
get_channel_latest_videosBir kanalın meta verileri artı en son yüklemeleriÜcretsiz
search_channel_videosBir kanal içinde bir sorgu araması, sayfalı1 kredi
list_channel_videosBir kanalın yüklediği her videoyu listele, sayfalı1 kredi
list_playlist_videosBir ç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.

01

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.

02

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.

03

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.

04

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.

05

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

MCP sunucusundan gelen bir 401, bearer token'ın eksik, süresi dolmuş veya hatalı biçimlendirilmiş olduğu anlamına gelir - panelinizdeki aktif bir anahtarla eşleştiğini kontrol edin. Yapılandırmayı ekledikten sonra araçlar hiç görünmüyorsa, istemci neredeyse her zaman bir yeniden yükleme değil, tam bir yeniden başlatma gerektirir.

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

Q01

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.

Q02

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.

Q03

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.

Q04

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.

Q05

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.

Q06

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.

Q07

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