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/mcpClaude (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/mcpChatGPT
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/mcpClaude 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 yapar | Maliyet |
|---|---|---|
get_youtube_transcript | Tam transkript artı başlık, yazar, küçük resim | 1 kredi |
search_youtube | Videolarda veya kanallarda arama, sayfalı | 1 kredi |
get_channel_latest_videos | Bir kanalın meta verileri ve son yüklemeleri | Ücretsiz |
search_channel_videos | Bir kanal içinde arama | 1 kredi |
list_channel_videos | Bir kanalın yüklediği her video | 1 kredi |
list_playlist_videos | Bir çalma listesindeki her video | 1 kredi |
get_credits | Anahtarı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
Ö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: "...")
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
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.