Entwickler

Schnellstart#

1. Öffne Konto → API-Schlüssel im Panel und erstelle einen Schlüssel. Er beginnt mit ptlc_ und wird nur einmal angezeigt.
2. Wähle, wie du ihn verwenden willst:

# List your servers
curl https://panel.hostwolf.net/api/client \
  -H "Authorization: Bearer ptlc_your_key" \
  -H "Accept: application/json"

# Restart one (the 8-character id from its panel URL)
curl -X POST https://panel.hostwolf.net/api/client/servers/1a2b3c4d/power \
  -H "Authorization: Bearer ptlc_your_key" \
  -H "Content-Type: application/json" \
  -d '{"signal": "restart"}'

npm install https://hostwolf.net/dl/hostwolf-sdk-0.1.8.tgz

import { Hostwolf } from '@hostwolf/sdk';

const hw = new Hostwolf({ apiKey: process.env.HOSTWOLF_API_KEY! });
const { data: servers } = await hw.servers.list();
await hw.servers.restart(servers[0].identifier);
console.log(await hw.tail(servers[0].identifier, { lines: 20 }));

claude mcp add --transport http hostwolf https://hostwolf.net/mcp --header "Authorization: Bearer ptlc_your_key"

Was du bauen kannst#

API-Schlüssel#

• Sende den Schlüssel bei jeder Anfrage als Authorization: Bearer ptlc_.... Ein falscher, unvollständiger oder widerrufener Schlüssel bekommt 401.
• Ein Schlüssel kann alles, was dein Konto auf deinen Servern kann. Er kann auch auf Servern handeln, auf denen du Subuser bist, im Rahmen der dort erhaltenen Berechtigungen.
• Widerrufe Schlüssel jederzeit auf der API-Schlüssel-Seite.
• Schlüssel können keine Server bestellen, kündigen oder bezahlen. Die Abrechnung bleibt im Panel, und die Tarife stehen unter Preise.
• Nutze für jede App und jeden Assistenten einen eigenen Schlüssel, damit du einen widerrufen kannst, ohne die anderen zu stören.

IP-Freigabeliste#

Beim Erstellen eines Schlüssels kannst du ihn auf bis zu 50 IP-Adressen oder CIDR-Bereiche beschränken, etwa 203.0.113.7 oder 2001:db8::/48. Anfragen von jeder anderen Adresse bekommen 403 mit der Adresse, die das Panel gesehen hat: This IP address (203.0.113.7) does not have permission to access the API using these credentials.

• Hat dein Rechner IPv6, sieht das Panel meist die IPv6-Adresse. Erlaube also auch diese (oder einen Bereich darum).
• Der gehostete MCP-Server ruft die API von 162.55.180.229 auf. Füge diese Adresse jedem Schlüssel hinzu, den du damit nutzt.
• Um die Liste zu ändern, erstelle einen neuen Schlüssel und widerrufe den alten.

Downloads#

Das SDK und der MCP-Server werden von hostwolf.net ausgeliefert, nicht aus der npm-Registry. Keine Anmeldung nötig, und jede Version hat eine feste URL:

Aktuelle Versionen und Prüfsummen stehen in index.json; was sich geändert hat, steht im Änderungsprotokoll.

Limits und Umgangsformen#

Ratenlimit: 256 Anfragen pro Minute und Konto. Manche Aktionen haben ein eigenes, niedrigeres Limit, das für jede Aktion getrennt gezählt wird:

Über einem Limit bekommst du 429 mit einem Retry-After-Header in Sekunden. Das SDK wiederholt kurze Wartezeiten für dich und meldet längere als error.retryAfter.

• Statistiken: Für Live-Statistiken nutze den Konsolen-Websocket, statt /resources in einer engen Schleife abzufragen.
• Lange Aufgaben: Backups, Wiederherstellungen, Neuinstallationen und Modpack-Installationen laufen im Hintergrund. Starte sie und schau später nach. Das SDK kann für dich warten: servers.waitForState(), backups.waitUntilDone() und waitForConsole().

Ressourcen#