MCP yapılandırması: yapıyı, bağlantıyı ve izinleri anlayın
MCP kurulumunu üç adımda ele almak sorun gidermeyi kolaylaştırır: dosya yapısını inceleyin, bağlantıyı sınayın, ardından sunucuyu ve istenen izinleri değerlendirin. Yapı denetimi ilk adımı kapsar; bağlantı ve güven için ayrı kontroller gerekir.
Bunlar 3 ayrı sorudur
Uygulama yapılandırmayı okuyabiliyor mu? Bağlantı çalışıyor mu? Kaynak ve yetkiler verileriniz için uygun mu? İlkine evet demek diğerlerini yanıtlamaz.
MCP, istemciyi yetenekler sağlayan bir sunucuya bağlar. Sunucu stdio kullanan yerel bir program veya HTTP kullanan bir hizmet olabilir; bağlantı yöntemi incelenecek noktaları değiştirir.
Kaynaklar: Model Context Protocol — Clients, servers and transports
İstemcinizin kabul ettiği biçimi kontrol edin
ToolRoof, mcpServers altında belirli bir JSON alt kümesini denetler: isteğe bağlı args ve env ile command ya da isteğe bağlı headers ile url. Aynı kayıtta command ve url bulunması hatadır; tanınmayan alanlar uyarı üretir.
Bu, tüm MCP uygulamalarının yapılandırma biçimi değildir. Kapsam dışındaki geçerli seçenekleri silmeden önce istemci belgesine bakın. Araç komut çalıştırmaz, adres açmaz veya kimlik doğrulamasını sınamaz.
Uyarı, kapsamlı gizli bilgi tespiti değildir
Argümanlar, ortam değişkenleri ve başlıklar hassas veri içerebilir. Bu alanların işaretlenmesi her değerin gizli olduğunu veya uyarısız dosyada gizli bilgi bulunmadığını kanıtlamaz.
Gerçek yapılandırmayı herkese açık destek kaydına koymayın. Hassas verileri çıkarılmış bir örnek kullanın; bağlantıdan önce kaynağı ve yetkileri inceleyin. HTTPS ve geçerli JSON tek başına güven sağlamaz.
Örnek: geçerli sonucun dar anlamı
{"mcpServers":{"notes":{"url":"https://example.com/mcp","type":"http"}}} desteklenen alt kümede tek sunucu tanımlar. Geçmesi yalnızca biçimi doğrular; example.com örnek adrestir, sınanmış MCP sunucusu değildir.
Aynı kayda command eklemek belirsiz bağlantı yöntemi nedeniyle başarısız olur. headers içine {"X-Mode":"demo"} eklemek ise yapıyı geçerli bırakır, ancak inceleme uyarısı oluşturur. Bu, demo sözcüğünün gizli kimlik bilgisi olduğu anlamına gelmez.