Hetzner
Administrér Hetzner Cloud-servere, volumes, firewalls, netværk, load balancers og DNS via MCP. Forbind med et projekt-API-token.
Eksempelspørgsmål
Prøv at spørge din AI-klient
-
Which Hetzner Cloud servers are running or off right now?
-
Did the web-1 server finish rebuilding after last night?
-
Summarize volumes and floating IPs that look unused.
-
Write a draft DNS A record for staging.example.com - do not create it.
-
Which firewalls are attached to production servers?
Overblik
Forbind Hetzner Cloud, så AI-klienter kan inspicere og styre servere, volumes, firewalls, netværk, load balancers og DNS-zoner via Hetzner Cloud API.
stackgate.ai gemmer dit projekt-API-token krypteret og kalder https://api.hetzner.cloud/v1 på dine vegne. Værktøjsresultater returneres til din AI-klient for den pågældende forespørgsel. Denne integration dækker kun Hetzner Cloud, ikke Robot dedicated servers eller Storage Boxes.
Forudsætninger
- En Hetzner Console-konto med mindst ét Cloud-projekt
- En stackgate.ai-konto
Hent credentials
- Log ind på Hetzner Console.
- Åbn det projekt, tokenet skal styre. Tokens kan ikke bruges på tværs af projekter.
- Gå til Security → API tokens → Generate API token.
- Angiv en beskrivelse, f.eks.
stackgate.ai. - Vælg Read, hvis AI kun skal inspicere ressourcer, eller Read & Write, hvis den skal oprette, tænde eller slette.
- Kopiér tokenet én gang. Hetzner viser det ikke igen.
- Åbn Mine integrationer → Hetzner i stackgate.ai, indsæt tokenet, og klik Connect & enable.
- Begræns valgfrit værktøjer med Edit tool access (Read vs Write) efter forbindelsen.
Behandl tokenet som en adgangskode. Tilbagekald eller roter det i Console, hvis det bliver eksponeret.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/hetznermed et Sanctum bearer-token - Private gateway: én config til alle integrationer - brug
hetzner__*-navngivne værktøjer
Se Dokumentation for HTTP-godkendelse og private gateway-opsætning.
Anbefalet workflow
list_locations/list_server_types/list_images/list_ssh_keys- saml ID'er før opret.list_servers/get_server- se status og offentlige IP'er.initiate_server_action- strømstyring (foretrækshutdown, derefterpoweroffom nødvendigt).list_server_actions/get_server_action- poll asynkront arbejde uden tætte loops.- Volume-, firewall-, netværks-, floating IP-, load balancer- og
list_zones/ RRSet-værktøjer til resten af control planet.
Fejlfinding
- 422 integration not configured - indsæt et Cloud API-token under Mine integrationer.
- 401 Unauthorized - generér et nyt token i Console → Security → API tokens og opdater Mine integrationer.
- 403 Forbidden - tokenet er Read-only, eller det tilhører et andet projekt end ressourcen.
- 429 Too many requests - Hetzner begrænser Cloud API-kald til omkring 3600 pr. time pr. projekt. Vent på reset-vinduet, og undgå at polle actions hvert par hundrede millisekunder.
- Forkert projekt - opret tokenet i det projekt, AI skal styre.
- Destruktive handlinger -
delete_server,delete_volumeog DNS-sletninger kan give nedetid; bekræft intent før Write-adgang.
Tilgængelige værktøjer
-
list_servers
List Cloud-servere i det forbundne projekt.
-
get_server
Get details for a Cloud server.
-
list_server_actions
List async actions for a server. Prefer this over polling every few hundred milliseconds.
-
get_server_action
Get a single server action by ID.
-
get_server_metrics
Get CPU, disk, or network metrics for a server. start and end are ISO-8601 timestamps.
-
list_locations
List Cloud locations (for example nbg1, fsn1, hel1).
-
get_location
Get a location by ID or name.
-
list_datacenters
List datacenters.
-
get_datacenter
Get a datacenter by ID or name.
-
list_server_types
List server types (CPU, memory, disk, architecture).
-
get_server_type
Get a server type by ID or name.
-
list_images
List images (system, snapshot, backup, or app).
-
get_image
Get an image by ID or name.
-
list_ssh_keys
List SSH keys in the project.
-
get_ssh_key
Get an SSH key by ID or name.
-
get_pricing
Get current Cloud pricing for the project.
-
create_server
Opret en Cloud-server. Kræver name, server_type, image og location eller datacenter.
-
update_server
Update a server name or labels.
-
delete_server
Delete a Cloud server. This is destructive.
-
initiate_server_action
Start en server-action. Foretræk shutdown før poweroff.
-
create_ssh_key
Create an SSH key in the project.
-
update_ssh_key
Update an SSH key name or labels.
-
delete_ssh_key
Delete an SSH key.
-
list_volumes
List volumes in the project.
-
get_volume
Get a volume by ID.
-
create_volume
Create a volume. Provide location or server (not both).
-
delete_volume
Delete a volume. Detach it first if it is attached.
-
initiate_volume_action
Start a volume action: attach, detach, resize, or change_protection.
-
list_firewalls
List firewalls.
-
get_firewall
Get a firewall by ID.
-
create_firewall
Create a firewall with inbound/outbound rules.
-
update_firewall
Update a firewall name or labels.
-
delete_firewall
Delete a firewall.
-
apply_firewall
Apply a firewall to servers or label selectors.
-
remove_firewall
Remove a firewall from servers or label selectors.
-
list_networks
List private networks.
-
get_network
Get a network by ID.
-
create_network
Create a private network.
-
update_network
Update a network name, labels, or vSwitch route exposure.
-
delete_network
Delete a private network.
-
list_floating_ips
List floating IPs.
-
get_floating_ip
Get a floating IP by ID.
-
create_floating_ip
Create a floating IP. Provide home_location or server.
-
delete_floating_ip
Delete a floating IP.
-
initiate_floating_ip_action
Start a floating IP action: assign, unassign, change_dns_ptr, or change_protection.
-
list_primary_ips
List primary IPs.
-
get_primary_ip
Get a primary IP by ID.
-
create_primary_ip
Create a primary IP. Provide datacenter or assignee_id.
-
delete_primary_ip
Delete a primary IP.
-
list_load_balancers
List load balancers.
-
get_load_balancer
Get a load balancer by ID.
-
create_load_balancer
Create a load balancer. Provide location or network_zone.
-
delete_load_balancer
Delete a load balancer.
-
list_load_balancer_types
List load balancer types.
-
list_placement_groups
List placement groups.
-
get_placement_group
Get a placement group by ID.
-
create_placement_group
Create a placement group.
-
delete_placement_group
Delete a placement group.
-
list_zones
List Cloud DNS-zoner.
-
get_zone
Get a DNS zone by ID or name.
-
create_zone
Create a Cloud DNS zone.
-
delete_zone
Delete a DNS zone.
-
list_zone_rrsets
List DNS record sets in a zone.
-
get_zone_rrset
Get a DNS record set by zone, name, and type.
-
create_zone_rrset
Create a DNS record set in a zone.
-
update_zone_rrset
Replace records or TTL on a DNS record set.
-
delete_zone_rrset
Delete a DNS record set.
MCP-endpoint:
https://stackgate.ai/mcp/hetzner
(HTTP) eller via
private gateway.