Server-Verbindungsanleitung

Der TCP/MCP-Server ermöglicht es Ihnen, Ihre Gesundheitsdaten direkt von anderen Geräten über Ihr lokales Netzwerk abzufragen. Dies ermöglicht die Integration mit anderen Anwendungen, Skripten oder Diensten, die im selben Netzwerk laufen.

Übersicht

Der TCP/MCP-Server erstellt einen lokalen Netzwerkserver, der Verbindungen von anderen Geräten und Anwendungen akzeptiert. Sie können Gesundheitsdaten abfragen, Automatisierungen ausführen und programmgesteuert mit Health Auto Export interagieren.

Anwendungsfälle:

• Gesundheitsdaten von anderen Geräten in Ihrem Netzwerk abfragen
• Integration mit lokalen Anwendungen und Skripten
• Zugriff auf Gesundheitsdaten über Befehlszeilentools
• Erstellen benutzerdefinierter Integrationen mit dem MCP-Protokoll

Hauptfunktionen:

• TCP-basierter Server für zuverlässige Verbindungen
• MCP (Model Context Protocol) Unterstützung
• Lokaler Netzwerkzugriff
• Echtzeit-Gesundheitsdatenabfragen
• Programmatische Automatisierungssteuerung

Einschränkungen:

• App muss im Vordergrund laufen
• Derzeit unverschlüsselt (nur auf vertrauenswürdigen Netzwerken verwenden)
• Erfordert Berechtigung für lokales Netzwerk
• Verbindungen funktionieren nur, während der Server läuft

Voraussetzungen

• Health Auto Export läuft auf Ihrem iPhone/iPad
• Geräte im selben lokalen Netzwerk
• Berechtigung für lokales Netzwerk erteilt
• Premium-Abonnement
• Vertrauenswürdiges Netzwerk

IP-Adresse/Port-Anzeige:

• Der Server zeigt die IP-Adresse Ihres Geräts an
• Der Standardport ist 9000

Server-Version

• v0.0.1: Legacy-Kompatibilitätsmodus (empfohlen für bestehende Setups).
• v1.0.0: Aktualisiertes Verhalten gemäß dem neuesten MCP-Server-Contract.

Die gewählte Version beeinflusst Tool-Standardwerte und Antwortkompatibilität. Starten Sie den Server nach einem Versionswechsel neu, damit die Änderung wirksam wird.

Mit dem Server verbinden

Ihre IP-Adresse finden

Der Server-Bildschirm zeigt automatisch die IP-Adresse Ihres Geräts an. Dies ist die Adresse, die andere Geräte zum Verbinden verwenden sollten.

Beispiel: 192.168.1.100:9000

Server verwenden

MCP-Protokoll

Der Server verwendet das Model Context Protocol (MCP) für die Kommunikation.

Verbindungsprotokolle

Der Server-Bildschirm zeigt Verbindungsprotokolle an, die Folgendes zeigen:

• Eingehende Verbindungsversuche
• Anforderungsdetails
• Antwortinformationen
• Fehlermeldungen

Protokolle anzeigen:

• Protokolle erscheinen automatisch in der Liste auf dem Server-Bildschirm
• Scrollen Sie, um die letzten Aktivitäten zu sehen
• Protokolle helfen beim Debuggen von Verbindungsproblemen

Für tiefergehende Diagnose exportieren Sie vollständige App-Ereignisprotokolle unter Einstellungen → Erweitert → Ereignisprotokolle exportieren oder über Aktivitätsprotokolle → Teilen bei einer beliebigen Automatisierung (gleiches ZIP). Siehe Leitfaden zu App-Ereignisprotokollen.

Tipps und bewährte Methoden

1. Automatische Synchronisierung:
   • Laden Sie Ihr Gerät und nutzen Sie iPhone-Spiegelung
     • Beim Laden legt iOS weniger Leistungsbeschränkungen auf, sodass Daten häufiger synchronisiert werden können
     • Mit iPhone-Spiegelung verhält sich das Gerät wie entsperrt. So kann Health Auto Export auf Gesundheitsdaten zugreifen und automatisierte Aktionen ausführen