Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Headscale with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage your private Tailscale network via Headscale. control users, nodes, and pre-auth keys directly from your AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 18 capabilities

The complete Headscale capability set.

These are the exact actions your AI can choose when you ask it to work with Headscale.

Capability set01 / 05

01-04

4 capabilities in this set.

Part of 18 available through Headscale.

  1. 01

    Expire API key

    Expire an API key

  2. 02

    Disable route

    Disable a specific route

  3. 03

    Enable route

    Enable a specific route

  4. 04

    Get node

    Get details for a specific node

Capability set02 / 05

05-08

4 capabilities in this set.

Part of 18 available through Headscale.

  1. 05

    List API keys

    List all API keys

  2. 06

    List nodes

    List all nodes (machines) connected to Headscale

  3. 07

    List preauth keys

    List pre-auth keys

  4. 08

    List routes

    List all subnet routes and exit nodes

Capability set03 / 05

09-12

4 capabilities in this set.

Part of 18 available through Headscale.

  1. 09

    List users

    List all users in Headscale

  2. 10

    Create API key

    Create a new API key

  3. 11

    Create preauth key

    Create a new pre-auth key

  4. 12

    Create user

    Create a new user in Headscale

Capability set04 / 05

13-15

3 capabilities in this set.

Part of 18 available through Headscale.

  1. 13

    Delete node

    Remove a node from the Headscale network

  2. 14

    Delete user

    Delete a user from Headscale

  3. 15

    Expire node

    Force expiration of a node session

Capability set05 / 05

16-18

3 capabilities in this set.

Part of 18 available through Headscale.

  1. 16

    Expire preauth key

    Expire a pre-auth key

  2. 17

    Move node

    Move a node to a different user

  3. 18

    Rename node

    Rename a node in Headscale

Observed, not estimated

938ms average. Fast in production.

Headscale is checked daily against the live service.

Daily averagePeak 1203ms
Aug 20Today
Fastest day
792ms
Slowest day
1203ms
14-day trend
Slowing+19%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 18 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Headscale, so you can see the experience inside your AI.

It does not authenticate your account with Headscale. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Headscale Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_eY8iPLqKoHS6UDNYs4PXhTC6kItxeqx4gseTYyC6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Headscale capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "headscale-tailscale-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_eY8iPLqKoHS6UDNYs4PXhTC6kItxeqx4gseTYyC6/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Headscale owners ask.

  • 01

    Can I move a registered machine from one user to another using the AI?

    Yes. Use the move_node capability by providing the Node ID and the target User name. The agent will reassign the machine to the new namespace immediately.

  • 02

    How do I generate a key for a new server to join the network without manual approval?

    You can use the create_preauth_key capability. Specify the user, and optionally set it as reusable or ephemeral. The agent will return a key that can be used with the tailscale up --login-server command.

  • 03

    Is it possible to see the IP addresses and status of all my machines?

    Absolutely. The list_nodes capability retrieves a complete list of all registered devices, including their online status, assigned IP addresses, and the users they belong to.

Explore

More in Cloud Infrastructure

Suggestions