~/tools / MCP Config Checker
MCP Config Checker — Bir MCP yapılandırma dosyasını hatalara karşı kontrol edin
Bir MCP sunucu yapılandırma dosyasını (.mcp.json veya claude_desktop_config.json) hatalara karşı kontrol edin: eksik type, yanlış üst düzey anahtar, ayrılmış veya geçersiz adlar, göreli yollar, tanımlanmamış değişkenler ve dosyaya yazılmış gizli bilgiler. Hiçbir şey tarayıcınızdan çıkmaz.
Kurallar, belgelere göre 2026-10-23 tarihinde kontrol edildi.
Belgeler: Claude Code / Model Context Protocol / VS Code
Kontrol edilmeyenler: bir komutun var olup olmadığı, bir paketin yüklenip yüklenmediği, uzak bir sunucunun yanıt verip vermediği ve diğer uygulamaların farklı okuduğu ayarlar.
Her şey tarayıcınızda çalışır. Yapılandırma yüklenmez.
MCP sunucuları bir JSON dosyasında tanımlanır ve küçük bir hata, bir sunucunun sessizce görünmemesine yol açabilir. url içeren ama type içermeyen bir sunucu girdisi atlanır, VS Code'un servers anahtarını kullanan bir dosya Claude Code veya Claude Desktop tarafından okunmaz ve tanımlanmamış bir ortam değişkeni düz metin olarak aktarılır. Bu araç yapıştırdığınız yapılandırmayı okur; belgelere göre çalışmayacak olanları, kontrol etmeye değer olanları ve yalnızca not niteliğindekileri listeler. Ayrıca bir belirteç doğrudan dosyaya yazılmış göründüğünde uyarır; böyle bir belirteç sürüm kontrolüne girebilir. Kurallar Claude Code, Model Context Protocol ve VS Code belgelerinden alınmıştır ve aracın altında gösterilen tarihte kontrol edilmiştir.
Kullanım örnekleri
- .mcp.json veya claude_desktop_config.json dosyasını düzenledikten sonra bir MCP sunucusunun neden görünmediğini bulmak
- Bir README'den kopyaladığınız yapılandırmayı paylaşılan bir projeye eklemeden önce kontrol etmek
- Bir yapılandırma dosyasına yazılmış belirteç ve parolaları, dosya commit edilmeden önce fark etmek
Nasıl kullanılır
- MCP yapılandırma dosyanızın içeriğini yapıştırın ya da örneği yükleyin.
- Bulunan sunucuları ve her birinin türünü, ardından bulguların listesini okuyun. Düzelt, belgelere göre girdinin çalışmayacağı anlamına gelir; Kontrol et, bakmaya değer olduğunu; Not ise yalnızca bilgi olduğunu gösterir.
- Dosyayı düzenleyin, yeniden yapıştırın ve onu okuyan uygulamayı yeniden başlatın.
SSS
Hangi dosyaları ve uygulamaları kapsar?
Claude Code'daki .mcp.json proje dosyasının ve Claude Desktop'taki claude_desktop_config.json dosyasının kullandığı mcpServers biçimini. Diğer uygulamalar farklı alanlar ya da farklı bir üst düzey anahtar okuyabilir; bunun için kendi belgelerine bakın. Örneğin VS Code, servers adlı bir üst düzey anahtar kullanır.
Girdimde url var ama type yok. Bu neden sorun?
Claude Code, type içermeyen bir girdiyi stdio sunucusu olarak okur; bu yüzden url içeren ama type içermeyen bir girdi yapılandırma hatasıdır ve sunucu atlanır. http, sse veya ws türünde bir type ekleyin.
Tanımlanmamış bir ${API_KEY} gibi değişkene ne olur?
Claude Code, command, args, env, url ve headers içindeki ${VAR} ve ${VAR:-default} ifadelerini genişletir. Bir değişken tanımlı değilse ve varsayılan değeri yoksa yapılandırma yine de yüklenir, Claude Code bir uyarı gösterir ve ${VAR} metnini yazıldığı gibi kullanır. Güvenli olduğu yerlerde ${VAR:-default} ile bir varsayılan değer ekleyin.
Dosyadaki belirteç için neden uyarıyor?
Doğrudan bir yapılandırma dosyasına yazılan belirteç, dosya commit edildiğinde ya da birine gönderildiğinde paylaşılabilir. Kontrol, bilinen belirteç biçimlerine ve api-key, token, password gibi adlara dayanan bir sezgiseldir; bu yüzden bir gizli bilgiyi kaçırabilir veya zararsız bir değeri işaretleyebilir. ${VAR} kullanmak değeri dosyanın dışında tutar.
Sunucuyu başlatıyor mu ya da bağlantıyı test ediyor mu?
Hayır. Yalnızca metni okur. Bir komutun var olup olmadığını, bir paketin yüklenip yüklenemeyeceğini ya da uzak bir sunucuya ulaşılıp ulaşılamayacağını söyleyemez; bu yüzden dosya kontrolü geçtikten sonra sunucuyu uygulamada test edin.
Yapılandırmam bir sunucuya gönderiliyor mu?
Hayır. Kontrol tarayıcınızda çalışır.