Collega Garmin a Gemini

1. 1

   Collega il tuo account Garmin

   Nella Schermata Connessione, accedi a Garmin Connect con e-mail e password (usate una sola volta, mai salvate), completa il codice di verifica se Garmin lo richiede e attendi che lo stato diventi Connesso. garmlink inizia subito a sincronizzare le tue attività, il sonno, l’HRV e le metriche di allenamento.

Percorso A — App Gemini (web)

Google sta introducendo le app personalizzate gradualmente: per ora compaiono sugli account Google personali negli Stati Uniti, per maggiorenni, con Gemini in inglese e Keep Activity attivata. Non le vedi ancora? Il percorso B funziona ovunque.

2. 22.

   Aggiungi garmlink come app personalizzata

   Su gemini.google.com, apri Impostazioni, poi App collegate e App personalizzate. Incolla l’indirizzo di garmlink e clicca Avanti:https://api.garmlink.ai/mcpCopia

   Gemini apre la pagina di accesso di garmlink: accedi, poi premi Authorize.

3. 33.

   Richiama garmlink in una chat

   In una conversazione, digita @ e scegli garmlink, poi chiedi:

   • «Come ho dormito questa settimana?»
   • «Riassumi le mie ultime cinque corse.»
   • «Il mio carico di allenamento sta salendo o scendendo questo mese?»

Percorso B — Gemini CLI (individuale)

4. 44.

   Installa la Gemini CLI

   Installa la CLI a livello globale, poi eseguila una volta perché crei la propria cartella di configurazione:

   • npm install -g @google/gemini-cli
   • gemini

   Accedi con il tuo account Google quando richiesto.

5. 55.

   Dichiara garmlink nelle impostazioni della CLI

   Apri ~/.gemini/settings.json (creala se non esiste) e dichiara garmlink come server MCP:

   {
     "mcpServers": {
       "garmlink": {
         "httpUrl": "https://api.garmlink.ai/mcp",
         "oauth": { "enabled": true }
       }
     }
   }

   In quel file non va nient’altro — niente header, niente chiave API, niente client secret. Con OAuth attivato, la Gemini CLI gestisce da sola l’intero flusso OAuth 2.0.

6. 66.

   Esegui la CLI e approva l’accesso

   Avvia gemini in un terminale. La prima volta che raggiunge garmlink apre una finestra del browser: accedi, approva l’accesso in sola lettura, e la CLI conserva i token in locale per le volte successive.

   Poi chiedi semplicemente, con parole di tutti i giorni:

   • «Come ho dormito questa settimana?»
   • «Riassumi le mie ultime cinque corse.»
   • «Il mio carico di allenamento sta salendo o scendendo questo mese?»

Percorso C — Gemini Enterprise (organizzazione)

7. 77.

   Aggiungi il server MCP in Gemini Enterprise

   In Gemini Enterprise, apri Connected apps → Add MCP Server. Compila i dettagli del server MCP — un nome, una descrizione e l’URL di garmlink:https://api.garmlink.ai/mcpCopia

   È supportato solo il trasporto StreamableHTTP — i vecchi server MCP SSE vengono rifiutati. garmlink usa StreamableHTTP, quindi è idoneo.

   Icona (facoltativa)

   PNG, 256×256, ≤ 10 KB. L’icona di garmlink ha un proprio sfondo, quindi resta leggibile sia con l’interfaccia chiara sia con quella scura dell’assistente.

   

   

   Scarica l’icona
8. 88.

   Autenticati e imposta l’ambito

   Scegli OAuth come metodo di autenticazione e completa l’accesso a garmlink. Poi scegli l’ambito: pubblica la connessione per l’intera organizzazione, oppure chiedi a ogni membro di autenticarsi con il proprio account garmlink.