Claude MCP Connector Nedir? 12 Maddelik Kontrol Listesi

Claude MCP connector, Claude yapay zekâ asistanını sipariş sisteminiz, stok tablonuz ya da müşteri kayıtlarınız gibi dış sistemlere bağlayan uzak bir MCP sunucusudur. Anthropic (yeni sekmede açılır), connector'ları ve plugin paketlerini Claude dizinine göndermek için bir geliştirici portalı sunuyor. Bu rehber, Claude MCP connector nedir sorusunu yanıtlar, e-ticarette nerede işe yaradığını gösterir ve canlıya almadan önce işaretleyeceğiniz 12 maddelik bir kontrol listesi verir.

Claude MCP connector nedir?

Claude MCP connector, Claude'a araç ve veri sağlayan, HTTPS üzerinden erişilen uzak bir MCP sunucusudur. Claude bu sunucuya bağlanınca sunucunun listelediği araçları, örneğin "sipariş durumu sorgula" işlevini, sohbet sırasında çağırabilir. Connector sisteminizin Claude'a açılan kapısıdır; hangi araçların açılacağına siz karar verirsiniz.

MCP (Model Context Protocol), yapay zekâ uygulamalarını dış sistemlere bağlamak için açık kaynaklı bir standarttır (yeni sekmede açılır). Resmî belge onu yapay zekâ uygulamaları için USB-C bağlantısına benzetir: her sistem için ayrı kablo yerine tek standart. Claude MCP connector, bu standardın Claude tarafındaki kullanımıdır.

Connector, MCP sunucusu ve plugin arasındaki fark nedir?

MCP bir protokoldür, MCP sunucusu o protokolü konuşan programdır, connector ise Claude'a eklenmiş sunucudur. Plugin bunların üstünde bir pakettir: connector'ı, Claude'a iş akışını öğreten skill'lerle birlikte taşıyabilir.

Yerel bir sunucu dizine tek başına gönderilemez; yerel sunucu yalnızca plugin içinde dağıtılabilir. Dizine girecek connector uzak ve HTTPS adresli olmalıdır.

Anthropic'in yeni portalı ne değiştirdi?

Ücretli bir Claude planındaki herkes, ayrı bir ortaklık programına başvurmadan connector ya da plugin gönderebilir. Gönderim claude.ai/directory/manage adresindeki portaldan yapılır ve Anthropic her gönderimi listelemeden önce kontrol eder.

• Connector otomatik taranır ve varsayılan olarak "Community connector" diye listelenir.
• Bazı gönderimler ayrıca bir kişinin incelemesinden geçer; süre sıraya göre değişir.
• Durum ve inceleme geri bildirimi portalda görünür; yayından sonra sunucu sağlığı ve kullanım ölçümleri de oradadır.

Kurallar Anthropic'in gönderim belgesinde (yeni sekmede açılır) yazılı. Mağaza sahibiyseniz portal doğrudan sizin işiniz olmayabilir: hazır connector'ları kullanırsınız. Kendi sisteminiz için Claude MCP connector yazdırıyorsanız aşağıdaki kontrol listesi tam size göre.

E-ticarette Claude MCP connector nerede işe yarar?

Asistanın mağaza verisini okuması ya da onaylı küçük işlemler yapması gereken yerde işe yarar. Aşağıdaki senaryolar temsilî örnektir; sonuç ya da oran içermez.

Okuma ve yazma ayrımı Anthropic'in kuralıyla uyumlu: connector'daki her aracın bir başlığı ve salt okunur ya da yıkıcı olduğunu bildiren bir işareti olmalıdır. Tablodaki onay sütunu ise Anthropic'in şartı değil, bizim önerimizdir. Sınama sırasında Claude araç çağrısını önce onayınıza sunar.

Claude MCP connector için kod yazmak gerekir mi?

Hazır bir connector eklemek kod gerektirmez; kendi sisteminiz için sunucu geliştirmek ise yazılım işidir. Anthropic'e göre Free, Pro, Max, Team ve Enterprise dahil her Claude hesabı, Customize bölümündeki Connectors sayfasından adresini vererek dizinde olmayan bir connector ekleyebilir.

Yani elinizde çalışan bir sunucu adresi varsa Claude MCP connector eklemek birkaç tıklamadır. Sunucunun kendisini yazmak, kimlik doğrulamayı kurmak ve araçları tanımlamak geliştirici işidir; bu rehberdeki MCP connector kontrol listesi o işin teslim kontrolünü yapmanız içindir.

Claude MCP connector mı, plugin mi göndermelisiniz?

Yalnızca verinize ve araçlarınıza erişim yetiyorsa Claude MCP connector yeterlidir; Claude'a ayrıca iş akışınızı öğretmek istiyorsanız plugin gerekir. Plugin, connector'ı ve skill'leri tek pakette taşır. Skill, Claude'a adımların sırasını, varsayılanları ve iyi çıktının nasıl göründüğünü anlatan yönergedir.

Anthropic, plugin'iniz bir sunucuya işaret etse bile sunucuyu ayrıca connector olarak göndermenizi önerir. Böylece sunucunun ayrıntıları ve kimlik doğrulama ayarları kuruluşunuza tanımlanır. Bizim önerimiz, küçük başlamanız ve önce yalnızca connector göndermenizdir.

Hazır bir connector eklemeden önce nelere bakmalısınız?

Bir connector'ı hesabınıza eklemeden önce kimin yayımladığına, hangi araçları açtığına ve hangi veriye eriştiğine bakın. Connector, Claude'un sizin adınıza çağırabileceği işlevleri listeler; listeyi okumadan eklemek, tanımadığınız birine kapı anahtarı vermek gibidir.

• Yayımlayan: Dizindeki "Community" etiketi connector'ın Anthropic'in otomatik taramasından geçtiğini gösterir; connector'ı yazan tarafı tanımanız yine size kalır.
• Araç listesi: Ekledikten sonra "Tool permissions" altında her aracın ne yaptığını okuyun.
• Okuma mı, yazma mı: Claude araç çağrısını onayınıza sunar; veri değiştiren araçlarda onayı vermeden önce ne yapılacağını okuyun.
• Gizlilik politikası: Dizin listelemesi gizlilik politikası adresi ister; verinin nasıl işlendiğini orada arayın.
• Önce deneme (bizim önerimiz): Gerçek müşteri verisine bağlamadan önce örnek kayıtlarla deneyin.

Connector yazdırmadan önce kendinize hangi beş soruyu sormalısınız?

Önce asistanın hangi canlı veriye ihtiyaç duyduğunu yazın; connector yalnızca bu veri için gerekir. Bu beş soru bizim önerimizdir ve kapsamı küçük tutmanıza yardım eder.

1. Asistan hangi soruya yanıt verecek? Örneğin "Kargom nerede?"
2. Bu yanıt için hangi sistemden hangi alanlar okunacak? Yalnızca onları açın.
3. Veri değiştiren bir işlem var mı? Varsa onayı kim verecek?
4. Kişisel veri geçiyor mu? Geçiyorsa hangi alanlar maskelenebilir?
5. Sunucuyu yayından sonra kim bakımla ve güvenlik sorunlarına yanıt vermekle ilgilenecek?

Bu yanıtlar yazılı olursa geliştiriciye brief vermek de, kontrol listesini işaretlemek de kolaylaşır.

Claude MCP connector kontrol listesi: hangi 12 madde?

Bir maddeye "evet" diyemiyorsanız connector canlıya hazır değildir. Bu MCP connector kontrol listesi, Anthropic'in gönderim ve sınama belgelerindeki şartlara dayanır. Anthropic'in şartı olmayan, bizim önerimiz olan maddeleri "bizim önerimiz" diye işaretledik.

Güvenlik ve yetki

• 1. Dar yetki (bizim önerimiz): Connector yalnızca gereken araçları açıyor; kullanılmayan araç listede yok.
• 2. Kimlik doğrulama: Kullanıcı hesabında işlem yapan araçlar OAuth 2.0 kullanıyor. Yalnızca herkese açık veri sunan sunucu kimlik doğrulamasız olabilir.
• 3. Okuma ve yazma ayrımı: Her aracın başlığı var ve salt okunur ya da yıkıcı olarak işaretli.
• 4. İnsan onayı (bizim önerimiz): Para, stok ya da fiyat etkisi olan araçlar onay bekliyor.

Teknik hazırlık

• 5. HTTPS adresi: Sunucu internetten https:// adresiyle erişilebilir.
• 6. Güvenlik duvarı: CDN ya da WAF, Anthropic'in isteklerini engellemiyor. Kendi uygulamanızın üretmediği 403 yanıtları bunun belirtisidir.
• 7. Yanıt süresi: Kimlik doğrulama uç noktalarının keşif, kayıt ve token yanıtları on saniyenin altında.
• 8. Araç açıklamaları: Her aracın adı ve açıklaması net, çünkü Claude hangi aracı çağıracağına bunları okuyarak karar verir.

Sınama ve yayın

• 9. Özel connector sınaması: Sunucuyu kendi hesabınıza ekleyip her aracı bir sohbetten çağırdınız.
• 10. MCP Inspector: Araç listesini Inspector ile doğruladınız.
• 11. Listeleme malzemesi: Belge adresi, gizlilik politikası adresi, destek iletişimi ve simge hazır.
• 12. İnceleme hesabı: İncelemeyi yapacak kişi için, gerçek kayıtlar içeren bir test hesabı ve adım adım erişim notu hazır.

Kendi sunucunuzu Claude'da nasıl sınarsınız?

Claude MCP connector sınamasında sunucuyu kendi Claude hesabınıza özel connector olarak ekleyip her aracı sohbetten çağırarak sınarsınız. Anthropic ayrı bir deneme ortamı sunmaz; özel connector, dizindeki connector'larla aynı çalışma zamanını kullanır. Ayrıntılar Anthropic'in sınama belgesinde (yeni sekmede açılır).

1. Customize bölümünde Connectors sayfasını açın ve sunucu adresini ekleyin.
2. Connector "Connected" görünmeli. "Connect" ya da "Reconnect" görüyorsanız oturum açma bitmemiştir.
3. Connector sayfasında "Tool permissions" altında her aracın adının ve açıklamasının listelendiğini kontrol edin.
4. Sohbette connector'ı açın, bir araç gerektiren soru sorun ve Claude sorunca çağrıyı onaylayın. Sunucuda isteğin beklenen bilgilerle geldiğini, Claude'da sonucun okunur olduğunu doğrulayın.
5. Sunucu yerel makinenizdeyse Cloudflare Tunnel ya da ngrok gibi bir tünel kullanın. Tünel açıkken kimlik doğrulamayı kapatmayın, işiniz bitince tüneli kapatın.

Araç listesini Claude'a bağlamadan görmek için Inspector komutu şudur:

npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp --transport http --method tools/list

Claude MCP connector kullanırken hangi riskler var?

Asıl risk, connector'ın verdiği yetkinin gerekenden geniş olmasıdır; protokol erişimi kendiliğinden sınırlamaz. Sunucuya ne açtıysanız asistan onu kullanabilir.

• Geniş yetki: Bizim önerimiz: kullanılmayan aracı kapatın, yazma araçlarını onaya bağlayın.
• Kişisel veri (bizim önerimiz): Müşteri adı, telefon ve adres gibi veriler asistana akabilir. Hangi alanların açılacağını baştan belirleyin; KVKK açısından emin değilseniz hukuk danışmanınıza sorun.
• Okunan metindeki talimatlar: Sipariş notu ya da yorum gibi metinler asistanı yönlendirmeye çalışabilir. Bizim önerimiz, yazma araçlarını bu yüzden onaya bağlı tutmaktır.
• Yayın sonrası bakım: Dizine gönderen taraf, güvenlik sorunlarına hızlı yanıt vermeyi ve açıklamaları doğru tutmayı kabul eder.

Claude MCP connector kurulumunda en sık hangi hatalar çıkar?

En sık hata, Claude'un sunucuya ulaşamaması ya da kimlik doğrulamanın tamamlanmamasıdır. Anthropic'in sorun giderme belgeleri bu hataların nedenlerini sıralar; aşağıdaki liste sınama belgesinde geçen başlıca durumları özetler.

• Bağlantı zaman aşımı: Kimlik doğrulama uç noktaları yavaş yanıt veriyor ya da Origin başlığı denetimi Anthropic'in isteklerini reddediyor olabilir.
• 403 yanıtları: Uygulamanızın üretmediği 403 yanıtları genellikle CDN ya da WAF'ın Anthropic trafiğini engellediğini gösterir.
• Eksik araç işaretleri: Başlığı ya da salt okunur/yıkıcı işareti olmayan araçlar portalda uyarı alır; gönderimden önce düzeltin.
• Tünel kullanırken "Invalid Host" hatası: Yerel sunucuyu tünelle açtığınızda, sunucu kütüphanesi yalnızca localhost adreslerini kabul ediyorsa tünelin adı izinli listeye eklenmelidir.
• Bağlı görünmeyen connector: "Connect" ya da "Reconnect" yazıyorsa oturum açma bitmemiştir; kimlik doğrulama akışını yeniden deneyin.

Hata mesajında bir "ofid_" başvuru kimliği görürseniz Anthropic'e destek isterken bu kimliği ekleyin. Bu kimlik, sorunun hangi istekte yaşandığını bulmayı kolaylaştırır.

Geliştiriciye verilecek brief nasıl yazılır?

İyi bir brief, her aracı tek satırda tanımlar: adı, ne yaptığı, hangi bilgiyi alıp hangisini döndürdüğü ve okuma mı yazma mı olduğu. Aşağıdaki tablo temsilî bir şablondur; alan adlarını kendi sisteminize göre değiştirin.

Açıklama alanına özen gösterin: Claude hangi aracı çağıracağına adı ve açıklamayı okuyarak karar verir. Belirsiz bir açıklama, yanlış aracın çağrılmasına yol açabilir. Brief'i hazırlarken yukarıdaki kontrol listesini ek olarak verin; geliştirici hangi maddeleri teslimde göstermesi gerektiğini bilsin.

Connector yayına girdikten sonra neleri izlemelisiniz?

Yayından sonra sunucunun çalışıp çalışmadığını, araçların kullanımını ve hata oranlarını izlemelisiniz. Dizine gönderdiyseniz Anthropic'in portalı sunucu sağlığını, ürün ve araç bazında kullanımı ve hata dökümünü gösterir; portal ayrıca incelemeden gelen geri bildirimleri de listeler.

• Sunucu sağlığı: Bağlantı hatası artıyorsa önce güvenlik duvarını ve kimlik doğrulama yanıt sürelerini kontrol edin.
• Araç kullanımı: Hiç çağrılmayan araç, açıklamasının belirsiz olduğunu ya da gereksiz açıldığını gösterebilir. Gereksiz aracı kapatmak yetkiyi daraltır (bizim önerimiz).
• Güncellemeler: Sunucuyu değiştirdiğinizde araç listesini ve açıklamalarını yeniden doğrulayın, kontrol listesini baştan geçirin (bizim önerimiz).
• Sorun bildirimi: Bir güvenlik sorunu fark ederseniz hızlı yanıt vermek, dizine gönderen tarafın kabul ettiği yükümlülüklerden biridir.

Dizine göndermediyseniz bu ölçümler portalda olmaz. O durumda kendi sunucu kayıtlarınızı kullanın ve hangi aracın ne sıklıkla çağrıldığını kaydedin.

Hangi sisteminizi yapay zekâ asistanına açacağınızı ve insan onayının nerede kalacağını birlikte belirlemek isterseniz ücretsiz sistem analizi talep edebilirsiniz. Asistanın araç yetkisini nasıl daraltacağınızı yapay zeka ajanı nedir yazısında, kurulum desteğini Üretken Yapay Zeka Danışmanlığı sayfasında bulabilirsiniz.

Sık sorulan sorular