ID
English简体中文繁體中文日本語EspañolBahasa Indonesia
Mulai

Plugin Claude Code · open source

Deploy, perbaiki, dan rollback cukup dengan meminta agen Anda

Skill Zenavo mengajari Claude Code cara men-deploy proyek Anda, mencari tahu mengapa deploy gagal, kembali ke versi yang berjalan, dan mengelola variabel lingkungan. Ia bekerja dengan key yang cakupannya Anda tentukan, dan bertanya sebelum mengubah apa pun.

PasangLihat di GitHub

Halaman ini juga tersedia dalam English, 简体中文, 繁體中文, 日本語, dan Español.

Claude CodeContoh

Kenapa deploy terakhir api gagal?

zenavo-debug

  • get_project shop
  • list_deployments api
  • get_job
  • list_env api

Image berhasil dibuild, tetapi api berhenti saat start: ia membaca DATABASE_URL, dan layanan ini tidak punya variabel dengan nama itu. Tambahkan di tab Variable layanan agar nilainya tidak masuk ke obrolan ini, lalu saya deploy ulang.

Pasang dalam tiga langkah

Sekali per komputer. Key tetap di mesin Anda, tidak pernah di pengaturan Claude Code.

  1. Pasang zenavo-mcp

    Skill berkomunikasi dengan Zenavo melalui zenavo-mcp, server MCP open source. Unduh binary untuk sistem Anda lalu periksa (README menjelaskan caranya), atau build sendiri dengan Go 1.26+:

    go install github.com/Zenavo-App/zenavo-mcp/cmd/zenavo-mcp@latest

    Unduh dari Releases →

  2. Masuk dan batasi key

    zenavo-mcp login

    Konsol terbuka dan meminta persetujuan Anda. Pastikan kodenya sama dengan yang ada di terminal, pilih Deploy atau Read only, lalu batasi key ke proyek yang dikerjakan agen. Agar agen hanya bisa melihat, masuk dengan --scope read.

  3. Tambahkan plugin ke Claude Code

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

    Plugin membawa lima skill di bawah dan menjalankan zenavo-mcp sendiri.

Lima skill

Masing-masing adalah panduan singkat yang mudah dibaca di repositori zenavo-skills. Claude memilih yang tepat dari permintaan Anda.

  • zenavo-deployBertanya dulu

    Deploy proyek atau satu layanan, ikuti job-nya, dan pastikan layanan berjalan sehat.

    Deploy layanan api di proyek shop

  • zenavo-debug

    Cari tahu mengapa deploy gagal atau layanan crash, dari status, output job, dan log, lalu usulkan perbaikan.

    Kenapa worker terus restart?

  • zenavo-rollbackBertanya dulu

    Kembali ke deployment sebelumnya yang berjalan, untuk satu layanan atau seluruh proyek.

    Kembalikan web ke versi sebelumnya

  • zenavo-envBertanya dulu

    Tambah, ubah, atau hapus variabel lingkungan, sebisa mungkin tanpa nilainya masuk ke percakapan.

    Atur LOG_LEVEL ke debug di worker

  • zenavo-setup

    Pasang zenavo-mcp dan masuk saat tool-nya tidak ada atau belum masuk.

    Tool Zenavo tidak berfungsi

Agen lain

Klien MCP mana pun bisa memakai server yang sama, dengan key dan batasan yang sama. Skill dibuat untuk Claude Code; di klien lain, agen memakai tool-nya.

Claude Code, hanya server

Jika Anda hanya ingin tool-nya, tanpa plugin:

claude mcp add zenavo -- zenavo-mcp

Claude Desktop, Cursor, dan lainnya

Tambahkan server ke konfigurasi MCP klien (claude_desktop_config.json, .cursor/mcp.json, …):

{
  "mcpServers": {
    "zenavo": { "command": "zenavo-mcp" }
  }
}

Yang bisa dipanggil agen

Tool yang diberikan zenavo-mcp kepada agen. Apa yang boleh dilakukan key ditegakkan oleh API Zenavo, bukan oleh agen: key Read only tidak bisa men-deploy.

Baca

  • whoamiAkun, tim, dan peran yang dipakai key, beserta izinnya
  • list_projectsProyek dan layanannya
  • get_projectLayanan, port, domain, status langsung, job yang aktif, dan penghambat deploy
  • get_logsBaris log terbaru sebuah layanan, bisa difilter
  • list_deploymentsDeployment terbaru sebuah layanan, dengan tanda pada yang sedang berjalan
  • get_jobStatus, progres, dan log sebuah job; bisa menunggu sampai selesai

Izin Deploy

  • list_envNama variabel lingkungan sebuah layanan, tidak pernah nilainya
  • deployDeploy proyek atau satu layanan
  • rollbackMenjalankan lagi deployment sebelumnya yang berhasil
  • restart_serviceRestart layanan tanpa build ulang
  • set_env / unset_envMengatur atau menghapus satu variabel lingkungan; nilainya tidak pernah ditampilkan kembali

Dirancang untuk diberi key

Agen dengan izin Deploy tetap bisa men-deploy kode yang dapat melakukan apa pun yang bisa dilakukan layanan Anda. Karena itu key-nya sempit, dan keputusan tetap di tangan Anda.

  • Bertanya dulu

    Deploy, rollback, restart, dan perubahan variabel menunggu persetujuan Anda. Tool yang mengubah sesuatu diberi tanda, jadi agen bertanya sebelum menjalankannya.

  • Nilai tetap tersembunyi

    Agen melihat nama variabel, tidak pernah nilainya. Log sampai ke agen dengan nilai variabel proyek sudah diganti, dan ditandai sebagai data tak tepercaya.

  • Key yang Anda batasi

    Deploy atau Read only, dibatasi ke beberapa proyek, kedaluwarsa setelah 90 hari. Disimpan di komputer Anda, bukan di pengaturan agen.

  • Semua tercatat

    Setiap perubahan muncul di log audit dengan nama key. Hapus key di Account settings → API Keys untuk memutus aksesnya seketika.

Tidak ada tool untuk menghapus proyek, membuka shell, membaca file atau baris database, mengunduh backup, mengubah server, atau menyentuh tagihan dan anggota tim. Semua itu tetap di konsol.