Alle integrationer

Hetzner

Administrér Hetzner Cloud-servere, volumes, firewalls, netværk, load balancers og DNS via MCP. Forbind med et projekt-API-token.

Manual setup 67 værktøjer

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

  1. Log ind på Hetzner Console.
  2. Åbn det projekt, tokenet skal styre. Tokens kan ikke bruges på tværs af projekter.
  3. Gå til Security → API tokens → Generate API token.
  4. Angiv en beskrivelse, f.eks. stackgate.ai.
  5. Vælg Read, hvis AI kun skal inspicere ressourcer, eller Read & Write, hvis den skal oprette, tænde eller slette.
  6. Kopiér tokenet én gang. Hetzner viser det ikke igen.
  7. Åbn Mine integrationer → Hetzner i stackgate.ai, indsæt tokenet, og klik Connect & enable.
  8. 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/hetzner med 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

  1. list_locations / list_server_types / list_images / list_ssh_keys - saml ID'er før opret.
  2. list_servers / get_server - se status og offentlige IP'er.
  3. initiate_server_action - strømstyring (foretræk shutdown, derefter poweroff om nødvendigt).
  4. list_server_actions / get_server_action - poll asynkront arbejde uden tætte loops.
  5. 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_volume og 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.