Hostwolf Apps für Entwickler
Mit Hostwolf Apps entwickeln
Alles, was du in der Konsole machst, geht auch per Code: Apps aus git, einem Dockerfile oder einem Image erstellen, sie deployen, ihre Logs lesen, Variablen setzen, verwaltete Datenbanken hinzufügen und Autoscaling einschalten.
API-Token holen#
- Melde dich in der Konsole an und öffne Schlüssel & Tokens → API-Tokens.
- Gib eine Beschreibung ein, wähle, wie lange das Token gilt, und hake seine Berechtigungen an.
- Klicke auf Token erstellen und kopiere es. Es sieht aus wie
12|aBcD…und wird nur einmal angezeigt.

| Berechtigung | Was es erlaubt |
|---|---|
| Lesen | Projekte, Apps, Deployments, Server, Datenbanken und Einstellungen auflisten und lesen. Geheime Werte bleiben verborgen. |
| Sensible Daten lesen | Außerdem App-Logs, Variablenwerte und Verbindungs-URLs von Datenbanken lesen. |
| Schreiben | Projekte, Apps, Variablen, Volumes und Datenbanken anlegen, ändern und löschen. |
| Deploy | Apps deployen, starten, stoppen und neu starten, auch über Deploy-Webhooks. |
| Root | Alles oben Genannte. Vermeide es für Skripte und Assistenten. |
- Ein Token gehört zu dem Team, in dem du warst, als du es erstellt hast, und sieht nur die Ressourcen dieses Teams.
- Team-Mitglieder (keine Admins oder Owner) können nur Tokens mit Lesen erstellen.
- Für ein Skript, das deployt, hake Lesen, Schreiben und Deploy an. Füge Sensible Daten lesen nur hinzu, wenn es Logs oder Secrets braucht.
- Tokens können keine Server kaufen oder kündigen. Die Abrechnung bleibt in der Konsole, und die Tarife stehen unter Preise.
- Nutze ein Token pro Skript oder Assistent, damit du eins widerrufen kannst, ohne die anderen kaputtzumachen.
Schnellstart#
Sende das Token als Authorization: Bearer <token> an 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.tgz
import { 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 }));KI-Assistent (MCP)
claude mcp add --transport http hostwolf-apps https://app.hostwolf.net/mcp --header "Authorization: Bearer your_token"
Dann frag: „Warum ist das letzte Deployment meines Shops fehlgeschlagen? Korrigier den Startbefehl und deploye ihn neu.“ Das ist der gehostete Server unter https://app.hostwolf.net/mcp, ohne etwas zu installieren. Unter MCP-Einrichtung findest du Claude Desktop, Cursor und VS Code, oder wie du ihn selbst betreibst.
Der Schnellstart Schritt für Schritt deployt eine App von GitHub mit nichts als curl.
Was du bauen kannst#
Downloads#
Das SDK und der MCP-Server kommen von app.hostwolf.net, nicht aus der npm-Registry. Du musst dich nirgends anmelden, und jede Version hat eine feste URL:
| Paket | Installation |
|---|---|
| TypeScript-SDK | npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz |
| MCP-Server | npx -y https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz |
/dl/index.json listet die aktuellen Versionen mit SHA-256- und npm-Integritäts-Hashes. Die OpenAPI-3.1-Beschreibung der API liegt unter /developers/openapi.json, für Codegeneratoren und API-Clients.