BotConnector
Masuk Workspace Buka Aplikasi

Penyelesaian masalah MCP

Beta

Permukaan MCP adalah beta preview lokal. Checklist di bawah mengasumsikan permukaan manajemen MCP tersedia di build Anda.

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

  1. Refresh server di permukaan manajemen MCP dan konfirmasi daftar tools.
  2. Tool harus ada di allowedTools — lihat Izin MCP.
  3. 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 lebih mampu.

Respons insiden keamanan

  1. Nonaktifkan atau hapus server, atau keluarkan tool dari allowlist-nya, segera.
  2. Tinjau log untuk jendela waktu yang terdampak.
  3. Rotasi kredensial apa pun yang bisa dibaca oleh tools yang terekspos.

Terkait