Sambungkan Claude Code ke panel Anda

Dengan pengaturan ini, Claude Code bisa melihat panel Anda selagi Anda bekerja di terminal: "akun saya yang mana yang paling dekat dengan batas disk?", "tampilkan record DNS untuk example.com". Asisten hanya membaca apa yang diizinkan token Anda. Apa pun yang menghapus atau menghentikan menjadi sebuah permintaan yang menunggu Anda menekan Setujui di panel. Asisten tidak pernah menyetujui permintaannya sendiri.

Ini cara kedua memakai AI dengan Nimbopanel. Cara pertama, panel obrolan di dalam panel itu sendiri, dijelaskan di Asisten AI. Anda tidak perlu menyalakan yang itu untuk memakai cara ini.

Sebelum mulai

• Alamat panel Anda, misalnya https://panel.yourdomain.com. Pakai alamat panel itu sendiri, bukan IP.
• Claude Code terpasang di komputer Anda (perintah claude jalan di terminal).
• Sebuah akun di panel: administrator, reseller, pelanggan, atau pengguna tim.

1. Administrator menyalakan sambungan (sekali saja)

Buka Sistem → Keamanan → Sambungan asisten AI (MCP), centang Izinkan asisten AI tersambung, pilih jenis orang yang boleh menyambungkannya, lalu tekan Simpan. Kartu itu menampilkan alamat yang dipakai asisten: /mcp pada alamat panel Anda.

Pada instalasi baru, sambungan ini mati. Selama belum dinyalakan, /mcp menjawab 404 dan langkah-langkah di bawah tidak akan berhasil.

2. Buat token khusus untuk asisten

Masuk ke panel dan buka Token API: untuk administrator dan reseller di bawah Keamanan, untuk pelanggan di bawah Lanjutan. Buka Sambungkan asisten AI (Claude dan lainnya).

1. Beri nama yang mudah Anda kenali, misalnya Claude Code di laptop saya.
2. Untuk tiap bagian panel pilih Tanpa akses, Baca, atau Baca dan ubah. Mulailah dengan Baca: asisten bisa melihat semua yang Anda centang dan tidak mengubah apa pun.
3. Biarkan Berhenti bekerja setelah (hari) di angka 90, atau isi angka Anda sendiri.
4. Tekan Buat token asisten.

Panel kini menampilkan token sekali saja. Salin sebelum Anda meninggalkan halaman.

3. Tempel satu perintah

Panel menampilkan perintah dengan alamat dan token Anda sudah terisi. Salin lalu jalankan di terminal. Bentuknya seperti ini:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

Artinya: tambahkan sebuah server MCP bernama nimbopanel, dijangkau lewat HTTP di alamat /mcp panel, dan kirim token Anda di header Authorization pada setiap panggilan.

Di mana Claude Code menyimpannya. Secara bawaan server ini disimpan hanya untuk proyek yang sedang dibuka, di ~/.claude.json pada komputer Anda, bukan di folder proyek. Tambahkan --scope user agar berlaku di setiap proyek. Jangan tambahkan --scope project dengan token asli: itu menulis token ke .mcp.json, berkas yang memang dimaksudkan untuk di-commit dan dibagikan. Bila satu tim memakai sambungan yang sama, taruh rujukan di .mcp.json dan biarkan tiap orang menyimpan tokennya sendiri dalam variabel lingkungan:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

Sebaiknya tiap orang membuat tokennya sendiri, supaya sebuah permintaan menunjukkan siapa yang meminta dan satu token bisa dicabut tanpa mengganggu yang lain.

4. Pastikan sudah jalan

claude mcp list

nimbopanel seharusnya tampil sebagai tersambung. Di dalam Claude Code Anda juga bisa mengetik /mcp. Lalu bertanyalah dengan kata-kata biasa:

• "Daftar akun hosting saya dan beri tahu mana yang memakai disk paling banyak."
• "Tampilkan record DNS untuk example.com."
• "Database saya yang mana yang paling besar?"
• Administrator: "Apakah semua layanan berjalan?", "Apakah antrean surel bertambah?"

Asisten dapat melihat akun beserta pemakaiannya, domain, record DNS, akun surel (tidak pernah kata sandinya), database, cadangan, beban server dan layanan, antrean surel, reseller, dan tiket bantuan, sebatas bagian yang disebut token Anda dan peran Anda sendiri.

Saat Anda meminta perubahan

• Dengan Baca dan ubah, record alamat (A atau AAAA) atau teks (TXT) biasa pada nama baru yang lazim langsung ditambahkan.
• Selebihnya menunggu Anda: menghapus record, menangguhkan atau mengaktifkan kembali akun, record surel, domain itu sendiri, record CNAME, SRV, dan CAA, wildcard, serta nama yang dicari program surel. Semua itu menjadi sebuah permintaan.

Buka Token API → Permintaan asisten. Setiap permintaan menjelaskan dengan bahasa sederhana apa yang akan terjadi. Tekan Setujui…, lalu Ya, lakukan sekarang. Permintaan kedaluwarsa setelah 30 menit. Bacalah permintaannya, bukan pesan asisten: permintaan ditulis oleh panel dan menyebut persis apa yang akan dilakukan.

Karena perubahan ini diminta oleh asisten, panel lebih dulu meminta Anda memastikan bahwa ini Anda dengan sandi (dan kode verifikasi bila Anda memakai masuk dua langkah); sesudahnya panel tidak bertanya lagi selama beberapa menit.

Bila tidak berhasil

Yang Anda lihat	Artinya	Yang perlu dilakukan
404 Not found dari /mcp, atau halaman yang menyatakan belum ada situs yang diatur untuk alamat itu	Sambungan masih mati, atau Anda memakai alamat yang bukan alamat panel itu sendiri (IP, atau domain lain)	Langkah 1; pakai alamat panel itu sendiri, berakhir dengan /mcp
403 forbidden_host	Alamat itu sampai ke panel, tetapi bukan alamat yang dikenalinya sebagai miliknya	Pakai alamat panel itu sendiri, misalnya https://panel.yourdomain.com
401 Login required	Token hilang, salah ketik, kedaluwarsa, atau sudah dicabut	Buat token baru lalu jalankan perintahnya lagi
403 mcp_scope_required	Ini token API biasa, bukan token untuk asisten	Buat token di bawah Sambungkan asisten AI (Claude dan lainnya)
403 mcp_off_for_role	Jenis akun Anda tidak boleh menyambungkan asisten	Minta administrator (langkah 1)
429 rate_limited	Terlalu banyak panggilan dalam waktu singkat	Tunggu semenit
Sebuah bagian panel tidak muncul	Areanya diatur ke Tanpa akses	Buat token baru dengan area itu di Baca

Bila claude mcp list menampilkan kegagalan, biasanya URL-nya kurang /mcp, atau headernya tidak persis Authorization: Bearer <token>.

Melepasnya

claude mcp remove nimbopanel

menghapusnya dari komputer Anda. Agar token berhenti bekerja di mana pun, hapus token itu di Token API; permintaan yang masih terbuka ikut dibatalkan. Administrator dapat mematikan seluruh sambungan di langkah 1, dan /mcp kembali menjawab 404.

Kebiasaan baik

• Utamakan Baca. Pakai Baca dan ubah hanya untuk area yang memang memerlukannya.
• Satu token untuk tiap komputer atau orang, dengan nama yang menyebut pemiliknya.
• Pertahankan batas 90 hari bawaan, atau lebih singkat untuk komputer yang dipakai bersama.
• Jangan pernah menempel token ke obrolan, tiket, atau berkas yang akan Anda commit.

Belum didukung: klien yang hanya bisa tersambung lewat login OAuth. Endpoint ini menerima token di header.