ES
English简体中文繁體中文日本語EspañolBahasa Indonesia
Empezar

Plugin de Claude Code · código abierto

Despliega, arregla y revierte pidiéndoselo a tu agente

Las skills de Zenavo enseñan a Claude Code a desplegar tus proyectos, averiguar por qué falló un despliegue, volver a una versión que funcionaba y gestionar variables de entorno. Funciona con una clave cuyo alcance decides tú, y pregunta antes de cambiar nada.

InstalarVer en GitHub

Esta página también está disponible en English, 简体中文, 繁體中文, 日本語 y Bahasa Indonesia.

Claude CodeEjemplo

¿Por qué falló el último despliegue de api?

zenavo-debug

  • get_project shop
  • list_deployments api
  • get_job
  • list_env api

La imagen se construyó, pero api termina al arrancar: lee DATABASE_URL y el servicio no tiene ninguna variable con ese nombre. Añádela en la pestaña Variable del servicio para que el valor no pase por este chat, y vuelvo a desplegar.

Instálalo en tres pasos

Una vez por ordenador. La clave se queda en tu máquina, nunca en la configuración de Claude Code.

  1. Instala zenavo-mcp

    Las skills hablan con Zenavo a través de zenavo-mcp, un servidor MCP de código abierto. Descarga el binario para tu sistema y verifícalo (el README explica cómo), o compílalo con Go 1.26+:

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

    Descargar de Releases →

  2. Inicia sesión y limita la clave

    zenavo-mcp login

    Se abre la consola y te pide aprobar. Comprueba que el código coincide con el de tu terminal, elige Deploy o Read only y limita la clave a los proyectos con los que trabaja el agente. Para que solo pueda mirar, inicia sesión con --scope read.

  3. Añade el plugin a Claude Code

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

    El plugin trae las cinco skills de abajo y arranca zenavo-mcp por sí mismo.

Cinco skills

Cada una es una guía breve y legible del repositorio zenavo-skills. Claude elige la adecuada según lo que pidas.

  • zenavo-deployTe pregunta antes

    Despliega un proyecto o un servicio, sigue el trabajo y comprueba que arrancó bien.

    Despliega el servicio api de shop

  • zenavo-debug

    Averigua por qué falló un despliegue o se cae un servicio, a partir del estado, la salida del trabajo y los registros, y propone una solución.

    ¿Por qué se reinicia el worker una y otra vez?

  • zenavo-rollbackTe pregunta antes

    Vuelve a un despliegue anterior que funcionaba, de un servicio o de todo el proyecto.

    Vuelve web a la versión anterior

  • zenavo-envTe pregunta antes

    Añade, cambia o quita variables de entorno, manteniendo los valores fuera de la conversación siempre que se pueda.

    Pon LOG_LEVEL a debug en el worker

  • zenavo-setup

    Instala zenavo-mcp e inicia sesión cuando faltan las herramientas o no hay sesión.

    Las herramientas de Zenavo no funcionan

Otros agentes

Cualquier cliente MCP puede usar el mismo servidor, con la misma clave y los mismos límites. Las skills están hechas para Claude Code; en otros clientes el agente usa las herramientas.

Claude Code, solo el servidor

Si solo quieres las herramientas, sin el plugin:

claude mcp add zenavo -- zenavo-mcp

Claude Desktop, Cursor y otros

Añade el servidor a la configuración MCP del cliente (claude_desktop_config.json, .cursor/mcp.json, …):

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

Lo que el agente puede llamar

Las herramientas que zenavo-mcp da al agente. Lo que puede hacer una clave lo impone la API de Zenavo, no el agente: una clave Read only no puede desplegar.

Lectura

  • whoamiLa cuenta, los equipos y los roles con los que actúa la clave, y su permiso
  • list_projectsLos proyectos y sus servicios
  • get_projectServicios, puertos, dominios, estado en vivo, el trabajo activo y lo que bloquea un despliegue
  • get_logsLas líneas más recientes del registro de un servicio, con filtro opcional
  • list_deploymentsLos despliegues recientes de un servicio, marcando el actual
  • get_jobEl estado, el progreso y el registro de un trabajo; puede esperar a que termine

Permiso Deploy

  • list_envLos nombres de las variables de entorno de un servicio, nunca sus valores
  • deployDespliega un proyecto o un servicio
  • rollbackEjecuta de nuevo un despliegue anterior que salió bien
  • restart_serviceReinicia un servicio sin reconstruirlo
  • set_env / unset_envEstablece o quita una variable de entorno; el valor nunca se devuelve

Pensado para darle una clave

Un agente con el permiso Deploy aún puede desplegar código que haga todo lo que pueden hacer tus servicios. Por eso la clave es estrecha y tú decides.

  • Pregunta antes

    Despliegues, reversiones, reinicios y cambios de variables esperan tu sí. Las herramientas que cambian algo están marcadas, así que tu agente te pregunta antes de usarlas.

  • Los valores no se ven

    El agente ve los nombres de las variables, nunca los valores. Los registros le llegan con los valores de las variables ya sustituidos y marcados como datos no fiables.

  • Una clave a tu medida

    Deploy o Read only, limitada a algunos proyectos y con caducidad a los 90 días. Se guarda en tu ordenador, no en la configuración del agente.

  • Todo queda registrado

    Cada cambio aparece en tu registro de auditoría con el nombre de la clave. Borra la clave en Account settings → API Keys para cortarle el acceso al instante.

No hay herramientas para borrar proyectos, abrir una terminal, leer archivos o filas de la base de datos, descargar copias de seguridad, cambiar servidores ni tocar la facturación o los miembros del equipo. Todo eso se queda en la consola.