Bir AI uygulamasının yalnızca metin üretmek yerine dosya okuması, veritabanından bilgi alması, bir iş sisteminde işlem yapması veya belirli bir workflow’u kullanması için dış yeteneklere bağlanması gerekir. MCP server, bu veri ve araçları Model Context Protocol üzerinden standart biçimde sunan programdır. Ancak “bir MCP server yazalım” demek tek başına yeterli değildir; hangi verinin resource, hangi işlemin tool, hangi tekrar eden akışın prompt olacağı ve serverın hangi yetkilerle çalışacağı doğru tasarlanmalıdır.
15 Temmuz 2026 itibarıyla mevcut kararlı MCP spesifikasyonu 2025-11-25 sürümüdür. Resmî dokümantasyon MCP serverları, AI uygulamalarına standart protokol arayüzleri üzerinden belirli yetenekler sunan programlar olarak tanımlar Understanding MCP Servers. Bu yazı, bir MCP serverın mimari rolünü ve AI uygulamalarına veri ile araç bağlarken nasıl düşünülmesi gerektiğini ele alır.
MCP server nedir?
MCP server, bir AI hostunun kullanabileceği veri, araç ve iş akışı yeteneklerini Model Context Protocol üzerinden sunan yazılım bileşenidir. Server yerel bilgisayarda çalışan küçük bir program olabilir; kurumsal ağda veya internette barındırılan uzak bir servis de olabilir. Temel rolü, dış sistemdeki yetenekleri MCP uyumlu clientların anlayabileceği standart bir protokol arayüzüne dönüştürmektir.
Resmî MCP server kavramları dokümantasyonu; dosya sistemi serverlarını belge erişimi, veritabanı serverlarını veri sorguları, GitHub serverlarını kod yönetimi, Slack serverlarını ekip iletişimi ve takvim serverlarını zamanlama için örnekler Understanding MCP Servers. Bunlar, serverın yalnız “API çağrısı yapan bir wrapper” olmak zorunda olmadığını gösterir. Server yerel kaynakları da, uzaktaki servisleri de ortak bir MCP yetenek modeliyle sunabilir.
MCP serverın kendi başına bir AI modeli olması gerekmez. Serverın görevi model üretmek değil, belirli bir yetenek yüzeyini protokole uygun biçimde sunmaktır. AI modeli ve kullanıcı deneyimi host tarafında bulunabilir; server ise dış dünya ile bağlantının kontrollü sınırını oluşturur.
MCP server AI uygulamasına tam olarak ne sunar?
2025-11-25 kararlı spesifikasyonuna göre MCP serverlar üç temel sunucu yeteneği sunabilir: resources, tools ve prompts MCP Server Overview. Bir server bunların üçünü birden sunmak zorunda değildir. Yalnızca bir tool seti veya yalnızca okunabilir kaynaklar sağlayan dar bir server da tasarlanabilir.
Resources: Okunabilir veri ve bağlam
Resources, AI uygulamasının veya kullanıcının bağlam olarak tüketebileceği verileri temsil eder. Resmî spesifikasyon dosyalar, veritabanı şemaları ve uygulamaya özgü bilgileri resource örnekleri arasında sayar. Her resource bir URI ile tanımlanır MCP Resources.
Resource tasarımı, “modelin görebileceği her şeyi tek seferde gönder” yaklaşımı değildir. İyi bir server, veriyi anlamlı ve erişilebilir parçalara ayırır. Büyük bir doküman sistemi düşünülüyorsa kaynakların aranması, seçilmesi ve yalnız ilgili parçaların okunması daha doğru olabilir.
Tools: AI modelinin çağırabileceği işlemler
Tools, dil modelinin dış sistemle etkileşim kurmasını sağlayan çağrılabilir fonksiyonlardır. Resmî spesifikasyon veritabanı sorgulama, API çağırma ve hesaplama gibi işlemleri örnek verir. Her tool benzersiz bir ad ve giriş şemasını açıklayan metadata taşıyabilir MCP Tools.
Bir toolun adı ve açıklaması yalnız geliştirici için değildir; modelin hangi aracı ne zaman kullanacağını değerlendirmesine de yardımcı olur. Bu nedenle “do_everything” gibi belirsiz ve aşırı geniş bir tool yerine açık, sınırları belirli ve sonucu anlaşılır işlemler tasarlamak daha güvenlidir.
Prompts: Yeniden kullanılabilir görev şablonları
Prompts, belirli görevleri başlatmak veya kullanıcıyı yönlendirmek için server tarafından sunulan yapılandırılmış mesaj ve talimat şablonlarıdır. Clientlar mevcut promptları keşfedebilir, içeriklerini alabilir ve gerekli argümanlarla özelleştirebilir MCP Prompts.
Bu ayrım server tasarımında önemlidir: okunacak bilgi resource, eylem tool, tekrar kullanılacak görev başlangıcı prompt olarak düşünülebilir. Her özelliği tek bir büyük tool içine toplamak, serverın anlaşılmasını ve güvenlik sınırlarının yönetilmesini zorlaştırabilir.
Bir MCP server bağlantısı nasıl kurulur?
MCP, host–client–server ilişkisi kullanır. Kullanıcının etkileşim kurduğu AI uygulaması hosttur. Host, bağlandığı her MCP server için bir client oluşturabilir. Client belirli serverla protokol iletişimini yürütür MCP Architecture Overview.
Bağlantı yalnız “socket aç ve tool çağır” şeklinde değildir. MCP yaşam döngüsü initialization, operation ve shutdown aşamalarını tanımlar. Başlangıçta client ve server protokol sürümünü ve destekledikleri capability’leri müzakere eder. Böylece taraflar hangi özelliklerin kullanılabilir olduğunu anlayabilir MCP Lifecycle.
- Host server bağlantısını oluşturur: Yerel veya uzak server için uygun client başlatılır.
- Initialization gerçekleşir: Client ve server protokol sürümü ile desteklenen capability’leri paylaşır.
- Yetenekler keşfedilir: Serverın sunduğu tools, resources veya prompts listelenebilir.
- Görev sırasında yetenek kullanılır: Resource okunur, prompt alınır veya tool çağrılır.
- Sonuç hosta döner: AI modeli veya kullanıcı akışı sonucu görev içinde kullanır.
- Bağlantı sonlandırılır: Çalışma tamamlandığında lifecycle kurallarına uygun kapanış yapılır.
Yerel MCP server nasıl çalışır?
Yerel MCP server, kullanıcının bilgisayarında veya AI uygulamasıyla aynı çalışma ortamında çalışabilir. Mevcut kararlı spesifikasyonun standart transportlarından biri stdiodur. Bu modelde client serverı bir alt süreç olarak başlatabilir ve JSON-RPC mesajları standart giriş ile çıkış akışları üzerinden taşınabilir MCP Transports.
Yerel serverlar özellikle dosya sistemi, geliştirici araçları veya kullanıcının makinesinde bulunan kaynaklar için anlamlıdır. Resmî “Connect to local MCP servers” rehberi, MCP serverların AI uygulamalarına yerel kaynak ve araçlara kontrollü erişim sağlayabileceğini belirtir Connect to Local MCP Servers.
Yerel çalışmanın avantajı verinin kullanıcının ortamına yakın olmasıdır. Buna karşılık kurulum, runtime bağımlılıkları, dosya izinleri ve her kullanıcı ortamında güncelleme gibi operasyonel konular ortaya çıkar. Serverın kullanıcının tüm diskine varsayılan erişim alması yerine yalnız gerekli klasör veya araçlarla sınırlandırılması daha güvenli bir yaklaşımdır.
Uzak MCP server nasıl çalışır?
Uzak MCP server internet veya kurumsal ağ üzerinde barındırılır. Mevcut kararlı spesifikasyonda standart uzak transport Streamable HTTP olarak tanımlanır MCP Transports. Bu model, merkezi olarak işletilen bir serverın farklı yetkili clientlara hizmet vermesine olanak sağlar.
Resmî remote server rehberi; proje yönetimi araçları, dokümantasyon sistemleri, kod repository’leri ve API destekli başka servislerin uzak MCP serverlar üzerinden bağlanabileceğini açıklar Connect to Remote MCP Servers.
Uzak server mimarisi merkezi bakım avantajı sağlar; ancak kimlik doğrulama, yetkilendirme, tenant ayrımı, ağ güvenliği, loglama ve hata yönetimi daha önemli hale gelir. Bir kullanıcı adına veri okuyan veya işlem yapan server, “servera bağlandıysa her şeye erişebilir” yaklaşımıyla tasarlanmamalıdır.
| Kriter | Yerel MCP server | Uzak MCP server |
|---|---|---|
| Çalışma ortamı | Kullanıcı cihazı veya yerel runtime | İnternet veya kurumsal ağ üzerindeki servis |
| Yaygın standart transport | stdio | Streamable HTTP |
| Uygun kaynaklar | Yerel dosyalar ve geliştirici araçları | Merkezi iş sistemleri ve ortak servisler |
| Dağıtım modeli | Client ortamında kurulum gerekebilir | Merkezi deployment ve güncelleme |
| Öne çıkan güvenlik konusu | Yerel dosya ve komut izinleri | Kimlik, yetkilendirme ve kullanıcı izolasyonu |
MCP server bir API’ye nasıl bağlanır?
Bir MCP serverın en yaygın mimari rollerinden biri, var olan bir servisin yeteneklerini AI uygulamasına kontrollü biçimde sunmaktır. Server arka planda mevcut HTTP API’yi çağırabilir, dönen veriyi işleyebilir ve yalnız gerekli işlemleri MCP tools veya resources olarak dışarı açabilir.
Bu durumda API ile MCP aynı katman değildir. API temel iş sistemi sözleşmesi olmaya devam eder; MCP server ise AI hostunun anlayacağı yetenek yüzeyini oluşturur. Örneğin çok sayıda düşük seviyeli operasyonu bulunan bir servis, agent için daha dar ve görev odaklı tool setine dönüştürülebilir.
Bir API entegrasyonu üzerinde MCP katmanı kurulurken arka servisin hata kodları, rate limitleri, yetki modeli ve idempotency davranışı kaybolmamalıdır. MCP tool başarılı göründüğü halde arka sistemde işlem başarısız olmuşsa bu durum açık ve makine tarafından yorumlanabilir biçimde sonuçlara yansıtılmalıdır.
Tool tasarlarken hangi kurallara dikkat edilmeli?
MCP server kalitesini belirleyen en önemli konulardan biri tool tasarımıdır. Model, hangi aracın ne yaptığını tool adı, açıklaması ve input schema üzerinden anlamaya çalışır. Belirsiz, çok geniş veya yan etkileri gizleyen araçlar agent davranışını daha riskli hale getirebilir.
- Tool adını açık tutun: İşlemin ne yaptığını tahmin ettirmeyen isimlerden kaçının.
- Giriş şemasını daraltın: Serbest metin yerine mümkün olduğunda açık alanlar ve doğrulanan tipler kullanın.
- Okuma ve yazmayı ayırın: Veri görüntüleme ile değişiklik yapma aynı tool içinde saklanmamalıdır.
- Yan etkileri belirtin: Silme, ödeme, gönderim veya production değişikliği gibi etkiler açık olmalıdır.
- Hata sonuçlarını anlamlı döndürün: Modelin başarısızlığı başarı sanmasına neden olacak belirsiz cevaplardan kaçının.
- En düşük yetkiyi uygulayın: Tool yalnız ihtiyaç duyduğu kaynağa ve operasyona erişmelidir.
Resmî Tools spesifikasyonu, tool çağrılarında insanın süreç içinde tutulabilmesini ve kullanıcıların tool invocation üzerinde kontrol sahibi olmasını güvenlik ilkeleri arasında vurgular MCP Tools. Kritik işlemlerde modelin tool seçmesi ile işlemin otomatik olarak onaylanması aynı şey olmamalıdır.
Resource tasarlarken nelere dikkat edilmeli?
Resources tarafında temel hata, bütün veri kaynağını tek parça halinde modele açmaktır. Büyük bir repository, doküman arşivi veya veri tabanı için daha anlamlı resource yapısı; veriyi keşfedilebilir, adreslenebilir ve gerektiğinde seçilebilir bölümlere ayırmaktır.
Resmî Resources spesifikasyonu her resource’un URI ile tanımlandığını ve serverın bağlam sağlayan farklı veri türlerini paylaşabildiğini belirtir MCP Resources. URI tasarımı, resource isimleri ve metadata; clientın kullanıcıya veya modele anlamlı seçenekler sunmasını kolaylaştırabilir.
Güncel olmayan, hassas veya yetkisiz verinin resource olarak görünmesi de ayrı bir risktir. Veri erişimi kullanıcının gerçek yetkileriyle sınırlandırılmalı; server “AI kullanıyor” gerekçesiyle mevcut veri politikalarını aşmamalıdır.
Gerçek bir MCP server nasıl geliştirilmeye başlanır?
Resmî MCP dokümantasyonu farklı diller için server geliştirme kaynakları sunar MCP SDKs. Dil seçimi protokolün özünden çok mevcut ekip yetkinliği, deployment ortamı ve bağlanılacak sistemlere göre yapılmalıdır.
Resmî “Build an MCP server” tutorialı gerçek bir öğretici örnek olarak hava durumu uyarıları ve tahminleri sunan bir server geliştirir. Tutorialın odağı iki tool üzerinden bir serverın kurulmasını, çalıştırılmasını ve clienta bağlanmasını göstermektir Build an MCP Server. Bu, uydurma bir müşteri senaryosu değil, resmî dokümantasyonda kullanılan eğitim örneğidir.
Üretim amaçlı server geliştirirken şu sıra daha güvenli bir başlangıç sağlar:
- AI uygulamasının gerçekten ihtiyaç duyduğu veri ve işlemleri listeleyin.
- Her ihtiyacı resource, tool veya prompt olarak sınıflandırın.
- İlk sürümde mümkün olan en küçük yetenek setini açın.
- Yerel mi uzak mı çalışacağına ve transport modeline karar verin.
- Kimlik, yetkilendirme ve kullanıcı onayı sınırlarını tasarlayın.
- Tool girdileri ile dış servis cevaplarını doğrulayın.
- Inspector ve gerçek clientlarla davranışı test edin.
- Loglama, hata takibi ve sürüm yönetimini production öncesinde ekleyin.
MCP Inspector ne işe yarar?
MCP Inspector, MCP serverları test etmek ve debug etmek için sunulan interaktif geliştirici aracıdır. Resmî dokümantasyona göre Inspector, serverın sunduğu capabilities ile etkileşim kurmaya ve geliştirme sırasında davranışı incelemeye yardımcı olur MCP Inspector.
Serverı yalnız gerçek AI hostuna bağlayarak test etmek, hatanın model davranışından mı, clienttan mı yoksa server implementasyonundan mı kaynaklandığını ayırmayı zorlaştırabilir. Inspector gibi bir araç, protokol katmanını daha izole test etmeyi kolaylaştırır.
Yine de Inspector testleri production güvenliğinin yerine geçmez. Gerçek sistemde kimlik, ağ hataları, rate limit, dış servis kesintisi ve kullanıcı bazlı erişim sınırları ayrıca test edilmelidir.
MCP server güvenliği nasıl tasarlanmalı?
MCP serverın sahip olduğu gerçek yetkiler, AI modelinin yapabileceği işlerin sınırını belirler. Server dosya silebiliyor, e-posta gönderebiliyor veya production sisteminde değişiklik yapabiliyorsa modelin bu toolu çağırabilmesi yüksek etkili bir yetkidir.
Uzak serverlarda authorization özellikle önemlidir. 2025-11-25 spesifikasyonu HTTP tabanlı transportlar için authorization çerçevesi tanımlar. Bunun yanında arka sistemlerde kullanıcı bazlı yetki kontrolleri korunmalıdır MCP Authorization.
| Risk | Zayıf tasarım | Daha güvenli yaklaşım |
|---|---|---|
| Aşırı yetki | Serverın tüm sistemde yönetici yetkisi olması | Tool bazlı en düşük yetki |
| Belirsiz işlem | Tek toolun hem okuma hem silme yapması | Okuma ve yazma yeteneklerini ayırmak |
| Gizli yan etki | Tool adından kritik işlemin anlaşılmaması | Açık isim, açıklama ve onay noktası |
| Kullanıcı izolasyonu | Her kullanıcının aynı veriyi görmesi | Gerçek kimliğe bağlı yetkilendirme |
| Hata yönetimi | Başarısız işlemi belirsiz sonuçla döndürmek | Yapılandırılmış ve izlenebilir hata sonucu |
Özellikle iş süreci otomasyonu içinde MCP server kullanılıyorsa geri döndürülemez işlemler için kullanıcı veya insan onayı gerekebilir. “Agent yapabiliyor” ile “agent otomatik yapmalı” aynı tasarım kararı değildir.
MCP server ne zaman anlamlı bir yatırım?
MCP server, aynı araç veya veri kaynağının birden fazla MCP uyumlu AI hostuna sunulması, AI uygulamasının yetenekleri standart biçimde keşfetmesi veya şirket içi sistemlere kontrollü bir agent erişim katmanı kurulması istendiğinde anlamlıdır.
Birden fazla sistem ve özel iş kuralı bulunan özel yazılım projelerinde de belirli AI yeteneklerini ayrı server sınırlarıyla sunmak mimari netlik sağlayabilir. Ancak yalnız tek bir uygulamanın bir fonksiyonu çağırdığı dar senaryoda tam MCP server katmanı gereksiz olabilir.
Karar verilirken protokolün popülerliğinden çok yeniden kullanım, güvenlik, bakım ve operasyon maliyeti değerlendirilmelidir. Server geliştirmek kolay olabilir; uzun vadede güvenli biçimde işletmek asıl mühendislik problemidir.
Sonuç: İyi MCP server çok araç sunan değil, doğru sınır kurandır
MCP server, AI uygulamalarına dış veri ve işlemleri standart protokol üzerinden sunan bileşendir. Resources okunabilir bağlamı, tools çağrılabilir işlemleri, prompts ise tekrar kullanılabilir görev şablonlarını temsil eder. Server yerel ortamda stdio ile veya uzakta Streamable HTTP üzerinden çalışabilir.
Başarılı bir MCP server tasarımı, mümkün olan en fazla yeteneği modele açmak değildir. Doğru kaynakları seçmek, tool sınırlarını dar tutmak, kullanıcı yetkilerini korumak, hata sonuçlarını açık vermek ve kritik işlemlerde kontrol noktaları oluşturmaktır. AI entegrasyonunun kalitesi yalnız modelin gücüne değil, serverın dış dünyayı ne kadar anlaşılır ve güvenli biçimde temsil ettiğine bağlıdır.
Sıkça Sorulan Sorular
MCP server nedir?
MCP server, AI uygulamalarına Model Context Protocol üzerinden belirli veri ve yetenekler sunan programdır. Server; okunabilir bağlam için resources, çağrılabilir işlemler için tools ve tekrar kullanılabilir görev şablonları için prompts sağlayabilir. Yerel bilgisayarda çalışabileceği gibi internet veya kurumsal ağ üzerinde uzak bir servis olarak da çalışabilir. Kendi başına bir AI modeli olmak zorunda değildir.
MCP server ile AI uygulamasına hangi tür veriler bağlanabilir?
Dosyalar, veritabanı şemaları, uygulamaya özgü bilgiler ve başka bağlam kaynakları resource olarak sunulabilir. Veritabanı sorgulama, API çağırma veya hesaplama gibi işlemler tool olarak modellenebilir. Gerçek erişim kapsamı serverın bağlandığı sistemlere ve kullanıcının yetkilerine bağlıdır. Hassas veriler yalnız gerekli kullanıcı ve işlemler için en düşük yetki yaklaşımıyla açılmalıdır.
Yerel ve uzak MCP server arasındaki fark nedir?
Yerel MCP server genellikle kullanıcının bilgisayarında veya aynı runtime ortamında çalışır ve stdio transport kullanabilir. Uzak MCP server ise internet veya kurumsal ağ üzerinde barındırılır ve mevcut kararlı spesifikasyonda Streamable HTTP kullanılabilir. Yerel model dosya ve cihaz kaynaklarına yakınlık sağlarken, uzak model merkezi dağıtım ve ortak servis erişimi için daha uygundur.
Bir MCP server mevcut API’yi kullanabilir mi?
Evet. MCP server arka planda mevcut bir HTTP API’yi çağırabilir ve bu servisin belirli yeteneklerini AI uygulamasına tools veya resources olarak sunabilir. Bu durumda API temel iş sistemi sözleşmesi olmaya devam eder; MCP server ise AI odaklı erişim katmanı oluşturur. Arka API’nin yetkilendirme, hata, rate limit ve iş kuralları MCP katmanında kaybolmamalıdır.
MCP server geliştirmek için hangi dil kullanılabilir?
Resmî MCP dokümantasyonu farklı diller için SDK kaynakları sunar. Dil seçimi protokolün özünden çok ekibin mevcut yetkinliğine, deployment ortamına ve bağlanılacak sistemlere göre yapılmalıdır. Üretim sistemi için SDK’nın destek seviyesi ve kullanılan protokol sürümü ayrıca kontrol edilmelidir.
MCP server güvenli midir?
MCP serverın güvenliği protokol adından değil, verilen gerçek yetkilerden ve uygulama tasarımından gelir. Serverın yalnız ihtiyaç duyduğu kaynaklara erişmesi, okuma ile yazma işlemlerinin ayrılması, kullanıcı bazlı yetkilendirme, giriş doğrulama ve kritik eylemlerde onay mekanizması önemlidir. Üçüncü taraf veya uzaktaki serverlar kritik sistemlere bağlanmadan önce güven kaynağı ve yetki kapsamı açısından incelenmelidir.