Deploy dan debug proyek Zenavo langsung dari Claude Code

Saat selesai mengubah kode dan siap men-deploy — atau saat layanan tiba-tiba gagal berjalan — Anda biasanya harus bolak-balik antara terminal dan konsol browser: mencari proyek, menekan tombol deploy, menunggu proses build, lalu memeriksa log.

Dengan menghubungkan MCP dan Skills Zenavo ke Claude Code, semua langkah itu bisa dilakukan langsung di dalam satu percakapan terminal — misalnya cukup katakan: "Periksa mengapa deploy terakhir layanan web gagal, tampilkan baris error dari log, dan berikan saran perbaikannya."

Jika Anda hanya ingin bertanya langsung ke AI di browser tanpa memasang apa pun di komputer, klik Zenavo Agent di tepi kanan halaman konsol mana pun: ia mengenali halaman yang sedang Anda buka, membaca log serta riwayat deploy, dan mengusulkan perubahan (deploy, rollback, restart, atau mengatur variabel) lewat kartu konfirmasi langsung di halaman. Panduan ini membahas cara menghubungkan kemampuan yang sama ke Claude Code di komputer Anda.

1. Pasang dan login ke zenavo-mcp

Unduh file biner sesuai sistem operasi Anda dari zenavo-mcp Releases, letakkan di PATH, lalu jalankan di terminal:

zenavo-mcp login

Browser akan membuka halaman otorisasi perangkat. Pastikan kode di halaman sesuai dengan yang tampil di terminal, lalu pilih cakupan izin yang ingin diberikan:

• Hanya baca (Read-only): hanya bisa melihat proyek, status layanan, riwayat deploy, log, dan nama variabel lingkungan (tidak bisa melihat isi variabel), cocok untuk mencari sumber masalah sehari-hari;
• Deploy: selain izin baca, mengizinkan menjalankan deploy, me-restart layanan, melakukan rollback versi, dan mengubah variabel lingkungan.

Pada cakupan proyek, pilih Hanya sebagian proyek dan centang proyek yang sedang Anda kerjakan saja. Setelah disetujui, token disimpan di komputer lokal dan Anda tidak perlu menempelkan API key apa pun ke jendela chat.

Selanjutnya, pasang plugin Zenavo di Claude Code (sudah mencakup konfigurasi MCP serta Skills untuk deploy, debug, rollback, dan pengelolaan variabel):

claude plugin marketplace add Zenavo-App/zenavo-skills
claude plugin install zenavo@zenavo

Jika Anda hanya memerlukan koneksi MCP tanpa plugin, jalankan claude mcp add zenavo -- zenavo-mcp. Cara menghubungkan klien lain (Cursor, Windsurf, dan lainnya) tersedia di dokumentasi Agen AI dan halaman Skills.

2. Periksa status proyek dan riwayat deploy

Kirim perintah baca terlebih dahulu untuk memastikan Claude Code sudah terhubung ke proyek Anda:

Periksa proyek saya di Zenavo, tampilkan daftar layanan beserta status berjalan dan hasil deploy terakhirnya.

Claude Code akan memanggil MCP untuk menampilkan daftar layanan, status saat ini (Running / Crashed, dll.), serta tugas build dan deploy terakhir.

Demi keamanan, MCP tidak pernah mengembalikan nilai teks asli dari variabel lingkungan (hanya menampilkan nama variabelnya), serta tidak dapat membaca isi tabel database maupun mengunduh file backup. Dengan begitu, meskipun konteks log dikirim ke model saat menelusuri masalah, kunci rahasia dan data pelanggan Anda tetap aman.

3. Temukan penyebab gagal build atau gagal start lewat log

Saat sebuah layanan gagal di-deploy atau terus-menerus restart, minta Claude Code memeriksa log berdasarkan tahapannya:

Periksa deploy terakhir yang gagal pada layanan web.
Lihat log untuk menentukan apakah gagalnya di tahap instalasi dependensi, build kode, start kontainer, atau health check, tampilkan error utamanya, dan berikan saran perbaikan.

Setelah penyebab pastinya terlihat, Anda bisa langsung menindaklanjutinya:

• Error dependensi atau build: minta Claude Code memperbaiki kode di lokal, memastikan build berhasil, lalu commit dan push ke GitHub;
• Variabel lingkungan belum lengkap: minta ia menambahkan variabel tersebut (setelah Anda konfirmasi) dan me-restart layanan;
• Port atau health check tidak cocok: pastikan kode aplikasi mendengarkan pada 0.0.0.0 dan port-nya sama dengan port HTTP yang diatur pada layanan.

4. Jalankan deploy dan verifikasi

Saat ingin menjalankan rilis secara manual, Anda cukup mengatakan:

Deploy layanan web di proyek pengujian, pantau sampai proses build dan pembaruan selesai, lalu periksa apakah ada error di log awal.

Catatan: Zenavo men-deploy branch Git jarak jauh atau image Docker yang terhubung pada layanan tersebut. Kode yang sudah Anda ubah di komputer lokal tetapi belum di-git push harus di-push terlebih dahulu ke repositori sebelum meminta Claude Code menjalankan deploy.

Setiap tindakan yang melakukan perubahan (deploy, restart, mengubah variabel, atau rollback) akan menampilkan parameter yang akan dijalankan dan meminta konfirmasi Anda terlebih dahulu.

5. Rollback cepat saat rilis baru bermasalah

Jika versi baru yang baru saja tayang bermasalah, Anda bisa memintanya kembali ke versi normal sebelumnya:

Lihat riwayat deploy layanan web, temukan versi terakhir yang berhasil, bantu saya rollback ke sana, dan pastikan layanan kembali normal.

Satu hal yang perlu diingat sebelum rollback: rollback layanan hanya mengembalikan image aplikasi dan variabel lingkungan saat itu, tidak mengembalikan struktur database atau volume data (lihat dokumentasi Rollback). Jika rilis tersebut juga menjalankan migrasi database yang tidak kompatibel mundur, pastikan terlebih dahulu apakah kode versi lama masih bisa berjalan dengan struktur database saat ini.

6. Log audit dan pencabutan izin

Setiap deploy, restart, rollback, dan perubahan variabel yang dijalankan lewat MCP tercatat di log audit pada konsol.

Kunci otorisasi yang dibuat oleh zenavo-mcp login tampil di konsol pada Akun → Kunci API dengan nama MCP on <nama-komputer> dan berlaku selama 90 hari. Saat berganti komputer atau sudah tidak digunakan lagi, Anda bisa menghapusnya kapan saja dari halaman tersebut untuk langsung mencabut akses.

Pertanyaan umum

Apakah ia bisa membantu membeli server, menghapus proyek, atau melihat isi tabel di database? Tidak bisa. Zenavo MCP sengaja tidak menyertakan tindakan berisiko tinggi seperti membeli atau menghapus server, menghapus proyek, mengubah tagihan, membuka terminal kontainer, membaca isi database, maupun mengunduh backup. Semua tindakan tersebut hanya bisa dilakukan langsung oleh manusia di konsol.

Sudah memasang plugin tetapi proyek tidak terlihat? Pastikan Anda sudah menjalankan zenavo-mcp login di terminal, dan periksa apakah proyek tersebut sudah dicentang saat memberikan otorisasi. Untuk menambah proyek yang diizinkan, cukup jalankan kembali zenavo-mcp login.

Bagaimana memilih antara mode Hanya baca dan mode Deploy? Untuk proyek produksi sehari-hari, disarankan memakai izin Hanya baca agar Claude Code membantu membaca log, memeriksa status, dan menulis kode perbaikan; untuk proyek pengembangan atau pengujian, aktifkan izin Deploy agar ia bisa menyelesaikan alur "ubah kode → push → deploy → cek log" sekaligus.

Apa bedanya Zenavo Agent bawaan konsol dengan Claude Code MCP? Zenavo Agent sudah tertanam di konsol web (tersedia pada paket Dev, Pro, dan Team dengan 30, 100, dan 300 kredit per bulan) — cukup buka halaman layanan, tanyakan penyebab error, lalu setujui kartu konfirmasi tanpa perlu menyiapkan lingkungan lokal. Sementara itu, Claude Code + zenavo-mcp berjalan di terminal lokal berdampingan dengan kode sumber Anda, sehingga cocok untuk memeriksa log produksi sambil langsung memperbaiki kode lokal, melakukan push ke GitHub, dan men-deploy ulang. Jika Anda juga ingin mengganti model di Claude Code atau berbagi kuota API tim, Anda bisa memadukannya dengan gateway Magpie atau New API yang di-host sendiri di Zenavo, serta menghubungkan gateway yang sama ke Open WebUI atau LobeHub untuk obrolan di browser.

Coba terlebih dahulu pada satu proyek pengujian: jalankan zenavo-mcp login, pasang plugin zenavo@zenavo, lalu minta Claude Code memeriksa log atau menjalankan satu kali deploy.