Men-debug Server yang Tidak Mau Mulai

Terkadang Anda memulai ulang host, tetapi alat-alat Anda tidak muncul. Jangan panik: kegagalan saat memulai mengikuti beberapa pola yang dapat diprediksi. 🛠️

Langkah pertama Anda selalu memeriksa catatan. Claude Desktop menulis berkas catatan untuk setiap server yang mencatat alasan persis proses tersebut gagal dimulai.

Penyebab utamanya adalah perintah yang salah atau jalur skrip relatif. Host tidak dapat menemukan python atau file Anda, sehingga prosesnya bahkan tidak pernah berjalan.

Jalankan secara manual perintah yang sama persis dari konfigurasi Anda. Jika perintah tersebut gagal di terminal, perintah itu juga akan gagal untuk host, dan kesalahannya terlihat langsung di sana.

ImportError berarti host menjalankan Python tanpa paket Anda. Tetapkan interpreter secara eksplisit atau gunakan uv agar lingkungan yang tepat digunakan.

Ini sering luput diperhatikan: setiap print ke stdout merusak proses jabat tangan, sehingga klien menyerah. Pindahkan semua print ke stderr, lalu coba lagi.

Satu koma di akhir membuat claude_desktop_config.json tidak valid, sehingga host sama sekali tidak memuat server. Jika ragu, validasikan file tersebut.

Kesalahan paling sederhana: Anda mengedit konfigurasi tetapi tidak pernah memulai ulang. Keluar sepenuhnya dari Claude, bukan hanya menutup jendelanya, lalu buka kembali.

Masih terhenti? Jalankan server di Inspector. Jika server berfungsi di sana tetapi tidak di host, masalahnya ada pada konfigurasi Anda, bukan kode Anda.

Jangan menebak-nebak. Jejak balik di stderr menyebutkan baris dan pengecualian yang tepat. Baca semuanya sebelum mengubah apa pun. 📋

Saat mengedit, ubah satu hal saja, lalu uji ulang. Mengubah tiga pengaturan sekaligus menyamarkan perbaikan mana yang sebenarnya menyelesaikan masalah.

Anda telah belajar membaca log, menguji perintah secara langsung, memperbaiki jalur, dependensi, dan keluaran print yang terselip, serta memisahkan masalah dengan Inspector. Server Anda telah terverifikasi! 🎉