Hostwolf Apps para desarrolladores
Crea sobre Hostwolf Apps
Todo lo que haces en la consola lo puedes hacer desde código: crear apps desde git, un Dockerfile o una imagen, desplegarlas, leer sus registros, definir variables, añadir bases de datos gestionadas y activar el autoescalado.
Consigue un token de API#
- Inicia sesión en la consola y abre Claves y tokens → Tokens de API.
- Escribe una descripción, elige cuánto dura el token y marca sus permisos.
- Haz clic en Crear token y cópialo. Tiene este aspecto:
12|aBcD…, y solo se muestra una vez.
| Permiso | Qué permite |
|---|---|
| Lectura | Lista y lee proyectos, apps, despliegues, servidores, bases de datos y ajustes. Los valores secretos están ocultos. |
| Lectura de datos sensibles | Además lee registros de apps, valores de variables y URLs de conexión de bases de datos. |
| Escritura | Crea, cambia y elimina proyectos, apps, variables, volúmenes y bases de datos. |
| Despliegue | Despliega, inicia, detén y reinicia apps, también mediante webhooks de despliegue. |
| Root | Todo lo anterior. Evítalo en scripts y asistentes. |
- Un token pertenece al equipo en el que estabas cuando lo creaste, y solo ve los recursos de ese equipo.
- Los miembros del equipo (que no son administradores ni propietarios) solo pueden crear tokens de Lectura.
- Para un script que despliega, marca Lectura, Escritura y Despliegue. Añade Lectura de datos sensibles solo si necesita registros o secretos.
- Los tokens no pueden comprar ni cancelar servidores. La facturación se queda en la consola, y los planes aparecen en precios.
- Usa un token por script o asistente, para poder revocar uno sin romper los demás.
Inicio rápido#
Envía el token como Authorization: Bearer <token> a https://console.app.hostwolf.net/api/v1:
curl
# Your apps
curl https://console.app.hostwolf.net/api/v1/applications \
-H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN" \
-H "Accept: application/json"
# Deploy one
curl -X POST https://console.app.hostwolf.net/api/v1/applications//start \
-H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN" TypeScript
npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgzimport { HostwolfApps } from '@hostwolf/apps-sdk';
const hw = new HostwolfApps({ token: process.env.HOSTWOLF_APPS_TOKEN! });
const [app] = await hw.applications.list();
const deployment = await hw.deployAndWait(app.uuid);
console.log(deployment.status, await hw.applications.logs(app.uuid, { lines: 20 }));Asistente de IA (MCP)
claude mcp add --transport http hostwolf-apps https://app.hostwolf.net/mcp --header "Authorization: Bearer your_token"Luego pregunta: "¿Por qué falló el último despliegue de mi tienda? Corrige el comando de inicio y vuelve a desplegarla." Ese es el servidor alojado en https://app.hostwolf.net/mcp, sin nada que instalar. Consulta la configuración de MCP para Claude Desktop, Cursor y VS Code, o para ejecutarlo tú mismo.
El inicio rápido paso a paso despliega una app desde GitHub sin nada más que curl.
Qué puedes crear#
Descargas#
El SDK y el servidor MCP se sirven desde app.hostwolf.net, no desde el registro de npm. No hay que registrarse en nada, y cada versión tiene una URL fija:
| Paquete | Instalar |
|---|---|
| SDK de TypeScript | npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz |
| Servidor MCP | npx -y https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz |
/dl/index.json lista las versiones actuales con sus hashes SHA-256 y de integridad de npm. La descripción OpenAPI 3.1 de la API está en /developers/openapi.json, para generadores de código y clientes de API.