MCP Server Nedir? Model Context Protocol Rehberi

MCP server nedir sorusuna beş geliştiriciden beş ayrı cevap alırsınız: eklenti, API sarmalayıcı, yapay zeka ajanı, container, yapılandırma dosyasına yapıştırılan JSON bloğu. Bunlardan yalnızca biri gerçeğe yakın.

Kısa cevap: MCP server, yapay zeka uygulamalarına tools, resources ve prompt şablonlarını Model Context Protocol üzerinden açan bir programdır. Protokol, JSON-RPC 2.0 üzerine kurulu açık bir standarttır ve Anthropic tarafından Kasım 2024'te yayımlanmıştır. MCP uyumlu her client, MCP uyumlu her server'ı çağırabilir.

Bu tanım kısa olduğu için işe yarar, ama ilginç soruları da açık bırakır. Server tam olarak neyi açar? Onunla kim konuşur? Kendi bilgisayarınızda mı çalışır, yoksa bir yerde duran bir makinede mi? Bu rehber bunları sırayla ele alıyor, çoğu anlatımın atladığı soru dahil: bir MCP server, sizden başka birinin de kullanması gerektiğinde nerede çalışır?

MCP server nedir?

MCP, "Model Context Protocol" ifadesinin kısaltmasıdır. Protokol bir mesaj biçimi ve küçük bir isimli metot kümesi tanımlar. MCP server ise bu sözleşmenin server tarafını uygulayan herhangi bir programdır.

Tanımın bu kadar dar olması kasıtlıdır. Bir MCP server'ın içinde model bulunmaz. Karar vermez. Yapabildiği şeylerin listesini yayımlar, bir client bunlardan birini çağırana kadar bekler, çağrıyı çalıştırır ve yapılandırılmış bir sonuç döner. Akıl yürütme yapay zeka uygulamasında kalır, çalıştırma server'da olur.

MCP server, bir yapay zeka uygulamasının çağırabileceği araçları ve okuyabileceği verileri açık bir protokol üzerinden yayımlayan bağımsız bir programdır. İçinde model yoktur, karar vermez; yalnızca kendisine söyleneni çalıştırır ve sonucu döner.

Hat üzerinde MCP, JSON-RPC 2.0 kullanır. Bu, kod editörlerinin kullandığı Language Server Protocol ile aynı istek ve yanıt biçimidir. Seçim tesadüfi değildir. LSP benzer bir sorunu çözmüştü: her editörün her dil için ayrı destek yazması yerine, her dil bir server, her editör bir client yazdı. MCP aynı kalıbı, yapay zeka uygulamaları ile bunların ulaşması gereken sistemler arasında kuruyor.

Anthropic protokolü 25 Kasım 2024'te Model Context Protocol duyurusuyla açık kaynak olarak yayımladı. 9 Aralık 2025'te ise MCP'yi Linux Foundation çatısı altındaki Agentic AI Foundation'a bağışladı; protokol vakfın kurucu projelerinden biri oldu. Vakfı Anthropic, Block ve OpenAI birlikte kurdu, Google, Microsoft, AWS, Cloudflare ve Bloomberg destek verdi. Spesifikasyon ve resmi SDK'lar MIT lisanslıdır.

Bağış sırasında Anthropic, 10.000 aktif public MCP server ve resmi SDK'larda ayda 97 milyonun üzerinde indirme bildirdi. MCP hakkında başka ne söylenirse söylensin, artık bir deney değil.

MCP neden ortaya çıktı? N × M entegrasyon problemi

MCP'den önce bir yapay zeka uygulamasını dış bir sisteme bağlamak, her seferinde özel bir entegrasyon yazmak demekti. Her uygulamanın her araç için kendi bağlayıcısı, her araç sağlayıcısının da her uygulama için ayrı bir bağlayıcısı gerekiyordu.

N × M problemi tam olarak budur. Altı yapay zeka uygulaması ve on iki araç varsa, yetmiş iki ayrı entegrasyon çıkar. Her birinin kendi kimlik doğrulaması, kendi hata davranışı ve kendi bakım yükü olur. Listeye bir araç daha eklediğinizde altı bağlayıcı daha yazarsınız.

MCP bu çarpmayı toplamaya çevirir. Her yapay zeka uygulaması tek bir MCP client uygular. Her araç tek bir MCP server yayımlar. Altı client artı on iki server, yetmiş iki yerine on sekiz parça yazılım eder ve on üçüncü aracı eklemenin bedeli, mevcut tüm client'ların zaten kullanabileceği tek bir yeni server olur.

Bu, MCP'nin en çok tekrarlanan anlatımıdır ve ayakta kalmasının nedeni teknik bir tercihi değil ekonomik bir gerçeği anlatmasıdır. Protokol, özel bir HTTP entegrasyonundan daha hızlı veya daha zekice değildir. Sadece N kez yerine bir kez yazılır.

MCP server ne işe yarar?

Bir server üç tür şey sunar. Aralarındaki asıl fark ne yaptıkları değil, ne zaman kullanılacağına kimin karar verdiğidir. Çoğu anlatımın atladığı ayrım da budur.

Tools, insanlar "MCP server" dediğinde genellikle kastettikleri şeydir. Her aracın bir adı, bir açıklaması ve girdilerini tarif eden bir JSON Schema'sı vardır. Model, aracın ne zaman uygun olduğuna ve nasıl çağrılacağına bu tanıma bakarak kendisi karar verir. Client'lar araçları tools/list ile keşfeder ve tools/call ile çalıştırır.

Resources pasiftir. file:///docs/runbook.md gibi bir URI ile ya da crm://customers/{id} gibi bir şablonla adreslenir. Neyin okunacağına ve ne kadarının modelin önüne konacağına uygulama karar verir. İlgili metotlar resources/list ve resources/read'dir.

Prompts ise kullanıcının açıkça seçtiği şablonlardır. Genellikle ana uygulamada slash komutu olarak görünürler. İlgili metotlar prompts/list ve prompts/get'tir.

Host, client ve server nasıl bir arada çalışır?

MCP dokümanlarında sürekli geçen üç terim var ve birbirlerinin yerine kullanılamazlar.

Host, yapay zeka uygulamasının kendisidir. Claude Desktop, bir IDE, bir sohbet ürünü ya da kurum içinde yazdığınız bir ajan olabilir. Konuşmanın da modelin de sahibi host'tur.

Client, host'un içindeki bağlayıcıdır. Host, bağlandığı her server için bir client oluşturur ve her client tek bir bağlantıyı yürütür. IDE'niz üç MCP server'a bağlıysa, üç client çalıştırıyor demektir.

Server ise sizin programınızdır. Karşı uçta hangi modelin olduğunu bilmez ve bilmesine gerek de yoktur.

Bunun pratik sonucu şudur: server'lar bir sağlayıcıya bağlı değildir. Claude Desktop'ın bağlandığı server'ı bir IDE de, kurum içi bir ajan da, düz bir script de kullanabilir, çünkü hepsi aynı protokolü konuşur. Server'ı bir kez yazarsınız, uyumlu her host onu çağırabilir hale gelir.

MCP server nasıl yazılır?

Bir araç tanımlamak çok az kod ister. Aşağıdaki, resmi Python SDK'sı ile yazılmış eksiksiz bir server:

from mcp.server import MCPServer

mcp = MCPServer("Destek Araçları")


@mcp.tool()
def siparis_getir(siparis_no: str) -> dict:
    """Sipariş numarasına göre durumu ve ürün adedini döner."""
    return {"no": siparis_no, "durum": "kargoda", "adet": 3}

Docstring, modelin okuduğu araç açıklamasına dönüşür. Tip ipuçları, client'ın doğrulama için kullandığı JSON Schema'ya dönüşür. Sözleşmenin tamamı budur. Kurulum da tek satırdan ibaret:

# Python
pip install "mcp[cli]"

# TypeScript
npm install @modelcontextprotocol/sdk

Bir client bu aracı çağırdığında hat üzerinden geçen mesaj sıradan bir JSON-RPC isteğidir:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "siparis_getir",
    "arguments": { "siparis_no": "A-10482" },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": { "name": "ornek-client", "version": "1.0.0" }
    }
  }
}

Burada olağandışı hiçbir şey olmuyor. Protokolün bu kadar hızlı yayılmasının önemli bir nedeni de bu.

Dil seçimi konusunda kısıt yok. JSON'u bir akış üzerinden okuyup yazabilen ya da HTTP servisi verebilen her dil işe yarar. Pratikte çoğu kişi resmi bir SDK kullanır ve modelcontextprotocol GitHub organizasyonunda on adet resmi SDK bulunur. TypeScript, Python, C#, Go ve Rust birinci kademede; Java ve Ruby ikinci, Swift, PHP ve Kotlin üçüncü kademede yer alır. Bazıları ilgili ekosistemin sahipleriyle birlikte geliştirilir: Go SDK'sı Google, C# SDK'sı Microsoft, Java SDK'sı Spring AI, Kotlin SDK'sı JetBrains ile.

Gerçek bir client bağlamadan önce server'ı elle kurcalamak isterseniz, resmi MCP Inspector tam olarak bunun için var.

Yerel (stdio) ve uzak (HTTP) MCP server farkı

Spesifikasyon iki standart transport tanımlar ve aralarındaki seçim, server'ı nasıl işleteceğinizi neredeyse tümüyle belirler.

stdio, client'ın server'ınızı bir alt süreç olarak başlatıp standart girdi ve çıktı üzerinden satır sonuyla ayrılmış JSON alışverişi yapması demektir. Ağ yok, port yok, URL yok.

Streamable HTTP ise server'ınızın sıradan bir web servisi olması demektir. Her mesaj tek bir endpoint'e giden bir HTTP POST'tur, yanıtlar ya düz JSON nesnesi olarak ya da isteğe özel bir Server-Sent Events akışı olarak döner. Bu transport, 2025-03-26 sürümünde eski HTTP+SSE transport'unun yerini aldı ve HTTP+SSE artık resmen kullanımdan kaldırılmış sayılıyor.

Neredeyse her MCP server hayata stdio ile başlar, çünkü örneklerin gösterdiği yol budur ve çalışan bir araca en hızlı ulaşma biçimidir. HTTP'ye geçiş, ikinci bir kişinin aynı aracı kullanmak istediği ya da zamanlanmış bir işin gece üçte, siz uyurken çağrı yapması gerektiği anda gelir.

Transport değiştirmek genelde bir şeyi yeniden yazmayı gerektirmez. Aynı server dosyası her iki şekilde de çalışır:

# Yerel: client server'ı stdio üzerinden alt süreç olarak başlatır
uv run mcp dev server.py

# Uzak: aynı server, Streamable HTTP üzerinden servis edilir
uv run mcp run server.py --transport streamable-http

MCP server örnekleri: kimler yayınlıyor?

Aramalarda en çok karşılaşılan server'lardan bir kesit. Buradaki asıl mesele hangi araçları sunduklarından çok, hangi yetki kapsamıyla çalıştıkları.

Tablodan birkaç desen çıkıyor. Önemli kategorileri büyük ölçüde sağlayıcıların kendisi devraldı, en sağlam server'lar açık bir salt-okunur mod sunuyor ve yeni gelenler uzun ömürlü token tutan yerel süreçler yerine OAuth'lu barındırılan endpoint'ler olarak geliyor.

Hazır bir liste aramak yerine kaynağa gitmek isterseniz, projenin kendi dizini olan MCP Registry yayımlanmış server'lara bakılacak yerdir. Registry hâlâ önizleme aşamasında ve kendi deposu bozucu değişiklik ile veri sıfırlaması olabileceğini yazıyor, yani oraya yayımladığınız her şeyi değişebilir kabul edin.

MCP server güvenliğinde nelere dikkat etmeli?

Bir MCP server, import ettiğiniz bir kütüphane değildir. Sizin yetkilerinizle çalışan, kimlik bilgilerinizi tutan bir süreçtir ve onu ne zaman çağıracağına karar veren model, güvenilmeyen metin okuyor. Üç başlık pratikte işin çoğunu belirliyor.

Yetki kapsamı. Issue'larınızı okuyabilen bir server ile onları kapatabilen bir server çok farklı şeylerdir, force-push atabilen ise apayrı. Gerçek durumu değiştiren bir server açık bir salt-okunur mod sunmuyorsa, bu eksiklik başlı başına bir sinyaldir. GitHub'da --read-only, MongoDB'de --readOnly, Grafana'da --disable-write gibi anahtarlar tam da bunun için var.

Secret yönetimi. Token'ları ve API anahtarlarını koda ya da depoya koymayın. Bunlar ortam değişkeni olarak dışarıdan verilmeli, dar kapsamla üretilmeli ve gerektiğinde tek tek iptal edilebilmelidir. Yapılandırma dosyasına düz metin yazılmış kişisel erişim token'ı, o server'ı çalıştıran her makinede duruyor demektir. Spesifikasyonun token kuralı da nettir: bir MCP server, kendisi için verilmemiş hiçbir token'ı kabul etmemelidir.

Prompt injection. Aynı anda birden fazla server bağlıyken, birinden dönen içerik modelin bir diğerini çağırırken üzerine iş yaptığı girdiye dönüşür. Bu yüzden durumu değiştiren araçlarda insan onayı istemek ve hangi server'ları bir arada bağladığınıza dikkat etmek gerçek bir savunmadır. Kurulum yapmadan önce spesifikasyonun güvenlik en iyi uygulamaları belgesini baştan sona okumaya değer.

MCP server nerede çalışır?

Tanım yazılarının atladığı soru budur ve server'ınızın bir demo mu yoksa ekibinizin kullandığı bir araç mı olacağına karar veren de bu sorudur.

Bir stdio server aslında hiçbir yerde çalışmaz. Diskte duran ve client'ın gerektiğinde çalıştırdığı bir dosyadır. Deploy yoktur, URL yoktur, fatura yoktur. Ama paylaşılamaz, o makinenin başındaki insandan başkası çağıramaz ve süreç bittiğinde ortadan kalkar.

HTTP server ise sürekli çalışan sıradan bir web servisidir ve bunun getirdiği her şeye ihtiyaç duyar: bir makine, geçerli sertifikaya sahip public bir HTTPS adresi, kimlik bilgileri için ortam değişkenleri, bir araç çağrısı 500 döndüğünde bakabileceğiniz loglar ve ayakta kalan bir süreç. Çoğu MCP server küçüktür ve zamanının büyük kısmını çağrı bekleyerek geçirir, yani işlemci ihtiyacı mütevazıdır. İşletim ihtiyacı ise sıfır değildir. Yayına alma sürecinin genel mantığını deploy nedir yazısında, uygulamanızı taşınabilir bir pakete koymanın nasıl çalıştığını ise Docker nedir yazısında bulabilirsiniz.

Out Plane bu tür bir işi sıradan bir uygulama gibi çalıştırır. Bir GitHub deposunu ya da container image'ını bağlarsınız, server'ınızın dinlediği portu belirtirsiniz, kimlik bilgilerinizi ortam değişkeni olarak eklersiniz ve sertifikası otomatik alınmış bir HTTPS adresi elde edersiniz. Compute dakika bazında ölçülür ve en az bir instance sürekli çalıştığı için sessiz bir saatin ardından gelen ilk araç çağrısı da diğerleri kadar hızlı yanıtlanır, cold start beklemezsiniz. Her şey tek bir bölgede, Almanya'nın Nürnberg şehrinde çalışır; server'ınızın dokunduğu veri için AB veri ikametgahı önemliyse bu net bir cevaptır. Planlar ayda 9 dolardan başlar ve 14 günlük ücretsiz denemeyle açılır. Adım adım anlatımı MCP server deploy etme rehberinde bulabilirsiniz.

Nerede barındırırsanız barındırın kontrol listesi aynıdır: HTTPS, depo dışında tutulan kimlik bilgileri, endpoint üzerinde kimlik doğrulama ve gerçekten okuyabildiğiniz loglar. Sunucu seçeneklerinin genel resmine bakmak isterseniz bulut sunucu nedir yazısı işe yarar.

MCP standardı üzerine bina kurulacak kadar oturmuş mu?

Protokol tarih biçiminde sürümlenir. YYYY-MM-DD biçimindeki tarih, geriye dönük uyumu bozan son değişikliği işaret eder. Bugüne kadar beş sürüm yayımlandı: ilk çıkış 2024-11-05, Streamable HTTP ve OAuth 2.1 tabanlı yetkilendirmeyi getiren 2025-03-26, yapılandırılmış araç çıktısı ve güvenlik sıkılaştırmalarını getiren 2025-06-18, deneysel asenkron görevleri ekleyen 2025-11-25 ve güncel sürüm olan 2026-07-28.

2026-07-28 sürümü şimdiye kadarki en büyük kırılma ve yeni bir şey yazmadan önce anlamaya değer. initialize el sıkışmasını ve protokol seviyesindeki oturumları tamamen kaldırdı. Artık her istek kendi protokol sürümünü ve client yeteneklerini bir _meta alanında taşıyor, server'ın neyi desteklediğini ise zorunlu bir server/discover metodu bildiriyor. Pratik sonucu şu: her istek her instance tarafından yanıtlanabildiği için uzak bir MCP server, sticky session gerektirmeden sıradan HTTP altyapısının arkasında durabilir.

Aynı sürüm Roots, Sampling ve Logging özelliklerini de kullanımdan kaldırılacaklar listesine aldı. Üçü de en az on iki ay boyunca çalışmayı sürdürüyor ama yeni server'ların bunlara yaslanmaması gerekiyor. Yani üzerine bina kurulacak kadar oturmuş ama kurup arkanızı dönecek kadar değil. Başlamadan önce güncel spesifikasyonu okuyun ve test ettiğiniz SDK sürümünü sabitleyin.

Sıkça Sorulan Sorular

MCP server ile API aynı şey mi?

Aynı değil ama akraba. API, herhangi bir programatik arayüz için kullanılan genel bir terimdir. MCP ise JSON-RPC 2.0 üzerine kurulu, sabit bir metot kümesi ve makine tarafından okunabilir şemaları olan tek bir protokoldür. Şemalar, modelin doğru çağrıyı kendi başına seçebilmesi için tasarlanmıştır. Birçok MCP server, mevcut bir REST API'yi modelin keşfedip kullanabileceği biçime çeviren ince bir katmandır.

MCP sadece Claude için mi?

Hayır. Anthropic protokolü Kasım 2024'te oluşturup açık kaynak yaptı, Aralık 2025'te de Linux Foundation çatısı altındaki Agentic AI Foundation'a bağışladı. Protokol bugün bu vakıf tarafından yönetiliyor. Farklı sağlayıcıların client'ları protokolü uyguluyor. Yazdığınız bir server, uyumlu her host ile çalışır. "Claude MCP server" ifadesi de aslında yanıltıcıdır: Claude bir host'tur, server'ları çağıran taraftır, server'ın kendisi değil.

Kendi MCP server'ımı yazmam gerekir mi?

Çoğu zaman gerekmez. On bin civarında aktif public MCP server var ve dosya sistemleri, veritabanları, issue takip araçları ile yaygın SaaS ürünlerinin çoğu kapsanıyor. Kendi server'ınızı, kurum içi bir sisteme ulaşmanız, kendi erişim kurallarınızı uygulamanız ya da mevcut hiçbir server'a uymayan bir akışı açmanız gerektiğinde yazın. Önce resmi registry'ye ve referans uygulamalara bakın.

MCP server hangi dilde yazılır?

JSON'u bir akış üzerinden ya da HTTP üzerinden taşıyabilen her dilde. TypeScript, Python, C#, Go, Rust, Java, Ruby, Swift, PHP ve Kotlin için resmi SDK'lar var. Pratikte en yaygın kullanılan ve dokümantasyonu en eksiksiz olanlar Python ile TypeScript. Başka bir yığında kalmak için özel bir nedeniniz yoksa bu ikisinden birini seçin.

MCP server çalıştırmak ücretli mi?

Yerel bir stdio server hiçbir şeye mal olmaz. Zaten sahip olduğunuz donanımda alt süreç olarak çalışır ve client kapanınca durur. Uzak bir HTTP server ise barındırılan bir web servisidir ve barındırma neye mal oluyorsa ona mal olur. Çoğu MCP server küçük ve büyük ölçüde boşta beklediği için bu genelde bir platformun en alt basamağıdır. Out Plane'de planlar ayda 9 dolardan başlar ve 14 günlük ücretsiz denemeyle açılır.

Uzak bir MCP server'a kimlik doğrulama nasıl yapılır?

Standart HTTP mekanizmalarıyla. Streamable HTTP transport'u bearer token'ları, API anahtarlarını ve özel header'ları destekler; spesifikasyon token almak için OAuth kullanılmasını önerir. Güncel sürüm durumsuz olduğu için kimlik bilgileri oturum başına bir kez kurulmak yerine her istekle birlikte gider. Bu, sıradan HTTP API'lerinin zaten yaptığı şeydir.

Sonuç

MCP server, çok belirli bir işi olan küçük ve sıkıcı bir programdır: bir yetenek listesi yayımlar ve istendiğinde onları çalıştırır. Altındaki protokol JSON-RPC, şema dili JSON Schema, taşıma katmanı ise ya bir alt süreç borusu ya da bir HTTP endpoint'idir. İçinde sihir yok, zaten tutmasının nedeni de bu.

Aklınızda tutmanız gereken üç ayrım var. Tools, resources ve prompts server'ınızın neyi sunduğunu tarif eder. Host, client ve server kimin kiminle konuştuğunu tarif eder. stdio ile Streamable HTTP arasındaki seçim ise server'ın nerede çalıştığını ve dolayısıyla ondan başka kimin faydalanabileceğini belirler.

Çoğu server bir dizüstü bilgisayarda stdio ile başlar ve orada kalır. Ekibe faydalı olanlar ise HTTP'ye geçer; işte o noktada bir script olmaktan çıkıp URL'i, sertifikası, kimlik bilgileri ve logları olan bir servise dönüşür. Bu noktaya geldiyseniz konsoldan bir uygulama oluşturarak başlayabilir, planları fiyatlandırma sayfasında inceleyebilirsiniz.