Tailscale MCP Server

Serveur Model Context Protocol (MCP) pour interagir avec l'API Tailscale. Ce serveur permet de gérer vos appareils, ACLs, clés et configurations DNS directement depuis des clients MCP comme Claude Desktop ou Raycast.

Configuration

1. Créez un fichier .env à la racine du projet (copiez l'exemple ci-dessous) :

touch .env

2. Ajoutez vos identifiants Tailscale dans le fichier .env :

TAILSCALE_API_KEY=tskey-auth-xxxxxx-xxxxxx
TAILSCALE_TAILNET=example-tailnet.ts.net

Note: Vous pouvez générer une clé API dans la section Settings > Keys de votre console d'administration Tailscale. Le nom du tailnet se trouve en haut à gauche de la console (ex: mon-email.gmail.com ou une organisation).

Configuration des Clients

Raycast

1. Ouvrez Raycast Settings.
2. Allez dans l'onglet Extensions.
3. Sélectionnez l'extension Model Context Protocol (installez-la si nécessaire).
4. Cliquez sur Add Server ('+').
5. Configurez comme suit :
   • Name: Tailscale
   • Type: HTTP (Streamable)
   • URL: http://localhost:8000/mcp
6. Validez. Le statut doit passer au vert.

Claude Desktop

Vous avez deux options pour connecter Claude Desktop : via HTTP (recommandé pour Docker) ou via stdio (local).

Option 1 : Via HTTP (Streamable) - Recommandé avec Docker

Cette méthode connecte Claude au serveur exposé sur le port 8000. Assurez-vous que le conteneur est lancé (docker compose up -d).

Ajoutez dans votre config ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "tailscale": {
      "url": "http://localhost:8000/mcp"
    }
  }
}