~/tools / MCP Config Checker
MCP Config Checker — Periksa kesalahan di file konfigurasi MCP
Periksa file konfigurasi server MCP (.mcp.json atau claude_desktop_config.json) untuk menemukan kesalahan: type yang hilang, key tingkat atas yang salah, nama yang dicadangkan atau tidak valid, path relatif, variabel yang belum diatur, dan rahasia yang tertulis langsung di file. Tidak ada data yang keluar dari browser Anda.
Aturan dicek terhadap dokumentasi pada 2026-10-23.
Dokumentasi: Claude Code / Model Context Protocol / VS Code
Tidak diperiksa: apakah sebuah command ada, apakah sebuah paket bisa diinstal, apakah server jarak jauh merespons, dan pengaturan yang dibaca secara berbeda oleh aplikasi lain.
Semuanya berjalan di browser Anda. Konfigurasi tidak diunggah.
Server MCP diatur lewat sebuah file JSON, dan kesalahan kecil bisa membuat server tidak muncul tanpa pemberitahuan apa pun. Entri server yang punya url tetapi tidak punya type akan dilewati, file yang memakai key servers milik VS Code tidak dibaca oleh Claude Code maupun Claude Desktop, dan variabel lingkungan yang belum diatur diteruskan sebagai teks biasa. Alat ini membaca konfigurasi yang Anda tempelkan, lalu mencantumkan apa yang menurut dokumentasi tidak akan berfungsi, apa yang perlu diperiksa, dan apa yang hanya berupa catatan. Alat ini juga memberi peringatan jika sebuah token tampaknya ditulis langsung di dalam file, tempat ia bisa ikut masuk ke version control. Aturannya berasal dari dokumentasi Claude Code, Model Context Protocol, dan VS Code, yang dicek pada tanggal yang tertera di bawah alat ini.
Kapan dipakai
- Mencari tahu mengapa server MCP tidak muncul setelah Anda mengedit .mcp.json atau claude_desktop_config.json
- Memeriksa konfigurasi yang Anda salin dari sebuah README sebelum menambahkannya ke proyek bersama
- Menemukan token dan kata sandi yang tertulis di file konfigurasi sebelum file itu di-commit
Cara pakai
- Tempelkan isi file konfigurasi MCP Anda, atau muat contohnya.
- Baca server yang ditemukan beserta jenis masing-masing, lalu daftar temuan. Perbaiki berarti dokumentasi menyatakan entri itu tidak akan berfungsi, Periksa berarti layak dilihat, dan Catatan berisi informasi saja.
- Edit file, tempelkan lagi, lalu mulai ulang aplikasi yang membacanya.
Tanya jawab
File dan aplikasi apa saja yang dicakup?
Format mcpServers yang dipakai oleh file proyek .mcp.json di Claude Code dan oleh claude_desktop_config.json di Claude Desktop. Aplikasi lain mungkin membaca field yang berbeda atau key tingkat atas yang berbeda, jadi periksa dokumentasinya sendiri. VS Code, misalnya, memakai key tingkat atas bernama servers.
Entri saya punya url tetapi tidak punya type. Mengapa itu masalah?
Claude Code membaca entri tanpa type sebagai server stdio, sehingga entri yang punya url tetapi tidak punya type adalah kesalahan konfigurasi dan servernya dilewati. Tambahkan type berupa http, sse, atau ws.
Apa yang terjadi pada variabel seperti ${API_KEY} yang belum diatur?
Claude Code memperluas ${VAR} dan ${VAR:-default} di command, args, env, url, dan headers. Jika sebuah variabel belum diatur dan tidak punya nilai default, konfigurasi tetap dimuat, Claude Code menampilkan peringatan dan memakai teks ${VAR} apa adanya. Tambahkan nilai default dengan ${VAR:-default} jika itu aman.
Mengapa alat ini memperingatkan soal token di dalam file?
Token yang ditulis langsung di file konfigurasi bisa ikut terbagikan saat file di-commit atau dikirim ke orang lain. Pemeriksaannya bersifat heuristik, berdasarkan format token yang dikenal dan nama seperti api-key, token, dan password, sehingga bisa saja melewatkan sebuah rahasia atau menandai nilai yang tidak berbahaya. Memakai ${VAR} menjaga nilai itu tetap di luar file.
Apakah alat ini menjalankan server atau menguji koneksinya?
Tidak. Alat ini hanya membaca teks. Ia tidak bisa tahu apakah sebuah command ada, apakah sebuah paket bisa diinstal, atau apakah server jarak jauh bisa dijangkau, jadi uji server di aplikasinya setelah file lolos pemeriksaan.
Apakah konfigurasi saya dikirim ke server?
Tidak. Pemeriksaan berjalan di browser Anda.