MCP nedir, ne işe yarar? Model Context Protocol rehberi
MCP (Model Context Protocol), yapay zeka uygulamalarını dış araç, veri kaynağı ve iş akışlarına bağlayan açık kaynaklı bir standarttır. Araç bir kez sunucu olarak tanımlanır; Claude Code, Cursor ve Codex gibi protokolü destekleyen her istemci onu kullanabilir. Kurulumda asıl mesele yetenek değil yetki: hangi sunucunun neye erişebildiği açıkça sınırlanmalıdır.
Bir yapay zeka modelinin işe yarar hâle gelmesi, dış dünyaya dokunabilmesine bağlıdır. Dosyayı okuyamayan, veritabanına bakamayan bir model metin üretir; iş yapmaz. Bu bağlantıyı kurmanın standart hâline gelen yolun adı MCP.
Bu yazı MCP'nin çözdüğü problemi, sunucu ve istemci ayrımını, hangi işlerde fark yarattığını ve kurulumda dikkat edilmesi gereken güvenlik noktalarını anlatıyor.
MCP ne demek, açılımı nedir?
MCP, Model Context Protocol ifadesinin kısaltmasıdır; Türkçede çoğunlukla İngilizce adıyla anılır. Resmi sitesi onu yapay zeka uygulamalarını dış sistemlere bağlamak için açık kaynaklı bir standart olarak tanımlıyor ve USB-C benzetmesini kullanıyor: USB-C elektronik cihazları nasıl ortak bir kapıyla bağlıyorsa MCP de yapay zeka uygulamalarını dış sistemlere ortak bir kapıyla bağlar. Protokol üç tür şey sunabilir: veri kaynakları (yerel dosyalar, veritabanları), araçlar (arama motoru, hesap makinesi) ve iş akışları (özel istemler). Konuya yeni başlıyorsan önce LLM nedir yazısına, ajan tarafı için yapay zeka ajanı nedir yazısına göz at.
Google Ads verisine göre Ekim 2026'da Türkiye'de "mcp nedir" ifadesi ayda ortalama 1.900 kez aranıyor; "claude mcp" 390, "mcp ne demek" 170 ve "claude code mcp" 170 aramayla onu izliyor. Sıfırdan Sistem'in 9 Ekim 2026 ölçümünde "mcp nedir" aramasında Google'ın AI Özeti ile "Diğer kullanıcılar şunları da sordu" kutusu birlikte çıktı. Bu yüzden aşağıdaki bölümler her sorunun cevabını ilk cümlede veriyor.
Çözdüğü problem
MCP'den önce her bağlantı özeldi. Bir modeli takvime bağlamak için o modele özgü bir tümleştirme yazılırdı; başka bir modele geçildiğinde aynı iş baştan yapılırdı. Araç sayısı ile model sayısı çarpıldığında ortaya çıkan iş yükü, küçük ekipler için sürdürülemezdi.
MCP bu çarpımı toplama çevirir. Araç bir kez sunucu olarak tanımlanır; protokolü destekleyen her istemci onu kullanabilir. Yeni bir model geldiğinde araçlar yeniden yazılmaz.
Bu, kendi aracını kurmak isteyen biri için doğrudan bir kazançtır: aracı bir kez yazarsın, bağlayacağın yer değişse de araç kalır.
Sunucu ve istemci
Sunucu, bir yeteneği dışarıya açan taraftır: dosya sistemi, bir veritabanı, bir hizmetin arayüzü ya da kendi yazdığın bir betik. Sunucu, hangi işlemleri sunduğunu ve her işlemin hangi girdileri beklediğini bildirir.
İstemci, modelin çalıştığı ortamdır. İstemci sunucuya bağlanır, sunulan işlemleri modele tanıtır ve model bir işlemi çağırdığında isteği sunucuya iletir.
Model, sunucunun nasıl çalıştığını bilmez; yalnızca hangi işlemlerin var olduğunu ve ne beklediklerini bilir. Bu ayrım, aynı ajanın farklı ortamlarda aynı şekilde çalışmasını sağlar.
Hangi işlerde fark yaratır?
Kendi verinle çalışmak. Modelin senin dosyalarını, tablonu ya da veritabanını görmesi gerekiyorsa, her seferinde kopyala yapıştır yapmak yerine kaynağı bağlarsın.
Çok adımlı işler. Bir işin farklı adımları farklı kaynaklara dokunuyorsa, araçların tek tip arayüzde toplanması akışı basitleştirir.
Tekrarlanan üretim. Aynı işi her hafta yapıyorsan, araç bağlantısının kalıcı olması döngü kurmayı mümkün kılar.
Fark yaratmadığı yer de nettir: tek seferlik, kaynak gerektirmeyen metin işlerinde ek bir katman kurmanın getirisi yoktur.
Güvenlik: asıl mesele yetki
Bir aracın bağlanması, ona ne yapabileceğini vermek demektir. Bu yüzden kurulumda sorulacak soru “ne yapabilir” değil, “ne yapmamalı” olmalıdır.
- Erişim alanını daralt. Dosya sistemine tüm diski değil, çalıştığın klasörü aç.
- Yazma yetkisini ayır. Okuma ile yazma farklı risklerdir; okuma yeterliyse yazma verme.
- Kimlik bilgilerini ayrı tut. Anahtarlar talimat dosyasında değil, ortam değişkenlerinde durur.
- Kaynağı bilinmeyen sunucu kurma. Bir sunucu, bağlandığı ortamda çalışan koddur; güvenilmeyen kaynak, güvenilmeyen kod demektir.
Ek olarak: modele dışarıdan gelen metin (bir web sayfası, bir dosya içeriği) veri olarak okunmalı, talimat olarak değil. Bu ayrımı korumak, araç katmanının en kritik disiplinidir.
Hangi araçlarla başlanır?
Protokolü destekleyen çok sayıda hazır sunucu var; hepsini birden bağlamak yerine işine göre bir tanesiyle başlamak daha hızlı sonuç verir.
Dosya sistemi. En sık kullanılan ve en çok kazandıran ilk bağlantıdır: ajan belgelerini okur, çıktıyı doğrudan dosyaya yazar. Erişimi tek bir çalışma klasörüyle sınırla.
Veritabanı ya da tablo. Raporlama ve analiz işlerinde, veriyi her seferinde kopyalamak yerine kaynağı bağlamak hem hızlı hem tutarlıdır.
Takvim ve e-posta. Günlük operasyona dokunur; ancak kişisel veri taşıdığı için yetki ve saklama kurallarının önceden yazılmış olması gerekir.
Kendi betiğin. Şirkete özgü bir işi yapan küçük bir betiği sunucu olarak tanımlamak, hazır sunuculardan çoğu zaman daha çok iş görür; çünkü yaptığı iş tam olarak senin işindir.
Claude Code'a MCP sunucusu nasıl eklenir?
Kurulum, resmi dokümana göre tek satırlık bir komuttur. Sunucunun türüne göre iki yol var: uzakta çalışan (http) sunucular ve bilgisayarında çalışan (stdio) sunucular.
| Sunucu türü | Komut |
|---|---|
| Uzak sunucu (http) | claude mcp add --transport http github https://api.githubcopilot.com/mcp/ |
| Yerel sunucu (stdio) | claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server |
| Ekiple paylaşılan kapsam | claude mcp add --transport http shared-server --scope project https://example.com/mcp |
Ekim 2026 itibarıyla Claude Code'un resmi dokümanı dört bağlantı türü sayıyor: http (uzak sunucular için önerilen), stdio (yerel süreç), websocket ve kullanımdan kalkmış olarak işaretlenen sse. Bağlantı üç kapsamdan birine kaydedilir: yalnız bu proje için geçerli varsayılan yerel kapsam, ekiple paylaşılan ve proje kökündeki .mcp.json dosyasında duran proje kapsamı ya da tüm projelerinde geçerli kullanıcı kapsamı. Ayrıntılı kullanım için Claude Code kurulumu ve Claude Code nasıl kullanılır yazılarına bak. Kurulu sunucuları görmek için claude mcp list, oturum içinde bağlantı durumunu kontrol etmek için /mcp komutu kullanılır.
Cursor ve Codex'e MCP nasıl eklenir?
Cursor'da bir JSON dosyasına, Codex'te bir komuta ya da TOML dosyasına sunucu tanımı yazarak eklenir; Claude Code'daki gibi her araç aynı protokolü konuşur, yalnız ayar yeri değişir. Ekim 2026 itibarıyla üç aracın resmi dokümanındaki yollar aşağıdaki tabloda.
| Araç | Ayar dosyası | Ekleme yolu | Bağlantı türleri |
|---|---|---|---|
| Claude Code | .mcp.json (proje), ~/.claude.json (yerel ve kullanıcı) | claude mcp add --transport http <ad> <adres> | http, stdio, websocket; sse kullanımdan kalkmış |
| Cursor | .cursor/mcp.json (proje), ~/.cursor/mcp.json (genel) | Dosyaya mcpServers bloğu yazmak ya da Marketplace'te "Add to Cursor" demek | stdio, SSE, Streamable HTTP |
| Codex | ~/.codex/config.toml ya da projedeki .codex/config.toml | codex mcp add <ad> -- npx -y <paket> | stdio, Streamable HTTP |
Cursor'a MCP sunucusu eklemek için adımlar şunlar:
- Dosyayı seç. Yalnız bu proje için
.cursor/mcp.json, her projede geçerli olsun istiyorsan~/.cursor/mcp.json. - Sunucuyu tanımla. Yerel bir Node sunucusu için blok şöyle:
{"mcpServers": {"sunucu-adi": {"command": "npx", "args": ["-y", "mcp-server"]}}}. Uzak sunucudacommandyerine"url"yazılır. - Anahtarı dosyaya gömme. Cursor
${env:AD}biçiminde ortam değişkeni yazmana izin veriyor; gizli anahtarı düz metin olarak yazma. - Bağlantıyı dene. Sunucu listede göründükten sonra ajana o aracı kullanacağı küçük, okuma amaçlı bir iş ver.
Codex'e MCP sunucusu eklemek için örnek komut resmi dokümanda codex mcp add context7 -- npx -y @upstash/context7-mcp biçiminde geçiyor. Doküman, ChatGPT masaüstü uygulaması, Codex CLI ve IDE eklentisinin aynı yapılandırmayı paylaştığını söylüyor: bir kez kurunca üçünde de kullanırsın. Araçların kendisi için Cursor nedir ve Codex nedir yazılarına bak. Resmi sayfalar: MCP tanıtımı, Claude Code, Cursor, Codex.
En çok kullanılan MCP sunucuları
| Sunucu | Ne yapar | Dikkat edilecek risk |
|---|---|---|
| GitHub (resmi) | Kod incelemesi, PR açma, issue okuma | Yazma yetkisi verirsen depoya commit atabilir |
| Playwright (Microsoft, resmi) | Tarayıcıyı açar, tıklar, form doldurur, ekran görüntüsü alır | Gerçek bir tarayıcı oturumunu yönetir; yanlış siteye giriş yaptırabilir |
| Figma Dev Mode (resmi) | Tasarımdaki bileşen ve değişkenleri koda aktarır | Yalnızca okur; tasarım dosyasına yazmaz |
| Google Drive, Notion | Belge arama, okuma, bazı kurulumlarda düzenleme | Kişisel ya da şirket verisine erişir |
| Stripe (resmi) | Ödeme kaydı oluşturma, fatura sorgulama | Gerçek para hareketine bağlanabilir; önce test anahtarıyla dene |
| Veritabanı (Postgres vb.) | Tabloya SQL sorgusu çalıştırır | Salt okunur bağlantı olmadan veri silinebilir |
MCP, Anthropic tarafından Kasım 2024'te açık kaynak olarak duyuruldu; resmi site Ekim 2026 itibarıyla Claude, ChatGPT, Visual Studio Code ve Cursor'ın aralarında olduğu geniş bir istemci yelpazesinin protokolü desteklediğini belirtiyor. Playwright MCP, Microsoft'un kendi deposunda Apache lisansıyla yayımlanıyor ve ekran görüntüsü yerine erişilebilirlik ağacını okuduğu için görsel bir modele ihtiyaç duymuyor. Figma'nın resmi Dev Mode MCP sunucusu ise tasarım dosyasındaki bileşen ağacını ve değişkenleri doğrudan koda aktarıyor; "google search console mcp" gibi aramalarda çıkan sonuçların çoğu resmi değil, bağımsız topluluk projesidir; kurmadan önce kaynağını mutlaka kontrol et.
MCP ile API farkı ne?
API bir hizmetle konuşmak için yazılımcının kodla kurduğu kapıdır; MCP ise yapay zeka uygulamasının o kapıyı kendi başına tanıyıp kullanabilmesi için üstüne konan ortak arayüzdür. İkisi rakip değildir: çoğu MCP sunucusu arkada bir hizmetin API'sini çağırır.
| Ölçüt | Doğrudan API | MCP sunucusu |
|---|---|---|
| Kim kullanır | Kodu yazan geliştirici | Yapay zeka uygulaması (istemci) |
| Bağlantıyı kim kurar | Her model ve her uygulama için ayrı kod | Sunucu bir kez yazılır, her istemci aynı biçimde bağlanır |
| İşlemleri kim öğrenir | Geliştirici dokümandan okur | Sunucu işlemlerini ve beklediği girdileri istemciye bildirir |
| Ne zaman seçilir | Sabit, kodla yazılmış bir akış varsa | Modelin hangi aracı ne zaman çağıracağına kendisi karar vermesi isteniyorsa |
Pratik sonuç: işi her seferinde aynı sırayla yapan bir betik yazıyorsan doğrudan API yeterli olabilir. Modelin duruma göre araç seçmesini istiyorsan MCP anlamlıdır.
MCP ile skill farkı ne?
İkisi de Claude Code'u genişletir ama farklı bir problemi çözer. MCP bir araç sağlayıcısıdır: dış bir sisteme (dosya, veritabanı, servis) bağlanma yolunu tanımlar. Skill ise tekrar eden bir talimatı paketler: nasıl çalışılacağını ve hangi adımların izleneceğini anlatan bir SKILL.md dosyasıdır, gerektiğinde MCP'nin sağladığı araçları kendi içinde çağırır.
| Ölçüt | MCP sunucusu | Skill |
|---|---|---|
| Ne sağlar | Dış sisteme bağlantı (araç) | Tekrar eden talimat ve yöntem |
| Kurulum | claude mcp add ile bağlanır | SKILL.md dosyası olarak klasöre konur |
| Elinde kalan | Araç çağrısı bitince bir şey tutmaz | Talimat, sonraki oturumda da aynı kalır |
| Örnek | GitHub deposuna bağlanmak | Her yeni PR'da aynı 5 kontrolü yapan talimat |
Pratik kural şudur: dışarıdaki bir sisteme erişim gerekiyorsa MCP kur, tekrar eden bir işi aynı adımlarla yürütmek gerekiyorsa skill yaz. Ciddi kurulumlarda ikisi birlikte çalışır; skill, MCP'nin açtığı aracı hangi sırayla çağıracağını tarif eder. Ayrıntısı Claude Skills nedir yazısında.
MCP kimin için yanlış?
MCP, tek seferlik ve kaynak gerektirmeyen metin işleri için gereksiz bir katmandır. Dört durumda kurmadan önce dur:
- Güvenmediğin sunucu. Claude Code dokümanı, her sunucuya bağlanmadan önce güvenini doğrulamanı söylüyor; dış içerik çeken sunucular istem enjeksiyonu riskini artırabilir.
- Kişisel ve müşteri verisi. Veritabanı ya da posta kutusunu bağladığında o veri modelin bağlamına girer. Önce planının veriyi nasıl işlediğine bak: yapay zekaya verdiğim veriler ne oluyor?
- Terminalden kaçınanlar. Hazır sunucu kurulumu bile bir komut ya da JSON dosyası ister. Bu sana ağır geliyorsa terminal gerektirmeyen araçlarla başla; seçenekler için yapay zeka araçları rehberine bak.
- Yazma yetkisiyle başlayanlar. İlk haftada salt okunur bağlan; yazma yetkisini ancak çıktıyı denetleyebildiğinde aç.
Başlarken doğru sıra
Araç bağlamak, ihtiyaçtan sonra gelir. Sıra şudur:
- İşi elle yap ve hangi kaynağa kaç kez dokunduğunu say.
- En çok dokunulan kaynağı belirle; bağlanacak ilk araç odur.
- Yalnızca o aracı bağla ve iki hafta çalıştır.
- İkinci aracı ancak birincisi yerleştiğinde ekle.
Aynı anda beş araç bağlamak, hangisinin işe yaradığını görmeyi imkânsız kılar ve hata ayıklamayı zorlaştırır. 90 günlük yol haritası bu kademeli kurulum mantığını daha geniş ölçekte anlatıyor.
Sık sorulan sorular
MCP ne anlama geliyor?
Model Context Protocol'ün kısaltmasıdır. Yapay zeka modellerinin dış araç ve veri kaynaklarına bağlanma biçimini standartlaştıran açık bir protokoldür; araç bir kez sunucu olarak tanımlanır, protokolü destekleyen her istemci onu kullanabilir.
MCP kullanmak için yazılımcı olmak gerekir mi?
Hazır sunucuları bağlamak için gerekmez; kurulum çoğunlukla bir yapılandırma dosyasına birkaç satır eklemekten ibarettir. Kendi aracını sunucu olarak yazmak ise temel düzeyde programlama gerektirir.
MCP sunucusu kurarken en önemli güvenlik kuralı nedir?
Erişim alanını daraltmak. Dosya sistemine tüm diski değil yalnızca çalışılan klasörü açmak, okuma yeterliyken yazma yetkisi vermemek ve kimlik bilgilerini talimat dosyası yerine ortam değişkenlerinde tutmak temel kurallardır.
MCP sunucusu kurmak için hangi komut yazılır?
Uzak sunucular için claude mcp add --transport http <isim> <adres>, yerelde çalışan sunucular için claude mcp add --transport stdio <isim> -- <komut> yazılır. Kurulu sunucular claude mcp list ile görülür.
MCP ile skill aynı şey mi?
Hayır. MCP dış bir sisteme bağlanma yoludur, skill ise tekrar eden bir işin talimatını paketleyen dosyadır. Genelde birlikte çalışırlar: skill, MCP'nin açtığı aracı hangi sırayla kullanacağını tarif eder.
Cursor ve Codex'te MCP kullanılır mı?
Evet, ikisi de MCP'yi destekliyor. Cursor sunucuyu .cursor/mcp.json dosyasından, Codex config.toml dosyası ya da codex mcp add komutuyla okur; ayrıntı yukarıdaki tabloda. Aynı sunucu üç araçta da çalışır, yalnız ayar yeri değişir.
Araç katmanını sıfırdan kurmak yerine
Yazıda anlatılan araç katmanı mantığı, dört üretim ajanının talimat dosyalarında kurulu hâlde. Tek seferlik lisans, abonelik yok; her ay yama ve güncellemeler e-postana gelir.
Profil Paketleri · 3 Ajan · Satın al 4 ajanın tamamını gör