Taşımayı bilinçli seçin
Yerel bir stdio sunucusu ile uzak bir HTTP hizmetinin dağıtım gereksinimleri farklıdır. Desteklenen bir uzak taşıma, TLS ve kimliği doğrulanmış bir rota kullanın. Her uygulamanın aynı yetenekleri desteklediğini varsaymak yerine istemci ve sunucu sürümlerini kontrol edin.
Her aracı bir API olarak ele alın
Argümanları doğrulayın, kullanıcıya özgü yetkilendirmeyi uygulayın ve kaynakları sınırlayın. Rastgele kabuk yürütmeyi bir kolaylık aracı olarak sunmayın. Bir aracın URL getirdiği yerlerde giden hedefleri kısıtlayın ve sırları açıklamalardan ve yanıtlardan uzak tutun.
Kimlik toplamayı ölçülü tutun
KYC'siz bir barındırıcı sağlayıcı kayıt verilerini en aza indirebilir, ancak MCP hizmeti yine de kendi kullanıcılarına, oturum güvenliğine ve kötüye kullanım kontrollerine ihtiyaç duyabilir. Neyi günlüğe kaydettiğini açıklayın ve araç girdilerini tanımlı bir amaç olmadan saklamaktan kaçının.
Operasyonel netlik için dağıtın
Ayrılmış bir kullanıcı altında çalıştırın, sağlık kontrolleri kullanın, istek sürelerini sınırlayın ve ters proxy'nin arabelleğe alma ve zaman aşımı ayarlarını protokolle uyumlu tutun. Yazma ayrıcalıkları vermeden önce kimlik doğrulama, iptal, bağlantı kesilmeleri ve yeniden denemeleri test edin.
Kimlik doğrulamayı desteklenen protokolle uyumlu hale getirin
HTTP tabanlı bir MCP dağıtımı için protokolün güncel yetkilendirme gereksinimlerini ve istemcinin desteklediği sürümü inceleyin. OAuth tabanlı kaynak erişimi, ana sayfadaki basit bir paroladan değil, belirteç hedef kitlesi, keşif ve kapsam içerir. HTTPS kullanın, belirteçleri amaçlanan kaynak için doğrulayın ve bearer kimlik bilgilerini sorgu dizelerinin dışında tutun. Bir stdio sunucusu farklı bir yerel kimlik bilgisi sınırı kullanır.
- Kimliği doğrulanmamış bir isteği test edin
- Kimliği doğrulanmış bir isteği kapsamı dışında test edin
- Bir kimlik bilgisini iptal edin ve çalışmayı durdurduğunu doğrulayın
Resmi belgeler: MCP yetkilendirme şartnamesi
Sınırlı bir ilk araç seti yayınlayın
Sınırlı miktarda veri döndüren salt okunur araçlarla başlayın. Dosya yazma, sunucu yaşam döngüsü işlemleri veya harici mesajları yalnızca izinleri ve yinelenen davranışları anlaşıldıktan sonra ekleyin. Döndürülen web sayfalarını ve belgeleri güvenilmeyen girdi olarak değerlendirin; araç sunucusunun yetkisini sessizce genişletmemelidirler.
Proxy kurallarını yazmadan önce protokol davranışını sabitleyin
Hem sunucu SDK sürümünü hem de istemcinin kullanacağı MCP revizyonunu kaydedin. 2026-07-28 Streamable HTTP revizyonunda istekler bir POST uç noktası kullanır; protokol oturumlarına veya bağımsız bir GET akışına dayanan daha eski örnekler farklı bir revizyondur. Hangi istemciyi desteklediğinizi bilene kadar görünürdeki bir uyumluluk gereksinimini kaldırmayın. Ters proxy, o sürüm için gerekli başlıkları, HTTP durumunu ve yanıt akışı davranışını korumalıdır.
- Bir geri döngü dinleyicisinde salt okunur bir araçla başlayın, ardından amaçlanan HTTPS/kimlik doğrulama sınırını önüne yerleştirin.
- Genel proxy üzerinden normal bir sonucu, akış sonucunu, zaman aşımını ve bağlantısı kesilmiş bir istemciyi test edin.
- İzin verilen Origin değerlerini taşıma katmanının gerektirdiği şekilde doğrulayın; bir Origin kontrolü, çağıranın kimliğini doğrulamanın yerini tutmaz.
- Olaylar yalnızca sonda geliyorsa, araç kodunu değiştirmeden önce proxy arabelleğe alma ve zaman aşımı davranışını inceleyin.
Resmi belgeler: MCP 2026-07-28: Akışla oynatılabilir HTTP
Yetkilendirme hatalarını başarı kadar bilinçli test edin
OAuth ile korunan HTTP erişimi için MCP sunucusu korunan bir kaynaktır. Meta veri keşfini, beklenen veren ve belirteç hedef kitlesini ve belirli bir işlem için gereken kapsamları test edin. Yetkilendirme belirtecini URL sorgu dizelerinin dışında tutun ve ilgisiz bir alt hizmete değiştirmeden asla iletmeyin. İstemciye yönelik bir kimlik doğrulama hatası, istemcinin desteklenen akışı aracılığıyla kurtulabilmesi için uygun HTTP sorgusunu korumalıdır.
- Belirteç yok veya süresi dolmuş belirteç: korunan uç nokta özel araç verilerini döndürmek yerine erişimi reddeder.
- Geçerli ancak yetersiz izinli belirteç: istenen kaynağa erişilemiyor.
- Başka bir hedef kitleye ait belirteç: imzası başka açıdan geçerli olsa bile reddedin.
- Beklenmeyen harici URL veya dosya yolu: getirmeden veya yazmadan önce aracın yetkisine göre doğrulayın.
- Günlükler ve hata izleri: tokenları ve özel araç girdilerini kaldırırken bir işlem tanımlayıcısı ve sonucu saklayın.
Resmi belgeler: MCP 2026-07-28: HTTP yetkilendirmesi · MCP: güvenlik en iyi uygulamaları