Anthropic'in kamuya açık tanıtımından bu yana Model Bağlam Protokolü (MCP) on 25 Kasım 2024, MCP kavramdan pratik ekosisteme hızla geçti: açık bir spesifikasyon ve birden fazla referans sunucusu mevcut, topluluk uygulamaları (bellek sunucuları, dosya sistemi erişimi, web getiricileri) GitHub ve NPM'de ve MCP halihazırda şu istemcilerde destekleniyor: Masaüstü için Claude ve üçüncü taraf araçlar. Protokol gelişti (spesifikasyon ve sunucu örnekleri 2025 yılına kadar güncellendi) ve tedarikçiler ile mühendisler, daha güvenli ve token açısından verimli entegrasyonlar için modeller yayınlıyor.
Bu makale, bir MCP sunucusu oluşturma ve onu şuraya bağlama konusunda size yol gösterecektir: Claude Masaüstüve üretimde ihtiyaç duyacağınız pratik / güvenlik / bellek ipuçları.
Model Bağlam Protokolü (MCP) nedir?
Basit bir İngilizce tanımı
Model Bağlam Protokolü (MCP) bir açık, standartlaştırılmış protokol Bu, LLM sunucularının (örneğin Claude Desktop gibi modeli çalıştıran uygulamalar) modeli açığa çıkaran harici hizmetleri çağırmasını kolaylaştırır kaynaklar (dosyalar, veritabanı satırları), araçlar (modelin çağırabileceği işlevler) ve istemleri (modelin kullanabileceği şablonlar). N×M entegrasyonları (her modelden her araca) uygulamak yerine, MCP tutarlı bir istemci-sunucu şeması ve bir çalışma zamanı sözleşmesi sağlar; böylece herhangi bir MCP uyumlu model ana bilgisayarı, herhangi bir MCP uyumlu sunucuyu kullanabilir; böylece geliştiriciler hizmetleri bir kez derleyip herhangi bir MCP uyumlu model veya kullanıcı arayüzünün (örneğin Claude Desktop) bunları kullanmasına izin verebilir.
MCP neden şimdi önemli?
Anthropic'in 2024 sonlarında açık kaynaklı MCP'yi kullanıma sunmasından bu yana, protokol hızla araç entegrasyonları (Claude, VS Code uzantıları ve diğer aracı ortamları) için fiili bir birlikte çalışabilirlik katmanı haline geldi. MCP, yinelenen işleri azaltır, bağlayıcıların (Google Drive, GitHub, Slack vb.) geliştirilmesini hızlandırır ve kalıcı bellek depolarının bir asistana bağlanmasını kolaylaştırır.
MCP mimarisi nedir ve nasıl çalışır?
Yüksek düzeyde MCP üç rol grubunu ve çeşitli etkileşim kalıplarını tanımlar.
Temel bileşenler: istemciler, sunucular ve kayıt defteri
- MCP istemcisi (ana bilgisayar): Bağlamsal verileri isteyen LLM ana bilgisayarı veya uygulaması (Claude Desktop, bir VS Code aracısı veya bir web uygulaması). İstemci, bir veya daha fazla MCP sunucusunu keşfeder ve bunlara bağlanır.
- MCP sunucusu (kaynak sağlayıcı): MCP şeması aracılığıyla kaynakları (dosyalar, bellekler, veritabanları, eylemler) açığa çıkaran bir ağ hizmetidir. Sunucular yeteneklerini beyan eder ve istemcinin çağırabileceği uç noktalar sağlar.
- Kayıt / Keşif: İstemcinin kullanılabilir MCP sunucularını keşfetmesine, yetenekleri listelemesine ve izinleri veya kurulumu yönetmesine yardımcı olan isteğe bağlı bileşenler veya yapılandırma dosyaları (masaüstü "uzantıları" bunun için bir UX katmanıdır).
Mesaj akışları ve yetenek müzakeresi
MCP etkileşimleri genellikle şu kalıbı izler:
- Keşif / tescil: İstemci, kullanılabilir sunucular (yerel, ağ veya düzenlenmiş kayıtlar) hakkında bilgi edinir.
- Yetenek duyurusu: Sunucu, kaynakları, yöntemleri ve yetkilendirme gereksinimlerini açıklayan bir bildirimi paylaşır.
- İstek / yanıt: İstemci yapılandırılmış istekler gönderir (örneğin, "X dosyasını oku", "Y için bellekleri ara" veya "bu dosyalarla PR oluştur") ve sunucu yazılmış bağlamsal verilerle yanıt verir.
- Eylem sonuçları ve yayın akışı: Sunucular sonuçları aktarabilir veya uzun süreli işlem uç noktaları sağlayabilir. Spesifikasyon, türlendirilmiş kaynak tanımlayıcıları ve yanıtları için şemalar tanımlar.
Güvenlik modeli ve güven sınırları
MCP, LLM'lerin kullanıcı verileri üzerinde işlem yapabilmeleri ve eylemler gerçekleştirebilmeleri için kontrol yüzeylerini kasıtlı olarak standartlaştırır. Bu güç, dikkatli güvenlik kontrolleri gerektirir:
- Açık kullanıcı onayı / istemler Sunucuların özel verilere erişebildiği veya ayrıcalıklı eylemler gerçekleştirebildiği (örneğin, depolara yazma) durumlarda önerilir.
- En az ayrıcalıklı durum şu şekilde ortaya çıkar: Sunucular minimum kapsamları bildirmeli ve istemciler yalnızca gerekli yetenekleri talep etmelidir.
- Taşıma ve yetkilendirme: Hassas entegrasyonlar için TLS, belirteçli kimlik bilgileri ve yalnızca yerel uç noktalar kullanın. Topluluk ve platform sağlayıcıları (örneğin, Windows'ta Microsoft), riskleri azaltmak için kayıt defterleri ve kullanıcı arayüzü olanaklarıyla denemeler yapıyor.
Claude'u MCP sunucularına neden entegre etmeliyiz?
Claude'u MCP sunucularıyla entegre etmek üç pratik yetenek sınıfının kilidini açar:
Gerçek zamanlı, eyleme dönüştürülebilir bağlam
Claude, güncel olmayan anlık görüntüleri kopyalayıp komut istemlerine yerleştirmek yerine, sorgu sırasında güncel bağlam (dosyalar, konuşma geçmişi, veritabanı satırları) talep edebilir. Bu, daha az yaklaşık veri alımı ve daha yeni çıktılar anlamına gelir. Anthropic'in demoları, Claude'un GitHub PR'leri oluşturma veya MCP aracılığıyla yerel dosyaları okuma gibi işlemleri yaptığını gösteriyor.
Tek bir dev adaptör yerine küçük, birleştirilebilir araçlar
Takvim için bir, dosya sistemi için bir ve vektör bellek deposu için bir olmak üzere odaklanmış MCP sunucuları yazabilir ve bunları farklı Claude örnekleri veya istemcileri (masaüstü, IDE, web) arasında yeniden kullanabilirsiniz. Bu modülerlik, özel entegrasyonlardan daha iyi ölçeklenir.
Kalıcı ve standartlaştırılmış bellek
MCP, bellek hizmetlerini etkinleştirir: konuşma geçmişini, kişisel tercihleri ve yapılandırılmış kullanıcı durumunu kodlayan kalıcı depolar. MCP kaynak modelini standartlaştırdığı için, birden fazla istemci aynı bellek sunucusunu yeniden kullanabilir ve uygulamalar arasında tutarlı bir kullanıcı bağlamı sağlayabilir. Çeşitli topluluk bellek hizmetleri ve uzantı modelleri halihazırda mevcuttur.
Daha iyi kullanıcı deneyimi ve yerel kontrol (Claude Desktop)
Masaüstü istemcilerinde MCP, yerel sunuculara kullanıcının dosya sistemine doğrudan erişim (onayıyla) sağlayarak, bulut API'leri olmadan gizliliğe duyarlı entegrasyonları mümkün kılar. Anthropic'in Masaüstü Uzantıları, yerel makinelerde MCP sunucularının kurulumunu ve keşfini basitleştirmenin bir örneğidir.
MCP Sunucusu Nasıl Oluşturulur
Başlamadan önce ihtiyacınız olanlar
- Claude Masaüstüİşletim sisteminiz için en son Claude Desktop sürümünü yükleyin ve ayarlarda MCP/Uzantı desteğinin etkinleştirildiğinden emin olun. Bazı özellikler ücretli bir plan (Claude Pro veya eşdeğeri) gerektirebilir.
- Geliştirici makinesi: Node.js (>=16/18 önerilir) veya Python 3.10+, ayrıca ngrok veya yerel bir tünelleme çözümü, yerel bir sunucuyu test için internete açmak istiyorsanız. Üretimde TLS kullanın.
- MCP projesi ana belgelerde ve GitHub deposunda SDK'lar ve şablonlar sağlar; Python veya Node SDK'sını docs/repo'daki resmi talimatlar aracılığıyla kurun.
Seçenek A — Mevcut (örnek) bir MCP sunucusunu kurun
Anthropic, bellek, dosya sistemi ve araçlar dahil olmak üzere örnek sunucular sağlar.
Referans sunucularını klonlayın:
git clone https://github.com/modelcontextprotocol/servers.git
cd servers
İçerisinde şu klasörleri bulacaksınız:
filesystem/
fetch/
memory/
weather/
Örnek bir sunucuyu kurmak için:
cd memory
npm install
npm run dev
Bu, MCP sunucusunu genellikle şu adreste başlatır:
http://localhost:3000
Manifest uç noktasının çalıştığını ve bir aracı çağırdığınızda düzgün yazılmış JSON döndürdüğünü doğrulayın.
Seçenek B — Kendi MCP sunucunuzu oluşturun (öğrenmek için önerilir)
1) Bir proje klasörü oluşturun
mkdir my-mcp-server
cd my-mcp-server
npm init -y
2) MCP sunucu SDK'sını yükleyin
npm install @modelcontextprotocol/server
3) Temel bir sunucu dosyası oluşturun
Oluştur server.js:
touch server.js
Minimal MCP sunucu uygulamasını yapıştırın:
import { createServer } from "@modelcontextprotocol/server";
const server = createServer({
name: "my-custom-server",
version: "0.1.0",
tools: [
{
name: "hello_world",
description: "Returns a simple greeting",
input_schema: {
type: "object",
properties: {
name: { type: "string" }
},
required:
},
output_schema: {
type: "object",
properties: {
message: { type: "string" }
}
},
handler: async ({ name }) => {
return { message: `Hello, ${name}!` };
}
}
]
});
server.listen(3000);
console.log("MCP server running on http://localhost:3000");
Bu bir tam MCP sunucusu tek bir aracı açığa çıkarmak: hello_world.
Claude Desktop'ı bir MCP sunucusuna nasıl bağlayabilirim?
Aşağıda, basit bir MCP sunucusu oluşturup Claude Desktop'a kaydetmek için pratik bir adım adım kılavuz bulunmaktadır. Bu bölüm uygulamalıdır: ortam kurulumunu, sunucu bildirimini oluşturmayı, istemcinin beklediği uç noktaları kullanıma sunmayı ve Claude Desktop'ı sunucuyu kullanacak şekilde yapılandırmayı kapsar.
1) Claude Masaüstü geliştirici bağlantı alanını açın
Claude Masaüstünde: Ayarlar → Geliştirici (Ya da Ayarlar → Bağlayıcılar (İstemci yapısına bağlı olarak). Uzak/yerel bir MCP sunucusu ekleme veya "Bağlayıcı ekle" seçeneği mevcuttur. Tam kullanıcı arayüzü sürümler arasında değişebilir; görmüyorsanız, Masaüstü "Geliştirici" menüsünü veya en son sürüm notlarını kontrol edin.
2) Yerel bir sunucuyu yapılandırıyorsanız: Yapılandırma dosyasını oluşturun veya bulun
Claude masaüstü uygulaması başlatıldıktan sonra, bulunan tüm MCP sunucularını otomatik olarak ClaudeDesktopConfig.json adlı bir dosyaya yapılandırır. İlk adım, bu dosyayı bulup açmak veya henüz mevcut değilse oluşturmaktır:
Windows kullanıcıları için dosya “%APPDATA%\Claude\claude_desktop_config.json” altında yer almaktadır.
Mac kullanıcıları için dosya “~/Library/Application Support/Claude/claude_desktop_config.json” altında yer almaktadır.
3) Sunucuyu Claude Masaüstüne ekleyin
Claude Desktop'ın MCP sunucunuz hakkında bilgi edinmesini sağlayacak iki UX modeli vardır:
Masaüstü Uzantıları / Tek tıklamayla yükleyicilerAnthropic, kullanıcıların tek tıklamayla sunucu ekleyebilmesi için manifestoları ve yükleyicileri paketleyen "Masaüstü Uzantıları"nı belgelemiştir (daha geniş bir dağıtım için önerilir). Manifestinizi ve sunucu meta verilerinizi kolay kurulum için paketleyebilirsiniz.
Yerel sunucu kaydı (geliştirici modu): Yerel testler için:
- Manifest'i iyi bilinen bir yerel yola yerleştirin veya şu adreste sunun:
https://localhost:PORT/.well-known/mcp-manifest.json. - Claude Masaüstü ayarlarında, MCP/Uzantılar panelini açın ve “Yerel sunucu ekle” veya “URL ile sunucu ekle” seçeneğini belirleyin ve bildirim URL'sini veya belirteci yapıştırın.
- İstemci istediğinde gerekli izinleri verin. Claude sunucu kaynaklarını sıralayacak ve bunları kullanılabilir araçlar/bellekler olarak sunacaktır.
Şimdi yerel MCP'yi kurmayı seçiyoruz:Ekle mcpServers Bölüm Sunucu adınızı ve onu başlatmak için kesin bir yol/komutu listeleyen bir komut. Claude Desktop'ı kaydedin ve yeniden başlatın.
Yeniden başlatmanın ardından Claude'un kullanıcı arayüzü MCP araçlarını (Arama ve Araçlar simgesi) sunacak ve açığa çıkan işlemleri test etmenize olanak tanıyacaktır (örneğin, "Sacramento'da hava durumu nasıl?"). Sunucunuz sunucunuzu algılamıyorsa, mcp.log dosyalar ve mcp-server-<name>.log STDERR çıkışı için.
4)Entegrasyonu test edin
Claude sohbetinde şunu yazın:
Call the hello_world tool with name="Alice"
Claude MCP sunucunuzu çağıracak ve araç çıktısını kullanarak yanıt verecektir.
MCP üzerinden bir bellek hizmetini nasıl uygularım (ileri düzey ipuçları)?
Bellek servisleri, oturumlar arasında kullanıcı bağlamını kalıcı hale getirip yüzeye aktardıkları için en güçlü MCP sunucuları arasındadır. Aşağıdaki en iyi uygulamalar ve uygulama ipuçları, teknik özellikleri, Claude belgelerini ve topluluk kalıplarını yansıtmaktadır.
Bellek veri modeli ve tasarımı
- Yapılandırılmış ve yapılandırılmamış: Hem yapılandırılmış gerçekleri (örneğin ad, tercih işaretleri) hem de yapılandırılmamış konuşma parçalarını depolayın. Hızlı filtreleme için türetilmiş meta verileri kullanın.
- Parçalama ve yerleştirme: Uzun belgeleri veya konuşmaları anlamsal olarak tutarlı parçalara bölün ve benzerlik aramasını desteklemek için vektör yerleştirmelerini depolayın. Bu, hatırlamayı iyileştirir ve geri çağırma sırasında belirteç kullanımını azaltır.
- Güncellik ve belirginlik sinyalleri: Zaman damgalarını ve belirginlik puanlarını kaydedin; yakın veya yüksek belirginliğe sahip anıları tercih eden sorgulara izin verin.
- Gizlilik etiketleri: Müşterinin onay alabilmesi için öğeleri hassasiyet etiketleriyle (özel, paylaşılan, geçici) etiketleyin.
Bellek işlemleri için API kalıpları
En az üç işlemi uygulayın:
write: Meta veri içeren bir bellek öğesini kabul eder, onay ve depolama kimliğini döndürür.query: Doğal dil sorgusunu veya yapılandırılmış filtreyi kabul eder ve en iyi eşleşen k belleği döndürür (isteğe bağlı olarak açıklanabilirlik meta verileriyle birlikte).delete/update: Destek yaşam döngüsü operasyonları ve unutulması gereken açık kullanıcı istekleri.
Tasarım yanıtlarını, menşei (anının nereden geldiği) ve güven/benzerlik puanını içerecek şekilde düzenleyin; böylece müşteri ve model, anının ne kadar agresif bir şekilde kullanılacağına karar verebilir.
Claude için geri çağırma artırma stratejileri
- Kısa bağlam pencereleri: Tam belgeler yerine özlü bellek parçacıklarını döndürün; gerekirse Claude'un tam bağlamı istemesine izin verin.
- Özetleme katmanı: İsteğe bağlı olarak, belirteç sayısını azaltmak için her belleğin kısa bir özetini saklayın. Yazma işlemlerinde artımlı özetleme kullanın.
- Kontrollü enjeksiyon: İstemcinin modeli her şeyle boğmak yerine, istemlere seçici olarak enjekte edebileceği, eklenebilir bir "bağlam paketi" olarak bellek sağlayın.
Bellek MCP'leri için güvenlik ve yönetişim
- Onay ve denetim izi: Bir belleğin ne zaman oluşturulduğunu ve kullanıcının bunu modelle paylaşmaya onay verip vermediğini kaydedin. Claude Desktop'ta, bellekleri incelemek ve iptal etmek için net kullanıcı arayüzü olanakları sunun.
- Hız sınırlama ve doğrulama: Sunuculardan gelen beklenmedik kod yürütme isteklerini engelleyerek ve türleri doğrulayarak, hızlı enjeksiyon veya sızdırmaya karşı savunma sağlayın.
- Bekleme ve aktarım sırasında şifreleme: Depolanan öğeler için güçlü şifreleme ve tüm MCP uç noktaları için TLS kullanın. Bulut destekli mağazalar için, mümkünse zarf şifrelemesi veya müşteri tarafından yönetilen anahtarlar kullanın.
Sonuç: Claude Desktop'ta MCP Sunucusu Nasıl Oluşturulur
Makale, dizüstü bilgisayarınızda sıfırdan Claude + bellek sunucusuyla çalışmaya geçmek için kısa ve pratik bir tariftir:
- Bir iş akışını test edin: Claude'dan kısa bir bilgiyi "hatırlamasını" ve sunucunun bunu sakladığını doğrulamasını isteyin; ardından Claude'dan bu bilgiyi daha sonraki bir komutta hatırlamasını isteyin. Kayıtları inceleyin ve geri alma sıralamasını ayarlayın.
- Önkoşulları yükleyin: Node.js >= 18, Git, Claude Desktop (en son).
- Bir referans sunucusunu klonlayın: çatalı
modelcontextprotocol/serversörnekler veya GitHub'da bir topluluk hafıza sunucusu. - Kurun ve çalıştırın:
npm install→npm run dev(veya README deposunu takip edin). Bildirim uç noktasını onaylayın (örneğin,http://localhost:3000/manifest) JSON döndürür. () - Claude Masaüstünde bağlayıcıyı kaydedin: Ayarlar → Geliştirici / Bağlayıcılar → Bağlayıcı ekle → üzerine gelin
http://localhost:3000ve kapsamları onaylayın.
Claude'u (veya herhangi bir ana bilgisayarı) MCP sunucularıyla entegre etmek, bir bağlayıcıyı bir kez oluşturmanıza ve bunu MCP istemcilerinde (Claude Masaüstü, IDE'ler veya diğer aracı çerçeveleri) kullanılabilir hale getirmenize olanak tanır; bu da bakım ihtiyacını önemli ölçüde azaltır ve araçlar arasında özellik eşitliğini hızlandırır.
Geliştiriciler, Claude AI'nın en son API'sine (bu makalenin yayınlanma tarihi itibarıyla) şu şekilde erişebilirler: Claude Sone 4.5 API ve Claude Opus 4.1 API CometAPI aracılığıyla, en son model versiyonu Resmi web sitesi aracılığıyla sürekli güncellenmektedir. Başlamak için, modelin yeteneklerini keşfedin. Oyun Alanı ve danışın API kılavuzu Ayrıntılı talimatlar için. Erişimden önce, lütfen CometAPI'ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. Kuyrukluyıldız API'si Entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat teklif ediyoruz.
Gitmeye hazır mısınız?→ Bugün CometAPI'ye kaydolun !
Yapay zeka hakkında daha fazla ipucu, kılavuz ve haber öğrenmek istiyorsanız bizi takip edin VK, X ve Katılın!