Connettersi al server
Connettiti al server MCP di Health Auto Export per client di IA e script sulla tua rete locale.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
HTTPS (TLS)
HTTPS (TLS) Attivare HTTPSConsiderare attendibile la CA sui clientCambi di IP LAN di iOSEsempio di endpoint HTTPSConfigurazione del client
Configurazione del client Claude Code (CLI)Claude Code / file di progetto (<code>.mcp.json</code>)Cursor (<code>~/.cursor/mcp.json</code>)VS Code (<code>.vscode/mcp.json</code>)Codex CLI (<code>~/.codex/config.toml</code>)mcp-remote (iOS / LAN)Il server MCP su iOS consente a client di IA e script sulla tua rete locale di interrogare i tuoi dati di salute. HTTP (MCP streamable) è il trasporto consigliato. iOS supporta anche TCP per configurazioni con bridge Node.
I client vengono eseguiti sul tuo Mac o su altri dispositivi della stessa rete e si connettono all’endpoint mostrato sul tuo iPhone.
Panoramica
| Trasporto | Endpoint |
|---|---|
| HTTP (consigliato) | http://{LAN_IP}:9000/mcp (oppure https:// quando HTTPS è attivato) |
| TCP | {LAN_IP}:9000 (senza autenticazione) |
Sostituisci {LAN_IP} con l’indirizzo mostrato nella schermata Server mentre il server è in esecuzione.
Casi d’uso:
- Connettere Claude Code, Codex, Cursor o VS Code sul tuo Mac ai dati di salute del tuo iPhone
- Usare mcp-remote (iOS / LAN) per client solo stdio come Claude Desktop
- Interrogare metriche e allenamenti da script sulla tua rete locale (HTTP)
- Integrazioni TCP tramite il bridge Node health-auto-export-mcp-server
Prerequisiti
- Health Auto Export su iPhone (l’app deve restare in primo piano mentre ci sono client collegati)
- Abbonamento Premium
- HTTP: token Bearer dalla schermata Server
- Permesso di rete locale sull’iPhone
- Dispositivo client: stessa Wi‑Fi o LAN dell’iPhone; Node.js solo se usi mcp-remote (iOS / LAN)
Avviare il server
- Su iPhone, apri Server dalla scheda Esporta. Su iPad, usa la barra laterale.
- Scegli HTTP (consigliato) oppure TCP
- Facoltativamente attiva Usa HTTPS (istruzioni sotto)
- Tocca Avvia server
- Copia l’URL dell’endpoint e il token Bearer
Il server attivo si interrompe automaticamente se Health Auto Export passa in background, sia con HTTP sia con TCP.
Autenticazione (HTTP)
Tutte le richieste HTTP richiedono:
Authorization: Bearer <your-token>
- Rigenera il token dalla schermata Server se lo ritieni necessario
- Su HTTP in chiaro, il token viene inviato su una connessione non crittografata—usalo solo su reti fidate, oppure attiva HTTPS
- Il TCP legacy non ha autenticazione (invariato)
HTTPS (TLS)
HTTPS usa un’autorità di certificazione (CA) generata localmente. Esporta e considera attendibile il suo certificato su ciascun dispositivo client prima di connetterti tramite https://.
Attivare HTTPS
- Apri la vista Server (iPhone: scheda Esporta; iPad: barra laterale)
- Attiva Usa HTTPS
- Tocca Esporta certificato CA e usa il foglio di condivisione per AirDrop o salvare il file CA su ciascun dispositivo client
- Avvia il server — verifica che l’URL dell’endpoint passi a
https://
Considerare attendibile la CA sui client
Considera attendibile la CA esportata sul dispositivo che esegue il client di IA (di solito il tuo Mac):
- Esporta la CA dalla schermata Server sull’iPhone
- Apri il PEM in Accesso Portachiavi sul Mac client
- Imposta Fiducia → Considera sempre attendibile
Versioni di Node per la configurazione generata
La configurazione generata del bridge Node dell’app usa NODE_OPTIONS=--use-system-ca per queste versioni di Node:
| Linea di Node | Versione minima |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | qualsiasi |
Su Node più vecchio, imposta NODE_EXTRA_CA_CERTS su un percorso PEM che il processo del bridge possa leggere. Emmettere --use-system-ca su Node non supportato impedisce l’avvio del processo.
Ambito della fiducia:
--use-system-caconsidera attendibile l’intero Portachiavi di sistema, non solo la CA di questa app.NODE_EXTRA_CA_CERTSaggiunge la CA esportata ai certificati attendibili di Node. Consulta opzioni dei certificati di Node.
| Tipo di client | Configurazione |
|---|---|
| Cursor, VS Code, Claude Code, Codex | Fiducia Portachiavi sul Mac client — usa l’endpoint https:// dalla schermata Server |
| mcp-remote (iOS / LAN) | Considera attendibile la CA in Portachiavi sul Mac che esegue mcp-remote. Lo snippet usa NODE_OPTIONS=--use-system-ca quando Node soddisfa la versione minima; su Node più vecchio imposta NODE_EXTRA_CA_CERTS su un percorso PEM leggibile |
| curl / script | Passa --cacert /path/to/mcp-ca.pem oppure imposta NODE_EXTRA_CA_CERTS |
L’impronta della CA è mostrata nella schermata Server così puoi verificare di aver esportato il certificato corretto.
Cambi di IP LAN di iOS
Ricopia l’URL dell’endpoint se cambia l’indirizzo di rete del tuo iPhone. Se viene fornito un certificato CA di sostituzione, esportalo e aggiorna la fiducia su ciascun dispositivo client.
Esempio di endpoint HTTPS
https://192.168.1.42:9000/mcp
Sostituisci l’host con il valore mostrato nella schermata Server.
Versione del contratto
| Versione | Nomi degli strumenti TCP | Note |
|---|---|---|
| v1.1.0 (predefinita) | get_* |
Consigliata per nuove configurazioni |
| v1.0.0 | Legacy (health_metrics, …) |
Aggiornamento di compatibilità Claude Desktop v1.0.0 |
| v0.0.1 | Legacy | Compatibilità più vecchia |
HTTP usa sempre nomi di strumenti get_*; la versione del contratto influisce solo sui valori predefiniti dello schema.
Configurazione del client
La schermata Server include snippet da copiare e incollare per ciascuna integrazione. Usa l’endpoint e il token mostrati lì. Verifica i formati rispetto alla versione del tuo client.
Tutti gli esempi seguenti usano un indirizzo LAN segnaposto—sostituiscilo con l’indirizzo del tuo iPhone dalla schermata Server.
Claude Code (CLI)
Esegui sul tuo Mac (richiede la CLI di Claude Code):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS (dopo aver esportato e considerato attendibile la CA sul tuo Mac):
claude mcp add --transport http health-auto-export \
https://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
Claude Code / file di progetto (.mcp.json)
{
"mcpServers": {
"health-auto-export": {
"type": "http",
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"health-auto-export": {
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"health-auto-export": {
"type": "http",
"url": "http://192.168.1.42:9000/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Codex CLI (~/.codex/config.toml)
Codex si connette tramite HTTP streamable direttamente — non serve un bridge Node.js. La configurazione è in ~/.codex/config.toml (globale) oppure .codex/config.toml in una directory di progetto fidata.
CLI (consigliato):
export HAE_MCP_TOKEN="<token>"
codex mcp add health-auto-export \
--url http://192.168.1.42:9000/mcp \
--bearer-token-env-var HAE_MCP_TOKEN
Configurazione manuale (config.toml):
[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true
Esporta HAE_MCP_TOKEN con il tuo token Bearer prima di avviare Codex. Dopo la configurazione, esegui /mcp all’interno di una sessione Codex per verificare che il server sia collegato.
Se rigeneri il token Bearer in Health Auto Export, aggiorna HAE_MCP_TOKEN e riesegui codex mcp add, oppure rimuovi e riaggiungi la voce del server.
mcp-remote (iOS / LAN)
Per client solo stdio (come Claude Desktop) che non possono connettersi tramite HTTP direttamente. Richiede Node.js sul Mac che esegue il client.
- Avvia il server sull’iPhone e copia l’endpoint e il token
- Sul tuo Mac, seleziona mcp-remote (iOS / LAN) nella schermata Server e copia lo snippet JSON, oppure incollalo nella configurazione MCP del client (Claude Desktop → Impostazioni → Sviluppatore → Modifica configurazione):
{
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.16",
"http://192.168.1.42:9000/mcp",
"--transport",
"http-only",
"--header",
"Authorization: Bearer <token>"
]
}
Quando HTTPS è attivato:
- Esporta la CA dall’iPhone e considerala attendibile in Accesso Portachiavi (Considera sempre attendibile) sul tuo Mac
- Usa
https://192.168.1.42:9000/mcpinargs - Per le versioni di Node supportate dalla configurazione generata sopra, aggiungi questo oggetto
envallo stesso oggetto di configurazione del server:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
Su Node più vecchio, imposta NODE_EXTRA_CA_CERTS su un percorso PEM leggibile. Riavvia il client stdio dopo aver aggiornato la configurazione.
Argomenti degli strumenti
Formati di data
I parametri start e end accettano due formati:
| Formato | Esempio | Note |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
Data di inizio: mezzanotte; data di fine: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
Ora e offset del fuso orario espliciti |
TCP
- JSON-RPC non crittografato e senza autenticazione sulla porta 9000
- Usa il contratto v1.0.0 con il bridge Node
health-auto-export-mcp-serverper i nomi degli strumenti legacy - Usa il contratto v1.1.0 per i nomi degli strumenti TCP
get_* (aggiorna il bridge Node separatamente)
Consigli
- Mantieni Health Auto Export in primo piano sull’iPhone mentre ci sono client collegati
- Rigenera il token se sospetti che sia stato esposto
- Ricopia l’URL dell’endpoint dopo che cambia l’IP LAN del tuo iPhone
Ottenere aiuto
Consulta Ottenere aiuto per le segnalazioni di supporto e Registri eventi dell’app per le esportazioni diagnostiche.