MCP nedir? Claude Code'a Notion, GitHub ve tarayıcı bağlamak
MCP, Claude Code'u Notion, GitHub, veritabanı ve tarayıcı gibi araçlara bağlayan açık standart. Komutlarla kurulumu ve güvenlik kurallarını anlattık.

MCP (Model Context Protocol), yapay zekâ araçlarını dış servislere bağlamak için kullanılan açık kaynak bir standart. Claude Code'da `claude mcp add` komutuyla bir MCP sunucusu eklediğinde Claude o servisi doğrudan kullanabiliyor: Notion'da sayfa okumak, GitHub'da issue açmak, tarayıcıda test yapmak gibi. Sunucuyu sadece kendine, tüm projelerine ya da `.mcp.json` dosyasıyla bütün ekibe açabiliyorsun.
Claude Code kendi başına bilgisayarındaki dosyaları okuyup yazabiliyor. Ama Notion'daki proje notlarına, GitHub'daki açık işlere ya da şirketin veritabanına kendiliğinden ulaşamıyor. Bunları her seferinde kopyalayıp yapıştırmak da bir süre sonra yorucu oluyor.
MCP tam olarak bu boşluğu dolduruyor. Bir kez bağladığın servisi Claude doğrudan kullanıyor. Instagram'da anlattığımız Supabase, Vercel ve Chrome eklentilerinin çoğu da aslında birer MCP sunucusu. Bu yazıda MCP'nin ne olduğunu, nasıl kurulduğunu ve nelere dikkat etmen gerektiğini anlatıyoruz.
MCP ne demek?
MCP, Model Context Protocol'ün kısaltması. Claude Code belgesi onu "yapay zekâ ve araç entegrasyonları için açık kaynak bir standart" diye tanımlıyor.
En kolay benzetme USB. Bilgisayara fare, klavye ya da yazıcı takarken her biri için ayrı bir giriş aramıyorsun; hepsi aynı girişi kullanıyor. MCP de yapay zekâ araçları için ortak bir giriş. Bir servis için MCP sunucusu yazıldığında, MCP'yi destekleyen her araç o servise bağlanabiliyor.
Burada iki taraf var. Claude Code istemci, yani bağlanan taraf. MCP sunucusu ise servisi temsil eden küçük bir program. Sunucu, Claude'a "şu işleri yapabilirim" diye bir liste veriyor: sayfa oku, kayıt ekle, ekran görüntüsü al gibi. Claude da işi yaparken bu listeden uygun olanı çağırıyor.
Neler bağlanabilir?
Belgede örnek olarak Notion ve Airtable geçiyor, ama liste çok daha uzun. Pratikte en çok kullanılanlar şu gruplara ayrılıyor.
Not ve proje araçları: Notion, Linear, Jira gibi servislerde Claude görevleri okuyup güncelleyebiliyor. "Bu haftaki açık işleri getir, en acil olanla başla" gibi bir istek mümkün hâle geliyor.
Kod ve yayın: GitHub, Supabase ve Vercel gibi servislerde Claude issue açabiliyor, veritabanı tablosuna bakabiliyor ya da son yayının durumunu kontrol edebiliyor.
Tarayıcı: Playwright ve Chrome DevTools sunucularıyla Claude bir sayfayı gerçekten açıp tıklayabiliyor, hata mesajlarını okuyabiliyor. Yaptırdığın sitenin telefonda bozulup bozulmadığını kendisi kontrol ediyor.
Arama ve araştırma: Web araması ya da sayfa okuma sunucuları Claude'a güncel bilgi getiriyor. Beş kişilik yapay zekâ ekibi videosunda anlattığımız kurulum bu tür sunuculardan oluşuyor.
Nasıl kurulur?
MCP sunucuları iki şekilde çalışıyor. Uzak sunucu internette duruyor ve bir adresle bağlanıyorsun. Yerel sunucu ise senin bilgisayarında küçük bir program olarak çalışıyor.
Uzak sunucu eklemek için komutun yapısı şöyle:
claude mcp add --transport http <ad> <adres>
Belgedeki gerçek örnek Notion:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Yerel sunucu için komutun sonunda, sunucuyu çalıştıracak komut geliyor. Araya konan iki tire, Claude Code'un kendi ayarlarını sunucunun komutundan ayırıyor:
claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server
Bazı sunucular bir erişim anahtarı istiyor. Bunu --env ile veriyorsun. Anahtarı hiçbir zaman bir sohbete ya da herkese açık bir dosyaya yazma; sadece bu komutta ya da kendi bilgisayarındaki ayar dosyasında kalsın.
Kurduktan sonra Claude Code'u açıp /mcp yaz. Sunucuların çalışıp çalışmadığını burada görüyorsun. Notion gibi giriş isteyen servislere bağlanma adımı da bu ekrandan yapılıyor.
Kime açık olacağını seç
Bir sunucuyu eklerken kimlerin kullanacağını --scope ile belirliyorsun. Üç seçenek var.
Varsayılan seçenek local. Sunucu sadece sana ve sadece o projede açık. Denemeler için en güvenli seçim bu.
user seçeneği sunucuyu bütün projelerinde kullanılabilir yapıyor. Her projede işine yarayan bir tarayıcı sunucusu için mantıklı.
project seçeneği ise proje klasörüne .mcp.json adında bir dosya yazıyor. Bu dosyayı projeyle birlikte paylaştığında ekipteki herkes aynı sunucuları kullanıyor:
claude mcp add --transport http ortak-sunucu --scope project https://example.com/mcp
Eklediklerini görmek ve temizlemek için:
claude mcp list
claude mcp get notion
claude mcp remove notion
İlk denemen için öneri
Hiç MCP kullanmadıysan tarayıcı sunucusuyla başlamak iyi bir fikir, çünkü sonucu hemen gözünle görüyorsun. Bir tarayıcı sunucusu ekledikten sonra Claude Code'a şunu yazabilirsin:
index.html sayfasını tarayıcıda aç, telefon genişliğinde ekran görüntüsü al ve taşan ya da üst üste binen bir şey varsa düzelt.
Claude sayfayı açıyor, görüntüye bakıyor, sorunu buluyor ve kodu düzeltiyor. Bu döngüyü elle yapmak dakikalar sürüyor.
İkinci adım olarak günlük işinde en çok kopyala yapıştır yaptığın servisi düşün. Notlarını Notion'da tutuyorsan Notion sunucusu, kodunu GitHub'da tutuyorsan GitHub sunucusu en hızlı faydayı sağlar. Bağladıktan sonra Claude'a önce sadece okuma isteyen küçük bir iş ver, örneğin "bu sayfadaki açık maddeleri listele". Sonuç doğruysa yazma gerektiren işlere geç.
Bir sunucu beklediğin gibi çalışmazsa önce /mcp ekranında durumuna bak. Sunucu kırmızı görünüyorsa çoğu zaman eksik bir anahtar, yanlış yazılmış bir adres ya da bilgisayarda kurulu olmayan bir program sorun çıkarıyor. Hata mesajını olduğu gibi Claude'a yapıştırıp ne yapman gerektiğini sormak da çoğu durumda işe yarıyor.
Sunucu sayısını az tut. Her sunucu Claude'a bir araç listesi veriyor ve bu liste bağlamda yer kaplıyor. Kullanmadığın sunucuları kaldırmak hem Claude'un doğru aracı seçmesini kolaylaştırıyor hem de kullanım limitinin daha geç dolmasına yardım ediyor.
Güvenlikte dikkat edilecekler
Claude Code belgesi açık bir uyarı yapıyor: bağlamadan önce her sunucuya güvendiğinden emin ol. Dışarıdan içerik çeken sunucular, bir web sayfasına gizlenmiş talimatlarla Claude'u yanlış bir işe yönlendirebiliyor. Buna prompt enjeksiyonu deniyor.
Pratikte üç kural yeterli. Sunucuyu servisin kendi sayfasından ya da çok kullanılan, kaynağı belli bir depodan al. Veritabanı gibi hassas servislerde mümkünse sadece okuma yetkisi olan bir anahtar kullan. Claude bir şeyi silmek ya da göndermek istediğinde onay ekranını okumadan geçme. Yapay zekâya hangi bilgileri vermemen gerektiğini merak ediyorsan bu konudaki rehberimize göz at.
Bizim yorumumuz
MCP, Claude Code'u kod yazan bir araçtan işini gerçekten yapan bir yardımcıya çeviren parça. Bizim tecrübemizde en büyük fark tarayıcı sunucusunda ortaya çıkıyor: Claude yazdığı sayfayı kendi gözüyle kontrol edince "bende çalışıyor" hataları ciddi biçimde azalıyor. Buna karşılık her yeni sunucu yeni bir kapı demek. Bütün sunucuları bir anda kurmak yerine bir ihtiyaç için bir sunucu ekle, işe yaramıyorsa kaldır. Claude Code'u yeni kurduysan önce kurulum rehberimizden temel adımları geç, MCP'yi sonra ekle.
Bilgiler 29 Ekim 2026 itibarıyla Claude Code belgesinden. Bu yazı sponsorlu değildir.
Sık sorulanlar
MCP ile skill arasındaki fark ne?
Skill, Claude'a bir işin nasıl yapılacağını anlatan talimat ve dosya paketi. MCP ise Claude'u dışarıdaki bir servise bağlayan kablo. Skill bilgi verir, MCP erişim verir. İkisi birlikte de kullanılabiliyor.
MCP sunucusu ücretli mi?
Standardın kendisi ücretsiz ve açık kaynak. Sunucuların çoğu da ücretsiz, ama bağlandığın servisin (örneğin Notion ya da bir veritabanı) kendi hesabı ve fiyatı geçerli.
Eklediğim sunucuları nasıl görürüm?
Terminalde `claude mcp list` hepsini listeler, `claude mcp remove <ad>` siler. Claude Code içindeyken `/mcp` yazarak sunucuların durumunu görebilir ve giriş isteyen servislere bağlanabilirsin.
Her MCP sunucusu güvenli mi?
Hayır. Claude Code belgesi, bağlamadan önce sunucuya güvendiğinden emin olmanı istiyor. Dışarıdan içerik çeken sunucular, sayfaya gizlenmiş talimatlarla Claude'u yanlış yönlendirebilir. Kaynağı belli, çok kullanılan sunucularla başla.
ChatGPT ya da Cursor da MCP kullanıyor mu?
MCP açık bir standart olduğu için birçok araç destekliyor. Bir servis için yazılmış MCP sunucusu genellikle farklı araçlarda da çalışıyor; kurulum komutu araca göre değişiyor.
Haftada bir e-posta. Sadece işe yarayanlar.
Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.
Claude MCP bağlantı hataları nasıl çözülür?











