Penyelesaian masalah MCP
Checklist di bawah mengasumsikan Anda sudah menjalankan bccli mcp add <name> dan memeriksa server dari bccli mcp list.
Server tidak mau start
- Periksa command-nya ada (
npx/biner di PATH). - Baca stderr server di log BotConnector.
- Server stdio butuh command + args persis sebagai list, bukan string shell.
Tools tidak terlihat oleh model
- Refresh server di permukaan manajemen MCP dan konfirmasi daftar tools.
- Tool harus ada di
allowedTools— lihat Izin MCP. - Model yang dimuat harus mendukung tool calling — Tool use.
Panggilan gagal saat runtime
- Timeout: server MCP adalah proses terpisah; tool yang menggantung memblokir panggilan — periksa status proses.
- Permission denied: tool terdaftar tapi tidak di allowlist (perilaku yang dimaksudkan).
- Argumen rusak: model menghasilkan JSON yang gagal skema tool; coba model atau kuantisasi dengan mutu lebih tinggi.
Respons insiden keamanan
- Nonaktifkan atau hapus server, atau keluarkan tool dari allowlist-nya, segera.
- Tinjau log untuk jendela waktu yang terdampak.
- Rotasi kredensial apa pun yang bisa dibaca oleh tools yang terekspos.