Inhalt der Doku
hetzner-mcp · Doku
Konfiguration
Alle Umgebungsvariablen von hetzner-mcp mit Standardwerten, Tool-Filtern und API-Token.
Auf dieser Seite
Umgebungsvariablen
hetzner-mcp wird komplett über Umgebungsvariablen konfiguriert. Eine Vorlage findest du in .env.example.
| Name | Standard | Beschreibung |
|---|---|---|
HETZNER_API_TOKEN |
– | API-Token eines Hetzner-Cloud-Projekts. Pflicht, außer du setzt nur HETZNER_STORAGE_API_TOKEN. |
HETZNER_STORAGE_API_TOKEN |
– | Eigener Token für Storage Boxes. Fällt auf HETZNER_API_TOKEN zurück. |
HOST |
0.0.0.0 |
Adresse, auf der der Server lauscht. |
PORT |
3000 |
Port des Servers. |
MCP_PATH |
/mcp |
Pfad des MCP-Endpunkts. |
MCP_SPLITS |
all |
all oder eine kommagetrennte Liste aus servers, networking, load-balancers, ips, storage, storage-boxes, config, dns. |
MCP_READ_ONLY |
true |
Nur Tools mit readOnlyHint: true anbieten. Akzeptiert true/false, 1/0, yes/no, on/off. |
MCP_TOOLS_ALLOW |
– | Kommagetrennte Tool-Namen, die übrig bleiben sollen. * ist Platzhalter. |
MCP_TOOLS_DENY |
– | Kommagetrennte Tool-Namen, die entfernt werden. * ist Platzhalter. |
MCP_AUTH_TOKEN |
– | Wenn gesetzt, verlangt /mcp den Header Authorization: Bearer <token>. |
Ungültige Werte (unbekannte Gruppe, falscher Port, kaputter Boolean) brechen den Start mit einer klaren Fehlermeldung ab.
API-Token holen
- In der Hetzner Console das Projekt öffnen.
- Sicherheit → API-Tokens → API-Token generieren.
- Berechtigung Lesen wählen. Das reicht für den Standardmodus.
- Token kopieren und als
HETZNER_API_TOKENsetzen.
Wichtig
Hetzner zeigt den Token nur einmal an. Speicher ihn direkt in deinem Passwortmanager oder in der .env deines Servers.
Lesen & Schreiben brauchst du nur, wenn du MCP_READ_ONLY=false setzt und Claude wirklich Dinge ändern soll. Lies dazu vorher Sicherheit.
Tool-Filter
Die Filter laufen in dieser Reihenfolge:
MCP_SPLITSlädt nur die gewählten Gruppen.MCP_READ_ONLYwirft alle schreibenden Tools raus.MCP_TOOLS_ALLOWbehält nur passende Tools (wenn gesetzt).MCP_TOOLS_DENYentfernt passende Tools.
Beispiele:
# Nur Server, IPs und Preise
MCP_SPLITS=servers,ips
# Nur list- und get-Tools
MCP_TOOLS_ALLOW=hetzner_list_*,hetzner_get_*
# Schreiben erlaubt, aber nichts löschen
MCP_READ_ONLY=false
MCP_TOOLS_DENY=hetzner_delete_*Welche Tools in welcher Gruppe stecken, siehst du unter Tools.
Beispiel
HETZNER_API_TOKEN=dein-read-token
MCP_SPLITS=all
MCP_READ_ONLY=true
MCP_TOOLS_DENY=hetzner_get_server_metrics