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
- ✓Başarısız ve hız sınırına takılan çağrılar asla ücretlendirilmez
- ✓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ü)
Özelleştir -> Bağlayıcılar -> + Ekle -> Ö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
Plugins -> + -> Add custom MCP server, aşağıdaki URL'yi girin, OAuth'u seçip giriş yapın. Business, Enterprise ve Edu çalışma alanlarında (yöneticiler), web'de kullanılabilir.
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
Bunu Cline'ın MCP ayarlarına yapıştırın (MCP Servers, ardından Configure). "type": "streamableHttp" satırını koruyun, yoksa Cline eski SSE aktarımına döner. Windsurf aynı bloğu kendi MCP yapılandırma dosyasında kullanır.
{
"mcpServers": {
"getyoutubetranscript": {
"type": "streamableHttp",
"url": "https://getyoutubetranscript.com/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_..."
}
}
}
}Kullanılabilir araçlar
| Araç | Ne yapar | Maliyet |
|---|---|---|
get_youtube_transcript | Tam transkript artı başlık, yazar, küçük resim | 1 kredi |
get_transcript_languages | Bir videonun altyazı dilleri, manuel veya otomatik | 1 kredi |
search_youtube | Videolarda veya kanallarda arama, sayfalı | 1 kredi |
get_channel_latest_videos | Bir kanalın meta verileri ve son yüklemeleri | 1 kredi |
search_channel_videos | Bir kanal içinde arama | 1 kredi |
list_channel_videos | Bir kanalın yüklediği her video | 1 kredi |
list_channel_playlists | Bir kanalın oynatma listeleri, sayfa sayfa | 1 kredi |
list_channel_posts | Bir kanalın topluluk gönderileri, sayfa sayfa | 1 kredi |
get_related_videos | YouTube'un bir videonun yanında önerdiği videolar | 1 kredi |
get_channel_banner | Bir kanalın banner'ı ve avatarı | 1 kredi |
get_video_dislikes | Bir videonun tahmini beğeni ve beğenmeme sayıları | 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.
