Connetti al server

Connettiti al server Health Auto Export per funzionalità avanzate.

Last updated: May 6, 2026

In questa pagina

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

Avviare il server

  1. Nella schermata Server, tocca "Avvia server"
  2. Attendi che il server si avvii (lo stato cambierà in "In esecuzione")
  3. Prendi nota dell'indirizzo IP e della porta visualizzati sullo schermo
  4. Il server ora accetta connessioni

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 diagnostica più approfondita puoi anche esportare i registri eventi dell’app dall’area Avanzate/debug. Consulta la Guida ai registri eventi dell’app.