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 密钥 中删除密钥，即可立刻切断访问。

没有任何工具能删除项目、打开终端、读取文件或数据库数据、下载备份、修改服务器，或改动账单和团队成员。这些操作都留在控制台里。