🤖 documentación

CLI y servidor MCP

CLI

El CLI cubre toda la plataforma: apps, dominios, correo, WhatsApp y analytics. Solo necesitas Node 18+.

# Instalarlo (queda como comando `cloudwapp` y su alias `cw`)
npm i -g https://tudominio.com/downloads/cloudwapp-cli.tgz

# ¿Prefieres no instalar nada? Cada comando funciona con npx:
npx -y https://tudominio.com/downloads/cloudwapp-cli.tgz apps up . --name mi-app

Sustituí tudominio.com por la URL de tu instancia (en el panel, en Conectar, el comando ya viene con tu dominio y tu API key).

# Configurar credenciales (URL de tu instancia + API key del dashboard)
cloudwapp login --url https://tudominio.com --api-key TU_API_KEY
cloudwapp whoami

# Deploys
cloudwapp apps up ./mi-app --name mi-app -f     # subir y deployar sin repo
cloudwapp apps create --name api --repo https://github.com/u/api --deploy
cloudwapp apps logs mi-app -f                   # logs en vivo

# Dominios, correo, WhatsApp
cloudwapp domains check midominio.com
cloudwapp mail create soporte@midominio.com
cloudwapp wa send --to 5215512345678 --message "Hola"

Cada comando tiene --help con todas sus opciones.

Servidor MCP (para agentes de IA)

CloudWapp expone 60 tools MCP para que un agente (Claude Code, Cursor, etc.) opere tu nube: deployar, leer logs de build, setear variables, manejar dominios, enviar WhatsApp y más.

Claude web (un click, sin API key)

CloudWapp expone además un endpoint MCP remoto en https://tudominio.com/mcp. Claude web no puede ejecutar el paquete local, así que se conecta ahí directamente: en el panel, Conectar → Claude web → Agregar a Claude web, o a mano desde Settings → Connectors → Add custom connector con esa URL.

La autorización va por OAuth 2.1: Claude te trae a una pantalla de CloudWapp, apruebas, y recibe un token propio acotado a tu cuenta — no se pega ninguna API key. El acceso se corta desde Configuración → API keys → Apps conectadas.

deploy_from_files no existe en el conector remoto: empaqueta un directorio de la máquina donde corre el servidor MCP, que en remoto sería el servidor de CloudWapp. Para eso usa el CLI o el MCP local.

Clientes locales (stdio)

Configuración en tu cliente MCP:

{
  "mcpServers": {
    "cloudwapp": {
      "command": "npx",
      "args": ["-y", "https://tudominio.com/downloads/cloudwapp-mcp-0.2.0.tgz"],
      "env": {
        "CLOUDWAPP_URL": "https://tudominio.com",
        "CLOUDWAPP_API_KEY": "TU_API_KEY"
      }
    }
  }
}

Usa la URL con el número de versión, como en el ejemplo. npx cachea los paquetes por URL y no por contenido: si apuntas al nombre sin versión, tu agente se queda con el paquete que descargó la primera vez y no verá las tools nuevas. En el panel, en Conectar, el comando ya viene con la versión vigente. El manifiesto está en /downloads/manifest.json.

Para confirmar qué versión está corriendo tu agente, pídele que llame a la tool whoami: devuelve la cuenta, el plan y mcpVersion. Si quedó una vieja pegada, npx clear-npx-cache limpia la caché.

Tools destacadas

Tool	Qué hace
`deploy_from_files`	El agente escribe archivos y los deploya sin repo git
`create_app` / `deploy_app`	Crear apps desde repo y lanzar builds
`get_build_logs` / `get_app_logs`	Diagnosticar builds y runtime
`set_app_env`	Variables de entorno (con redeploy opcional)
`wa_send_message` / `wa_get_qr`	WhatsApp desde el agente
`domain_register` / `mail_create`	Comprar dominios y crear buzones
`app_create_ai`	Crear una app desde cero con Claude Code del server
`ticket_create` / `ticket_approve`	Tickets de mejora que resuelve una IA en sandbox
`app_service_add`	Adjuntar Postgres, MySQL, MongoDB, Redis o un bucket S3
`app_backup_create` / `app_backup_restore`	Backups de las bases adjuntas
`app_templates` / `app_create_from_template`	Instalar WordPress y compañía desde la galería
`app_share_invite`	Invitar a alguien a ver una app
`whoami`	Verificar cuenta y versión del conector
`admin_docker_report` / `admin_docker_cleanup`	Liberar disco del servidor (solo admin)

Con esto, “deployá esta app y avisame si el build falla” es una sola instrucción a tu agente.