YouTube MCP Sunucusu

Tek bir uzak URL; Claude, ChatGPT, Cursor ve MCP uyumlu diğer tüm istemcilere gerçek YouTube erişimi sağlar - transkriptler, arama, kanallar ve oynatma listeleri - doğrudan sohbetin içinde.

  • ✓Başlangıç için 100 ücretsiz kredi, kredi kartı gerekmez
  • ✓Tek bir API anahtarı hem MCP sunucusu hem de REST API için çalışır
  • ✓Bir kanalın en son yüklemelerini kontrol etmek her zaman ücretsizdir
  • ✓Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline ve Codex ile çalışır

MCP nedir?

Model Context Protocol, bir yapay zeka asistanının verileri elle kopyalayıp yapıştırmanız yerine sohbetin ortasında araçları çağırmasını sağlar. Bu sunucu barındırılan (hosted) bir sunucudur - bir istemciyi tek bir URL'ye yönlendirin, kullanılabilir araçları otomatik olarak keşfetsin. Kurulacak veya yerelde çalıştırılacak hiçbir şey yok.

Yaklaşık bir dakikada bağlanın

Streamable HTTP. Aşağıdaki her istemci aynı URL'yi işaret eder:

https://getyoutubetranscript.com/api/mcp

Claude (Web & Masaüstü)

Ayarlar -> Bağlayıcılar -> Özel bağlayıcı ekle, ardından aşağıdaki URL'yi yapıştırın. Claude sizden giriş yapıp bağlanmanızı ister - kopyalanacak bir anahtar yoktur.

https://getyoutubetranscript.com/api/mcp

ChatGPT

Ayarlar -> Bağlayıcılar -> Gelişmiş -> Geliştirici modu, aşağıdaki URL ile bir bağlayıcı ekleyin, ardından bağlanıp giriş yapın.

https://getyoutubetranscript.com/api/mcp

Claude Code

Panonuzdaki bir API anahtarını kullanan tek bir komut:

claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
  --header "Authorization: Bearer sk_live_..."

Cursor

~/.cursor/mcp.json (tüm projeler) veya .cursor/mcp.json (yalnızca bu proje) dosyasına ekleyin:

{
  "mcpServers": {
    "getyoutubetranscript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json dosyasına ekleyin. VS Code, anahtarı aşağıdaki giriş alanı üzerinden bir kez sorar ve dosyaya yazmak yerine güvenli şekilde saklar:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gyt-api-key",
      "description": "GetYouTubeTranscript API key",
      "password": true
    }
  ],
  "servers": {
    "getyoutubetranscript": {
      "type": "http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gyt-api-key}"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml dosyasına ekleyin, ardından referans verilen ortam değişkenini export edin:

[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"
export GYT_API_KEY="sk_live_..."

Windsurf & Cline

Yukarıdaki Cursor ile aynı mcpServers JSON biçimi, Windsurf'ün veya Cline'ın kendi MCP ayar dosyasında.

Kullanılabilir araçlar

AraçNe yaparMaliyet
get_youtube_transcriptTam transkript artı başlık, yazar, küçük resim1 kredi
search_youtubeVideolarda veya kanallarda arama, sayfalı1 kredi
get_channel_latest_videosBir kanalın meta verileri ve son yüklemeleriÜcretsiz
search_channel_videosBir kanal içinde arama1 kredi
list_channel_videosBir kanalın yüklediği her video1 kredi
list_playlist_videosBir çalma listesindeki her video1 kredi
get_creditsAnahtarın kalan kredi bakiyesiÜcretsiz

REST API ile aynı araçlar, aynı kredi maliyetleri - eşdeğer uç noktalar için API dokümanlarına bakın.

Sohbette nasıl görünür

> 3Blue1Brown'ın son videosu sinir ağları hakkında ne söyledi?

Önce kanalı kontrol edip en son yüklemeyi bulacağım, sonra transkriptini alacağım.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

En son video, geri yayılımı bu sayıyı biraz oynatmanın nihai maliyeti nasıl değiştirdiğini tekrar tekrar sormak olarak anlatıyor - zincir kuralını, gradyan vektörlerini ve daha derin ağların neden daha dikkatli bir başlatmaya ihtiyaç duyduğunu ele alıyor...

Fiyatlandırma

Başlangıç için 100 ücretsiz kredi. Ardından 1.000 kredi için ayda 5$ (yıllık faturalandırmada ayda 4,50$). Bir kredi, başarılı bir araç çağrısına karşılık gelir - başarısız veya hız sınırına takılan çağrılar asla ücretlendirilmez. Plan bazında hız sınırları dahil tam döküm API dokümanlarında.

Not

Kendi istemcinizi mi geliştiriyorsunuz, yoksa bunu kod üretimine mi besliyorsunuz? Tam REST uç nokta sözleşmesi /openapi.json adresinde yayınlanır (OpenAPI 3.0) - bu MCP araçlarının arka planda çağırdığı uç noktalarla aynısı. İnsan tarafından okunabilir sürüm: API dokümanları.

MCP sunucusu SSS

Bu hangi MCP istemcileriyle çalışır?

Streamable HTTP MCP konuşan her istemciyle: Claude (web, masaüstü, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline ve Codex CLI yukarıda ele alındı. Bir istemci uzak bir HTTP MCP sunucusunu destekliyorsa burada da çalışır.

Bir şey kurmam veya çalıştırmam gerekiyor mu?

Hayır. Sunucu getyoutubetranscript.com üzerinde barındırılır - bir istemcinin yalnızca URL'ye (OAuth kullanmayan istemciler için ayrıca bir API anahtarına) ihtiyacı vardır. Yerel bir süreç, yt-dlp veya yönetilecek bir proxy yoktur.

Kendi çalıştırdığım açık kaynak bir MCP sunucusundan farkı nedir?

Kendi barındırdığınız bir sunucu kendi makinenizde veya sunucunuzda çalışır ve genellikle YouTube erişimini (çerezler, proxy'ler, hız sınırları) kendinizin yönetmesini gerektirir. Bu sunucu barındırılır: kayıt kendi kendine hizmet şeklindedir, istekler bizim altyapımızdan geçer ve kazıma (scraping) altyapısı yönetmek yerine kredi ile faturalandırılırsınız.

401 hatası aldım - ne yapmalıyım?

OAuth istemcileri için (Claude, ChatGPT) bağlayıcıyı kendi ayarlar sayfasından yeniden bağlayın - bağlantının süresi muhtemelen dolmuş veya iptal edilmiştir. API anahtarlı istemciler için (Cursor, VS Code, Claude Code, Codex) anahtarın fazladan boşluk olmadan doğru yapıştırıldığını ve panodan iptal edilmediğini kontrol edin.

Asistanım bir aracı çağırmak yerine hafızasından cevap verdi

Modeller bazen bir videonun içeriğini zaten bildiklerini varsayar. Açıkça isteyin: "önce transkripti almak için YouTube MCP aracını kullan" - genellikle bu, araç çağrısını zorlamaya yeter.

İstediğim dilde altyazısı olmayan bir video için ne olur?

get_youtube_transcript, yanlış dilde bir tahmin yerine TRANSCRIPT_NOT_FOUND hatası döndürür. Dil parametresi olmadan deneyin (varsayılan İngilizce'dir) veya önce videonun YouTube'da gerçekten o dilde altyazısı olup olmadığını kontrol edin.

Bu, YouTube Data API kotamı tüketir mi?

Hayır. Kendi anahtarınızla captions.download'u proxy'lemez, bu yüzden yönetilmesi gereken günlük 10.000 birimlik bir sınır yoktur - yalnızca planınıza göre istek hız sınırı vardır.

MCP ve REST API için aynı API anahtarını kullanabilir miyim?

Evet - tek anahtar, ikisi arasında paylaşılan tek bir kredi bakiyesi. Bir anahtar yerine OAuth (Claude/ChatGPT bağlayıcıları) ile bağlanmak da aynı hesap bakiyesinden harcama yapar; perde arkasında panonuzun anahtar listesinde görünen özel bir anahtar oluştururuz, böylece bu bağlantıyı diğer anahtarlar gibi görebilir veya iptal edebilirsiniz.