Come collegare Tailscale a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Tailscale, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Tailscale + Gemini

Amministrazione di una tailnet Tailscale tramite l'API v2: dispositivi con route, tag, approvazione e attributi di posture, utenti e ruoli, auth key, il policy file (lettura, validazione, anteprima), DNS e MagicDNS, impostazioni della tailnet, audit log di configurazione e network flow log, log streaming, webhook, Services e integrazioni di posture. Accede con un client OAuth, senza login dal browser.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TAILSCALE_OAUTH_CLIENT_ID, TAILSCALE_OAUTH_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti e un utente della tailnet con ruolo Owner, Admin, Network admin o IT admin. Il connettore accede con un client OAuth di Tailscale (OAuth2 client credentials): non c'è login dal browser e non c'è un account utente dietro.

1. Apri https://login.tailscale.com/admin/settings/trust-credentials (Settings, Trust credentials; console più vecchie: Settings, OAuth clients) e fai clic su Credential, poi OAuth.
2. Scegli gli scope. Per la sola lettura basta all:read. Per gli strumenti di scrittura aggiungi gli scope corrispondenti: devices:core (richiede uno o più tag, per esempio tag:server), devices:routes, users, auth_keys (richiede anch'esso dei tag), policy_file, dns, feature_settings, webhooks. all concede tutto.
3. Copia il Client ID (per esempio kAbCdEf1CNTRL) in TAILSCALE_OAUTH_CLIENT_ID e il Client secret (tskey-client-..., mostrato una sola volta) in TAILSCALE_OAUTH_CLIENT_SECRET. Un API access token (tskey-api-...) qui non funziona.
4. Installa il connettore ed esegui tailscale_list_devices: elenca i dispositivi della tailnet e conferma il client.

Il connettore scambia il client con un access token di un'ora su https://api.tailscale.com/api/v2/oauth/token e lo rinnova da solo. A differenza degli API access token, che durano al massimo 90 giorni, un client OAuth non scade. Ogni chiamata va alla tailnet a cui appartiene il client (- nel percorso). Una scrittura per cui il client non ha lo scope risponde 403.

Secret nelle risposte: l'AI vede tutto ciò che uno strumento restituisce. tailscale_create_auth_key restituisce una nuova auth key (tskey-auth-...) e tailscale_create_webhook un signing secret del webhook, ciascuno mostrato solo questa volta; entrambi finiscono nella conversazione e presso il fornitore dell'AI. L'AI li consegna solo a chi li ha chiesti, mai ad altri strumenti, file o messaggi. tailscale_list_user_invites mostra link di invito con cui chiunque li abbia può entrare. tailscale_list_keys e tailscale_get_key non restituiscono mai i valori delle chiavi, e in tailscale_list_webhooks, tailscale_get_webhook e tailscale_get_log_streaming_configuration signing secret, token e credenziali cloud sono rimossi.

Dispositivi: tailscale_list_devices con filter (per esempio hostname=web-1, tags=tag:prod, authorized=false) e fields=all per route e connettività; tailscale_get_device, tailscale_get_device_routes e tailscale_get_device_posture_attributes. Modifiche: tailscale_authorize_device (approvare un dispositivo o revocare l'approvazione), tailscale_set_device_routes (approvare subnet route ed exit node), tailscale_set_device_tags, tailscale_set_device_name (il nuovo nome diventa subito il nome MagicDNS) e tailscale_set_device_key_expiry (scadenza della chiave disattivata, per server più che per portatili).

Utenti: tailscale_list_users per ruolo o tipo, tailscale_get_user, tailscale_list_user_invites; tailscale_update_user_role, tailscale_approve_user, e tailscale_suspend_user e tailscale_restore_user (una sospensione si annulla con il ripristino).

Chiavi: tailscale_list_keys (all=true aggiunge auth key e API access token), tailscale_get_key e tailscale_create_auth_key per aggiungere server, container o runner CI: riutilizzabile o monouso, effimera, preautorizzata, valida al massimo 90 giorni. Con il client OAuth di questo connettore la chiave deve avere dei tag, quelli del client o tag di loro proprietà.

Regole di accesso: tailscale_get_policy_file legge il policy file (grants e acls, groups, hosts, tagOwners, autoApprovers, ssh, nodeAttrs, postures, tests) con il suo etag. tailscale_preview_policy_rules mostra quali regole valgono per un utente o un IP:porta, e tailscale_validate_policy_file controlla una bozza ed esegue i suoi test; nessuno dei due modifica nulla.

DNS e impostazioni: tailscale_get_dns_configuration mostra nameserver, split DNS, domini di ricerca e MagicDNS in una chiamata. Le modifiche passano per tailscale_set_dns_nameservers, tailscale_set_dns_preferences (MagicDNS attivo o no; per attivarlo serve un nameserver globale), tailscale_set_dns_search_paths e tailscale_update_split_dns (cambiano solo i domini indicati). tailscale_get_tailnet_settings e tailscale_update_tailnet_settings coprono approvazione di dispositivi e utenti, scadenza delle chiavi, aggiornamenti automatici, network flow logging, certificati HTTPS e altro; tailscale_get_contacts mostra i contatti di account, supporto e sicurezza.

Log e integrazioni: tailscale_list_configuration_audit_logs (chi ha cambiato cosa, conservato 90 giorni, filtrabile per autore, oggetto o evento), tailscale_list_network_flow_logs (traffico tra dispositivi, nei piani Premium ed Enterprise con flow logging attivo; l'AI chiede minuti, non giorni, perché le risposte crescono in fretta), tailscale_get_log_streaming_status e tailscale_get_log_streaming_configuration per lo streaming verso un SIEM, webhook (tailscale_list_webhooks, tailscale_get_webhook, tailscale_create_webhook), Tailscale Services (tailscale_list_services, tailscale_get_service, tailscale_list_service_hosts) e integrazioni di posture (tailscale_list_posture_integrations).

Le modifiche sostituiscono gli elenchi: route, tag, nameserver e domini di ricerca si inviano come elenco completo. L'AI legge prima il valore attuale e invia le voci esistenti più quella nuova; una route lasciata fuori viene disattivata.

Disattivati all'installazione: tailscale_expire_device_key, tailscale_delete_device, tailscale_delete_user e tailscale_delete_key, perché non si possono annullare, e tailscale_set_policy_file, perché sostituisce in una sola chiamata l'intera policy di accesso della tailnet e una regola sbagliata taglia fuori utenti e dispositivi. Un amministratore del workspace li attiva consapevolmente quando il team ne ha bisogno.

Formati dei dati: il nodeId di un dispositivo (per esempio nAbCdEf1CNTRL) è l'id preferito; funziona anche l'id numerico. name è il nome MagicDNS (web-1.tailnet-name.ts.net), addresses sono gli IP Tailscale (100.x.y.z e fd7a:115c:a1e0::/48). Gli orari sono RFC 3339 in UTC; lastSeen è vuoto finché un dispositivo è connesso (connectedToControl: true). Un expires di 0001-01-01 significa che la scadenza della chiave è disattivata. I tag hanno la forma tag:name.

Paginazione: gli elenchi arrivano in una sola risposta, senza paginazione. Gli strumenti dei log accettano invece un orario start ed end.

Errori comuni: 401 significa che il client OAuth è stato eliminato o il secret è errato. 403 significa che al client mancano lo scope o i tag per questa chiamata, oppure che il piano non include la funzione. 404 significa che l'id non esiste in questa tailnet. 400 arriva con un message per input non validi, compresi i policy file con test che falliscono. 412 significa che la policy è cambiata dopo il tuo etag. 429 significa rate limit: attendi un minuto e riprova.

Il connettore non crea client OAuth o API access token, non annuncia route e non registra dispositivi (questo avviene sul dispositivo), e con gli strumenti attivi all'installazione non elimina dispositivi, utenti o chiavi e non sostituisce il policy file.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Tailscale.

Tool disponibili

Esempi di prompt

• "Quali dispositivi non si vedono da più di 30 giorni? Mostra nome, utente e ultima connessione."
• "Quali subnet route annuncia router-1, e quali non sono ancora approvate?"
• "Crea una auth key riutilizzabile e preautorizzata con il tag tag:ci che scada tra 7 giorni."
• "Chi ha modificato il policy file o le impostazioni DNS nell'ultima settimana?"
• "Quali regole del nostro policy file valgono per [email protected]?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot