Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from HCLOUD_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. Get a Hetzner Cloud account: Sign up at https://www.hetzner.com/cloud and create a project in the Cloud Console (https://console.hetzner.cloud).
  2. Generate an API token: In the Cloud Console open your project, go to Security > API tokens, and generate a token with Read & Write permissions (Read-only suffices if you skip the write tools).
  3. Set the environment variable: Copy the token into your .env as HCLOUD_TOKEN - it is shown only once at creation time.
  4. Verify access: Run List Servers and List Server Types to confirm the token works.

​
Provider notes

  • API tokens are scoped to a single Hetzner Cloud project
  • Rate limit applies per token (check RateLimit-* response headers)
  • Power Off is a hard power cut - prefer a graceful OS shutdown for running workloads
  • Creating servers provisions billable infrastructure - confirm server type and location before running write tools
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as hetzner__list_servers with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.