← garmlink

Collega Garmin a Cursor

Configura garmlink in

Cursor raggiunge garmlink come server MCP remoto: una voce nella sua configurazione MCP, poi un accesso nel browser. Il suo agente risponde poi dal tuo vero storico Garmin sincronizzato — comodo per analizzare il tuo allenamento accanto ai tuoi script e notebook.

Prima di iniziare Ti serve un account garmlink con il tuo Garmin collegato (fallo nella Schermata Connessione), e Cursor installato sul tuo computer.

  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.

  2. Aggiungi garmlink a Cursor

    Il modo più rapido è il link di installazione di Cursor, che apre Cursor con garmlink già compilato: Aggiungi garmlink a Cursor.

    Oppure a mano: apri ~/.cursor/mcp.json (creala se non esiste) e aggiungi garmlink:

    {
  "mcpServers": {
    "garmlink": {
      "url": "https://api.garmlink.ai/mcp"
    }
  }
}

    Quel file vale per ogni progetto; per un solo progetto, le stesse righe vanno in .cursor/mcp.json nella sua radice.

  3. Accedi a garmlink

    Apri le impostazioni di Cursor, sezione MCP: accanto a garmlink, clicca il pulsante che chiede di accedere. Il browser si apre su garmlink — accedi, poi premi Authorize. Tornato in Cursor, garmlink elenca i suoi strumenti.

  4. Fai la tua prima domanda

    Poi chiedi con parole semplici, nella chat o nel pannello agente dello strumento:
    • «Come ho dormito questa settimana?»
    • «Riassumi le mie ultime cinque corse.»
    • «Il mio carico di allenamento sta salendo o scendendo questo mese?»
Risoluzione dei problemi
  • garmlink mostra un errore o nessuno strumento. Controlla che l’indirizzo termini con /mcp e che il file sia un JSON valido — basta una virgola mancante per rendere muto l’intero file — poi disattiva e riattiva garmlink nelle impostazioni MCP.
  • Chiede una chiave API o un token. garmlink non ne richiede: lascia vuoti tutti i campi per chiave, header e client secret. Accedi tramite il browser, con il tuo account garmlink.
  • I dati sembrano vuoti o non aggiornati. Controlla a che punto è la sincronizzazione nella Schermata Connessione.

Usi un altro assistente? Vedi tutte le guide alla configurazione. Curioso di sapere cosa può leggere garmlink? Consulta il riferimento degli strumenti. Vuoi prima vedere risposte reali? Leggi dodici esempi da un account reale.