Troubleshooting Claude MCP Bridge — Solusi Error Umum & Cara Minta Bantuan Claude Desktop

Panduan lengkap mengatasi masalah yang sering terjadi saat menggunakan Claude MCP Bridge. Sebagian besar kendala bisa diselesaikan sendiri dalam beberapa menit dengan panduan ini. Di bagian akhir, kami juga sediakan template prompt yang bisa Anda copy-paste langsung ke Claude Desktop untuk minta bantuan debugging otomatis.

🔍 Cara Membaca Error dengan Cepat

Setiap error di Claude MCP Bridge biasanya punya kode status yang menunjukkan sumber masalah:

• Error 401 — Masalah autentikasi (Application Password salah)
• Error 403 — Masalah API Key (tidak cocok dengan plugin)
• Error 404 — Endpoint tidak ditemukan (plugin belum aktif)
• Server disconnected — Masalah di file konfigurasi atau MCP Server
• Network error — Masalah koneksi atau format domain salah

❌ Error 1: “Server disconnected” / MCP failed

Gejala: Di Settings → Developer, MCP server berstatus “failed” berwarna merah.

Penyebab paling umum: Ada kesalahan format (syntax error) di file claude_desktop_config.json.

Solusi:

1. Buka file config: %APPDATA%\Claude\claude_desktop_config.json
2. Copy seluruh isinya, paste ke jsonlint.com untuk cek format
3. Kesalahan umum: ada tanda koma berlebih, kurung kurawal { } tidak seimbang, atau tanda kutip yang salah
4. Perbaiki sesuai petunjuk JSONLint, simpan, lalu restart Claude Desktop

Tips: Pastikan setiap path menggunakan double backslash \\ bukan single \.

❌ Error 2: “401 Unauthorized”

Gejala: Muncul pesan “Application Password salah” atau “rest_forbidden”.

Penyebab: Application Password di sites.json tidak valid atau salah copy.

Solusi:

1. Login ke WordPress admin website yang bermasalah
2. Pergi ke Users → Profile (atau Pengguna → Profil)
3. Scroll ke bagian Application Passwords
4. Buat password baru dengan nama “Claude MCP”, klik Add New
5. Copy password yang muncul (formatnya seperti: xxxx xxxx xxxx xxxx xxxx xxxx)
6. Buka sites.json, ganti nilai app_password dengan yang baru
7. Simpan file, lalu restart Claude Desktop

Penting: Application Password berbeda dengan password login WordPress Anda. Jangan gunakan password login biasa.

❌ Error 3: “403 Forbidden” — API Key tidak valid

Gejala: Muncul pesan “API Key tidak valid”.

Penyebab: API Key di sites.json tidak cocok dengan yang ada di plugin.

Solusi:

1. Login ke WordPress admin website tersebut
2. Pergi ke Settings → Claude MCP (atau Claude MCP Pro untuk Multi Site)
3. Pastikan lisensi berstatus aktif
4. Klik tombol 🔄 Generate untuk membuat API Key baru
5. Copy API Key yang muncul
6. Update nilai api_key di sites.json
7. Simpan dan restart Claude Desktop

❌ Error 4: Data website salah / tertukar dengan domain lain

Gejala: Saat cek koneksi ke subdomain (misalnya sub.website.com), yang muncul justru data dari domain utama (website.com).

Penyebab: Menggunakan versi MCP Server lama yang punya bug routing subdomain.

Solusi:

1. Pastikan Anda menggunakan MCP Server versi 3.2 atau lebih baru
2. Versi 3.2 sudah memperbaiki logika pencocokan domain agar subdomain tidak tertukar dengan domain utama
3. Jika masih pakai versi lama, download versi terbaru dan ganti file index.js
4. Restart Claude Desktop setelah update

❌ Error 5: “Domain tidak ditemukan”

Gejala: Claude bilang domain tidak terdaftar padahal sudah ditambahkan.

Penyebab: Format sites.json salah, atau MCP Server belum restart setelah edit.

Solusi:

1. Pastikan URL menggunakan https:// di depan dan tidak ada slash di akhir
2. Pastikan semua website berada dalam satu array "sites": [ ] — bukan array terpisah
3. Validasi format JSON di jsonlint.com
4. Setelah menyimpan sites.json, restart Claude Desktop sepenuhnya

❌ Error 6: Perubahan sites.json tidak terbaca

Gejala: Sudah edit sites.json tapi Claude masih pakai data lama.

Penyebab: MCP Server membaca sites.json saat pertama kali dijalankan, jadi perlu restart.

Solusi restart yang benar:

1. Tekan Ctrl+Shift+Esc untuk buka Task Manager
2. Cari semua proses bernama Claude, klik kanan → End Task
3. Cari juga proses node, End Task juga
4. Tunggu 5 detik, lalu buka Claude Desktop kembali

Jika masih belum berhasil, restart komputer untuk memastikan semua proses benar-benar tertutup.

❌ Error 7: MCP tidak muncul sama sekali di Claude Desktop

Gejala: Tool WordPress tidak tersedia, Claude tidak mengenali perintah upload.

Solusi:

1. Pastikan Node.js sudah terinstall — buka CMD, ketik node -v, harus muncul versi (v20 atau lebih tinggi)
2. Pastikan sudah menjalankan npm install di folder MCP Server
3. Cek path di claude_desktop_config.json sudah benar mengarah ke file index.js
4. Cek di Settings → Developer apakah server muncul dan berstatus “running”

📋 Template Prompt untuk Minta Bantuan Claude Desktop

Salah satu keunggulan Claude MCP Bridge adalah Anda bisa minta bantuan langsung ke Claude Desktop di PC Anda untuk debugging. Berikut template prompt yang bisa Anda copy-paste sesuai jenis masalah:

Template 1: Untuk Error Koneksi Umum

Saya menggunakan plugin Claude MCP Bridge untuk WordPress. Saat cek koneksi ke [nama-domain.com], muncul error berikut:

[paste pesan error lengkap di sini]

Tolong bantu saya identifikasi penyebabnya dan langkah perbaikannya. Ini isi sites.json saya (saya sudah sensor password): [paste struktur sites.json tanpa password asli]

Template 2: Untuk Error JSON Config

File claude_desktop_config.json saya menyebabkan MCP server gagal jalan (status failed). Tolong cek apakah ada kesalahan format JSON di config berikut dan perbaiki:

[paste isi claude_desktop_config.json — hapus dulu API key dan password sensitif]

Template 3: Untuk Error Saat Upload

Saya coba upload halaman ke WordPress via Claude MCP Bridge, tapi muncul error:

[paste pesan error]

Domain: [nama-domain.com]. Plugin sudah aktif dan lisensi valid. Apa kemungkinan penyebabnya dan bagaimana solusinya?

Template 4: Untuk Setup Awal

Saya baru beli plugin Claude MCP Bridge dan sedang setup pertama kali. Saya sudah install plugin di WordPress dan aktivasi lisensi. Sekarang bingung di langkah konfigurasi MCP Server. Tolong pandu saya step by step untuk menghubungkan ke Claude Desktop. Sistem operasi saya: Windows.

💡 Tips Mencegah Masalah

• Selalu backup sites.json sebelum melakukan perubahan besar
• Catat API Key dan Application Password setiap website di tempat aman
• Gunakan versi plugin dan MCP Server terbaru untuk mendapat perbaikan bug
• Validasi JSON di jsonlint.com setiap kali edit file konfigurasi
• Restart Claude Desktop sepenuhnya setiap kali mengubah file konfigurasi

🆘 Masih Butuh Bantuan?

Jika sudah mencoba semua langkah di atas dan masalah belum teratasi, hubungi tim support Prospekit melalui halaman kontak. Sertakan informasi berikut agar kami bisa membantu lebih cepat:

• Pesan error lengkap (screenshot lebih baik)
• Paket yang digunakan (Single Site atau Multi Site PRO)
• Sistem operasi (Windows/Mac)
• Langkah yang sudah dicoba

Untuk masalah yang berkaitan dengan lisensi atau API Key, tim support kami siap membantu karena hal ini memerlukan akses ke server lisensi kami.