Despliega un proyecto por primera vez
Crear una aplicación sube una carpeta de tu ordenador, así que necesita el servidor local (Claude Code, Codex, Claude Desktop, Cursor y otros clientes que ejecutannpx @vertracloud/mcp). Inicia el agente en la carpeta del proyecto.
Despliega esta carpeta en Vertra Cloud como una app Node llamada support-bot, con 512 MB, y espera hasta que esté online.
La creación es asíncrona: la app empieza en
building y pasa a up o down. Si acaba en down,
last_build_error dice por qué y el agente puede corregir el código y volver a intentarlo. Para las actualizaciones posteriores:
Despliega la carpeta actual en support-bot con el mensaje “fix login timeout”.
Eso ejecuta deploy_app (apps:files), que conserva el historial de releases para que puedas hacer rollback.
Averigua por qué se cayó una aplicación
¿Por qué se cayó orders-api? Lee las últimas 300 líneas de log y el uso de memoria, y dime la causa antes de
cambiar nada.
Todo esto es de solo lectura, así que basta una clave solo con
apps:read. Las líneas de log llegan al agente marcadas como contenido
no fiable: una línea impresa por tu app se lee como dato, nunca como instrucción. Pedir la causa antes de cualquier
cambio evita que el agente reinicie o vuelva a desplegar por su cuenta. La
guía para depurar caídas explica las causas habituales.
Si el agente se está ejecutando en la carpeta del proyecto, la siguiente petición cierra el ciclo:
Corrige la causa en el código, ejecuta los tests y despliega en orders-api.
Crea una base de datos y conéctala a una aplicación
Crea un PostgreSQL de 1 GB llamadoorders-db, defineDB_HOST,DB_PORTyDB_USERenorders-apiy muéstrame cómo debe conectarse el código.
La cadena de conexión viene con un marcador
<password>: la API nunca devuelve la contraseña de la base de datos, así que no
entra en la conversación. Cópiala desde la página de la base de datos en el panel y añádela tú como variable (por
ejemplo DB_PASSWORD). La app también necesita el certificado de cliente de la base de datos: consulta
Conectar una base de datos.
Vuelve a la versión anterior
orders-api empezó a fallar tras el último despliegue. Muéstrame el historial de releases y qué cambiaría un rollback,
y luego haz rollback a la última versión que funcionaba.
rollback_app está marcada como destructiva, así que el cliente te pide confirmación antes de ejecutarla. Consulta
Rollback y despliegues sin downtime.
Haz un snapshot antes de un cambio arriesgado
Haz un snapshot de orders-db antes de ejecutar la migración. Si la migración falla, restáuralo.
create_snapshot y restore_snapshot usan snapshots:write; list_snapshots usa snapshots:read. Restaurar
reemplaza los datos actuales, así que el cliente te pide confirmación. Consulta Backups y snapshots.
Lee el tráfico de tu sitio
Compara el tráfico de esta semana en shop-web con el de la semana pasada. ¿Qué rutas tienen más errores 5xx?
get_app_analytics y get_app_analytics_errors usan apps:read. Las rutas y los referers vienen de tus visitantes y también
llegan al agente como contenido no fiable. Consulta Web Analytics.
Consulta cómo funciona la plataforma
Según la documentación de Vertra Cloud, ¿cuánto almacenamiento tiene un PostgreSQL de 2 GB?
get_docs lee esta documentación y no necesita alcance. Así es como el agente comprueba un límite o un código de error en lugar de
adivinar.
Mantén seguro al agente
- Empieza con alcances de lectura.
apps:read,databases:readysnapshots:readcubren la investigación. Añade alcances de escritura cuando los necesites, preferiblemente en una clave aparte. - Deja activadas las confirmaciones destructivas. Eliminar, detener, reiniciar, sobrescribir un archivo, cambiar una variable y hacer rollback están marcados como destructivos, y el cliente pregunta antes de cada uno. No los permitas de forma permanente.
- Los valores de las variables nunca llegan al agente.
list_envsdevuelve solo nombres, yset_envno devuelve el valor. - Revoca lo que ya no uses. Cada clave, incluida la creada por una conexión OAuth, aparece en Configuraciones → Claves de API. Una cuenta tiene hasta 10 claves.