Cosa ti serve per il server MCP in Claude Code
Una versione aggiornata di Claude Code, l’app telo sul tuo iPhone e una sincronizzazione completata. Claude Code legge ciò che l’iPhone ha già inviato al tuo account telo; il comando qui sotto da solo non carica nulla.
Se hai già aggiunto telo come connettore in Claude sul web e accedi a Claude Code con lo stesso account Claude, telo potrebbe già comparire in /mcp. In quel caso puoi saltare il comando e passare direttamente all’accesso.
Aggiungi il server remoto con claude mcp add
--scope user rende telo disponibile in tutti i progetti su questo computer, ed è adatto a una fonte di dati personale. Senza, il server viene aggiunto solo al progetto corrente. Evita --scope project: scrive il server in un file .mcp.json pensato per essere committato e condiviso.
Il comando salva solo l’indirizzo. Nessun codice di accesso né token finisce in un file di configurazione, e nessun dato di salute viene ancora letto.
claude mcp add --transport http --scope user telo https://telo.health/mcpAccedi da dentro Claude Code
- Avvia Claude Code e scrivi /mcp.
- Scegli telo e seleziona l’opzione per autenticarti. Il browser apre la pagina di accesso di telo.
- Accedi con la stessa e-mail che usi nell’app telo, controlla l’accesso richiesto e approvalo.
- Torna al terminale. In /mcp telo dovrebbe risultare collegato.
Verifica che il collegamento funzioni
- Esegui claude mcp list in un altro terminale per confermare che telo è configurato.
- Chiedi a Claude Code di usare telo per elencare le metriche e i periodi disponibili.
- Controlla che chiami davvero uno strumento di telo e restituisca la copertura reale. Fermati se dice che il server non è disponibile o se risponde senza chiamare uno strumento.
Una prima richiesta sui tuoi dati
Claude Code può scrivere lo script, eseguirlo e mostrarti il grafico, cioè la parte che una finestra di chat non fa. Chiedigli quali date ha letto prima di fidarti di una tendenza.
Usa telo per leggere il mio sonno degli ultimi 90 giorni. Salva un CSV con una riga per notte, fai un grafico del sonno totale con una media mobile di 7 giorni ed elenca le notti senza dati invece di riempirle.Tieni i dati di salute fuori dai repository
Tutto ciò che Claude Code salva finisce nella cartella in cui l’hai aperto. Fai le analisi di salute in una cartella privata, non dentro un repository di lavoro, e controlla git status prima di fare commit.
I dati restituiti da telo vengono trattati anche da Anthropic come parte della conversazione, come qualsiasi altro risultato di uno strumento.
Risoluzione dei problemi
Se /mcp mostra telo come non riuscito o da autenticare, ripeti l’accesso da /mcp. Se il browser non si apre, copia il link che stampa Claude Code. Controlla che l’URL sia esattamente https://telo.health/mcp.
Se il collegamento funziona ma mancano dati, controlla l’account e l’ultima sincronizzazione nell’app telo. Un accesso riuscito non significa che l’iPhone abbia dato i permessi di Apple Health o finito di inviare lo storico.
Domande pratiche
Claude Code usa l’integrazione con la salute di Claude su iPhone?
No. Quell’integrazione è una funzione dell’app Claude per iPhone, e Claude Code gira sul tuo computer. Per leggere Apple Health in Claude Code ti serve una fonte MCP separata, come telo.
Mi serve il comando se uso già telo in Claude sul web?
Forse no. Con lo stesso account Claude, il connettore potrebbe già comparire in /mcp. Se c’è, autenticati da lì; aggiungerlo di nuovo dal terminale crea una seconda voce per lo stesso server.
I file creati da Claude Code escono dal mio computer?
I file restano nella cartella in cui hai aperto Claude Code. Esce ciò che la conversazione invia: i dati restituiti da telo passano da Anthropic. Se la cartella è un repository, un commit può pubblicare l’analisi, quindi lavora in una cartella privata.
Fonti e disponibilità
Piani, paesi e schermate possono cambiare. Controlla le fonti ufficiali prima di configurare.
Come è stata preparata questa guida
Preparata con l’aiuto dell’IA a partire dalla documentazione ufficiale citata e dal funzionamento di telo descritto nel progetto. Schermate e permessi possono variare da un account all’altro. Questa revisione non ha incluso un test completo con accesso in ciascun assistente.