Conectar tu arnés (MCP)

Zonda Cloud ofrece un servidor MCP remoto para que tu arnés de agente (Claude Code, Codex, opencode u otro) vea y opere las apps de tu cuenta, con un token personal que vos controlás.

Qué es y qué necesitás

Zonda Cloud ofrece un servidor MCP para que un arnés de agente (Claude Code, Codex, opencode u otro) opere las apps de tu cuenta. Es remoto, está en https://console.zondacloud.com/mcp (HTTP) y se autentica con un token personal.

Crear un token

En la consola, en la sección Conectar (console.zondacloud.com/tokens), creá un token con un nombre, un alcance (Solo lectura o Leer y operar) y un vencimiento de 30, 90, 180 o 365 días (por defecto, 90).

El valor empieza con cwt_ y se muestra una sola vez: copialo al crearlo. Se puede revocar cuando quieras. Cada cuenta puede tener hasta 20 tokens.

Qué puede hacer cada alcance

Solo lectura: ver apps, despliegues, logs, métricas, variables (solo los nombres), dominios, ramas, bases y backups. Herramientas: whoami, get_account_usage, list_apps, get_app, list_deployments, get_deployment, get_deployment_build_logs, get_app_logs, get_app_metrics, list_env_var_names, list_domains, list_branches, list_databases, get_database, list_database_backups, get_database_logs.

Leer y operar suma: redeploy, rollback, crear, cambiar y quitar variables de entorno, vincular y desvincular ramas, agregar, verificar, mover y quitar dominios, vincular y desvincular bases, hacer un backup manual de una base e iniciar o detener bases. Herramientas: redeploy_app, rollback_deployment, set_env_var, delete_env_var, bind_branch, unbind_branch, add_domain, verify_domain, move_domain, remove_domain, link_database, unlink_database, create_database_backup, start_database, stop_database.

Lo que un token nunca puede hacer

Eliminar apps ni bases.
Crear apps ni bases.
Restaurar ni cargar datos.
Descargar archivos.
Rotar credenciales.
Leer los valores de las variables de entorno (solo sus nombres).
Administrar el clúster, aunque la cuenta sea de administración.

Un token ve solo lo que ve su dueño.

Conectar tu arnés

Elegí el arnés que usás y reemplazá el token por el tuyo.

Claude Code

Un solo comando agrega el servidor:

claude mcp add --transport http zondacloud https://console.zondacloud.com/mcp --header "Authorization: Bearer cwt_TU_TOKEN"

Dentro de Claude Code, /mcp muestra si la conexión quedó bien.

Codex

En ~/.codex/config.toml agregá:

[mcp_servers.zondacloud]
url = "https://console.zondacloud.com/mcp"
bearer_token_env_var = "ZONDACLOUD_TOKEN"

Y definí el token en el entorno donde corre Codex:

export ZONDACLOUD_TOKEN=cwt_...

opencode

En opencode.json agregá:

{
  "mcp": {
    "zondacloud": {
      "type": "remote",
      "url": "https://console.zondacloud.com/mcp",
      "headers": {
        "Authorization": "Bearer {env:ZONDACLOUD_TOKEN}"
      }
    }
  }
}

Con {env:ZONDACLOUD_TOKEN}, opencode toma el token de la variable de entorno ZONDACLOUD_TOKEN, así que no queda escrito en el archivo.

Arneses sin soporte HTTP

Si tu arnés no habla con servidores MCP remotos por HTTP, usá el puente por stdio zondacloud-mcp. Es un binario que se descarga de los releases de cloud-web (zondacloud-mcp-linux-amd64 o zondacloud-mcp-linux-arm64) y lee las variables ZONDACLOUD_TOKEN y, opcionalmente, ZONDACLOUD_URL.

La configuración típica es un comando con su entorno (el formato exacto depende de tu arnés):

{
  "command": "zondacloud-mcp",
  "env": {
    "ZONDACLOUD_TOKEN": "cwt_TU_TOKEN"
  }
}

Qué pedirle

«¿Por qué falló el último despliegue de mi-app?»
«Volvé mi-app a la versión anterior.»
«Agregá la variable API_URL a mi-app.»

El arnés elige la herramienta que corresponde. Con un token de solo lectura, los pedidos que cambian algo no se pueden cumplir.

Seguridad

Usá un token por arnés, así podés revocar uno sin afectar a los demás.
Dale el vencimiento más corto que te sirva.
Si el arnés no necesita operar, usá un token de solo lectura.
No lo guardes en el repositorio: usá una variable de entorno.
Si se filtra o ya no lo usás, revocalo desde la consola, en Conectar.