Claude Code 外掛 · 開源

對智慧體說一句，部署、修復、回滾

Zenavo 技能教會 Claude Code 部署你的專案、查明部署失敗的原因、回到能用的版本，以及管理環境變數。它使用一把由你限定範圍的金鑰，修改任何東西之前都會先問你。

安裝在 GitHub 上查看

本頁亦提供 English、简体中文、日本語、Español 和 Bahasa Indonesia。

Claude Code範例

api 上次部署為什麼失敗了？

zenavo-debug

get_project shop
list_deployments api
get_job
list_env api

映像建置成功了，但 api 一啟動就結束：它要讀取 DATABASE_URL，而這個服務沒有這個變數。請在服務的變數分頁裡新增，這樣值不會出現在對話裡，然後我再部署一次。

三步安裝

每台電腦只需設定一次。金鑰儲存在你的電腦上，不會寫進 Claude Code 的設定。

1
安裝 zenavo-mcp
技能透過開源的 MCP 伺服器 zenavo-mcp 與 Zenavo 溝通。下載適合你系統的執行檔並驗證（README 裡有方法），或者用 Go 1.26+ 自行建置：
```
go install github.com/Zenavo-App/zenavo-mcp/cmd/zenavo-mcp@latest
```
從 Releases 下載 →
2
登入並限定金鑰範圍
```
zenavo-mcp login
```
主控台會開啟並請你核准。確認代碼與終端機裡顯示的一致，選擇部署或唯讀，再把金鑰限定在智慧體要處理的專案上。如果只想讓它查看，用 --scope read 登入。
3
把外掛加到 Claude Code
```
claude plugin marketplace add Zenavo-App/zenavo-skillsclaude plugin install zenavo@zenavo
```
外掛帶有下面的五個技能，並會自動啟動 zenavo-mcp。

五個技能

每個技能都是 zenavo-skills 儲存庫裡一份簡短、易讀的操作手冊。Claude 會根據你的問題選用合適的那個。

zenavo-deploy會先問你

部署整個專案或其中一個服務，追蹤任務，並確認它正常運作。

部署 shop 專案的 api 服務
zenavo-debug

根據狀態、任務輸出和日誌，查明部署失敗或服務當掉的原因，並提出修復方案。

worker 為什麼一直在重新啟動？
zenavo-rollback會先問你

把一個服務或整個專案回滾到之前能正常運作的部署。

把 web 回滾到上一個版本
zenavo-env會先問你

新增、修改或刪除環境變數，盡量不讓變數值進入對話。

把 worker 的 LOG_LEVEL 設為 debug
zenavo-setup

工具缺少或尚未登入時，幫你安裝並登入 zenavo-mcp。

Zenavo 的工具不能用

其他智慧體

任何 MCP 用戶端都可以使用同一個伺服器，金鑰和限制也都一樣。技能是為 Claude Code 寫的；在其他用戶端裡，智慧體可以使用這些工具。

Claude Code，只新增伺服器

如果只想要工具、不裝外掛：

claude mcp add zenavo -- zenavo-mcp

Claude Desktop、Cursor 等

把伺服器加到用戶端的 MCP 設定裡（claude_desktop_config.json、.cursor/mcp.json 等）：

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

智慧體能呼叫什麼

這些是 zenavo-mcp 提供給智慧體的工具。金鑰能做什麼由 Zenavo API 決定，而不是智慧體：唯讀金鑰無法部署。

查看

whoami金鑰所代表的帳號、團隊、角色及其權限
list_projects專案及其服務
get_project服務、連接埠、網域、執行狀態、進行中的任務和部署阻礙
get_logs服務最新的日誌，可以依內容篩選
list_deployments服務最近的部署，並標出目前執行的那個
get_job任務的狀態、進度和日誌；可以等待它完成

需要部署權限

list_env服務的環境變數名稱，永遠不含值
deploy部署整個專案或其中一個服務
rollback重新執行之前一次成功的部署
restart_service不重新建置，直接重新啟動服務
set_env / unset_env設定或刪除一個環境變數；值永遠不會回顯

為交出金鑰而設計

擁有部署權限的智慧體，仍然可以部署和你的服務一樣能做任何事的程式碼。所以金鑰要收窄，每一步你都在場。

先問你
部署、回滾、重新啟動和修改變數都要等你同意。會修改東西的工具都有標記，智慧體執行前會先徵求你的同意。
看不到變數值
智慧體只能看到變數名稱，看不到值。日誌交給它之前，專案的變數值已經被替換，並被標記為不可信資料。
範圍由你決定
部署或唯讀，限定在部分專案上，90 天後過期。金鑰儲存在你的電腦上，不在智慧體的設定裡。
全部留下紀錄
每一項變更都會以金鑰的名字記錄在稽核日誌裡。在 帳號設定 → API 金鑰 中刪除金鑰，即可立刻切斷存取。

沒有任何工具能刪除專案、開啟終端機、讀取檔案或資料庫資料、下載備份、修改伺服器，或變更帳單和團隊成員。這些操作都留在主控台裡。