Guida alla connessione al server

Il server TCP/MCP ti consente di interrogare i tuoi dati sanitari direttamente da altri dispositivi tramite la tua rete locale. Ciò consente l'integrazione con altre applicazioni, script o servizi in esecuzione sulla stessa rete.

Panoramica

Il server TCP/MCP crea un server di rete locale che accetta connessioni da altri dispositivi e applicazioni. Puoi interrogare i dati sanitari, eseguire automazioni e interagire con Health Auto Export a livello di programmazione.

Casi d'uso:

• Interrogare i dati sanitari da altri dispositivi sulla tua rete
• Integrare con applicazioni e script locali
• Accedere ai dati sanitari da strumenti da riga di comando
• Creare integrazioni personalizzate utilizzando il protocollo MCP

Caratteristiche principali:

• Server basato su TCP per connessioni affidabili
• Supporto MCP (Model Context Protocol)
• Accesso alla rete locale
• Interrogazioni dei dati sanitari in tempo reale
• Controllo dell'automazione a livello di programmazione

Limitazioni:

• L'app deve essere in esecuzione in primo piano
• Attualmente non crittografato (usare solo su reti attendibili)
• Richiede il permesso Rete locale
• Le connessioni funzionano solo mentre il server è in esecuzione

Prerequisiti

• Health Auto Export in esecuzione sul tuo iPhone/iPad
• Dispositivi sulla stessa rete locale
• Permesso Rete locale concesso
• Abbonamento Premium
• Rete attendibile

Visualizzazione Indirizzo IP/Porta:

• Il server visualizza l'indirizzo IP del tuo dispositivo
• La porta predefinita è 9000

Versione del server

• v0.0.1: modalità di compatibilità legacy (consigliata per le configurazioni esistenti).
• v1.0.0: comportamento aggiornato allineato all’ultimo contratto del server MCP.

La versione selezionata influisce sui valori predefiniti degli strumenti e sulla compatibilità delle risposte. Se cambi versione, riavvia il server affinché la modifica abbia effetto.

Connettersi al server

Trovare il tuo indirizzo IP

La schermata del server visualizza automaticamente l'indirizzo IP del tuo dispositivo. Questo è l'indirizzo che gli altri dispositivi dovrebbero usare per connettersi.

Esempio: 192.168.1.100:9000

Utilizzare il server

Protocollo MCP

Il server utilizza il Model Context Protocol (MCP) per la comunicazione.

Log di connessione

La schermata Server visualizza i log di connessione che mostrano:

• Tentativi di connessione in entrata
• Dettagli delle richieste
• Informazioni di risposta
• Messaggi di errore

Visualizzare i log:

• I log appaiono automaticamente nell'elenco sulla schermata Server
• Scorri per vedere l'attività recente
• I log aiutano a risolvere i problemi di connessione

Per una diagnostica più approfondita, esporta i log eventi completi dell’app da Impostazioni → Avanzate → Esporta log eventi o da Registri attività → Condividi in qualsiasi automazione (stesso ZIP). Vedi la Guida ai log eventi dell’app.

Suggerimenti e best practice

1. Sincronizzazione automatica:
   • Ricarica il dispositivo e usa Duplicazione iPhone
     • Durante la ricarica, iOS impone meno restrizioni sulle prestazioni, così i dati possono sincronizzarsi più spesso
     • Con Duplicazione iPhone, il dispositivo si comporta come se fosse sbloccato. Health Auto Export può così accedere ai dati sanitari per eseguire azioni automatizzate