HealthyApps Help Center

Mit Server verbinden

Verbinden Sie sich mit dem Health Auto Export MCP-Server für KI-Clients und Skripte in Ihrem lokalen Netzwerk.

Last updated: July 14, 2026

Auf dieser Seite

Anleitung zur Serververbindung

Der MCP-Server auf iOS ermöglicht es KI-Clients und Skripten in Ihrem lokalen Netzwerk, Ihre Gesundheitsdaten abzufragen. HTTP (Streamable MCP) ist der empfohlene Transport. iOS unterstützt außerdem TCP für Node-Bridge-Setups.

Clients laufen auf Ihrem Mac oder anderen Geräten im selben Netzwerk und verbinden sich mit dem Endpunkt, der auf Ihrem iPhone angezeigt wird.

Übersicht

Transport Endpunkt
HTTP (empfohlen) http://{LAN_IP}:9000/mcp (oder https://, wenn HTTPS aktiviert ist)
TCP {LAN_IP}:9000 (nicht authentifiziert)

Ersetzen Sie {LAN_IP} durch die Adresse, die auf dem Bildschirm Server angezeigt wird, während der Server läuft.

Anwendungsfälle:

  • Claude Code, Codex, Cursor oder VS Code auf Ihrem Mac mit Gesundheitsdaten auf Ihrem iPhone verbinden
  • mcp-remote (iOS / LAN) für ausschließlich stdio-fähige Clients wie Claude Desktop verwenden
  • Metriken und Workouts über Skripte in Ihrem lokalen Netzwerk abfragen (HTTP)
  • TCP-Integrationen über die Node-Bridge health-auto-export-mcp-server

Voraussetzungen

  • Health Auto Export auf dem iPhone (die App muss im Vordergrund bleiben, während Clients verbunden sind)
  • Premium-Abonnement
  • HTTP: Bearer-Token vom Server-Bildschirm
  • Berechtigung für das lokale Netzwerk auf dem iPhone
  • Client-Gerät: Gleiches WLAN oder LAN wie das iPhone; Node.js nur, wenn Sie mcp-remote (iOS / LAN) verwenden

Server starten

  1. Öffnen Sie auf dem iPhone den Bereich Server über die Seitenleisten-Navigation
  2. Wählen Sie HTTP (empfohlen) oder TCP
  3. Aktivieren Sie optional HTTPS verwenden (Anleitung unten)
  4. Tippen Sie auf Server starten
  5. Kopieren Sie die Endpunkt-URL und das Bearer-Token

Der Server stoppt automatisch, wenn Health Auto Export in den Hintergrund wechselt (sowohl bei HTTP als auch bei TCP).

Authentifizierung (HTTP)

Alle HTTP-Anfragen erfordern:

Authorization: Bearer <your-token>
  • Erzeugen Sie das Token bei Bedarf über den Server-Bildschirm neu
  • Bei einfachem HTTP wird das Token über eine unverschlüsselte Verbindung gesendet — verwenden Sie es nur in vertrauenswürdigen Netzwerken oder aktivieren Sie HTTPS
  • TCP (Legacy) verfügt über keine Authentifizierung (unverändert)

HTTPS (TLS)

Wenn HTTPS verwenden aktiviert ist, generiert die App eine private lokale Zertifizierungsstelle (CA) und ein von dieser CA signiertes Server-Zertifikat. Clients müssen der exportierten CA vertrauen, bevor sie sich über https:// verbinden können.

HTTPS aktivieren

  1. Öffnen Sie die Ansicht Server über die Seitenleisten-Navigation
  2. Aktivieren Sie HTTPS verwenden
  3. Tippen Sie auf CA-Zertifikat exportieren und verwenden Sie das Freigabemenü, um die CA-Datei per AirDrop zu senden oder auf jedem Client-Gerät zu speichern
  4. Starten Sie den Server — stellen Sie sicher, dass die Endpunkt-URL zu https:// wechselt

Der CA auf Clients vertrauen

Vertrauen Sie der exportierten CA auf dem Gerät, auf dem der KI-Client läuft (in der Regel Ihr Mac):

  1. Exportieren Sie die CA vom Server-Bildschirm auf dem iPhone
  2. Öffnen Sie die PEM-Datei in Keychain Access auf dem Client-Mac
  3. Stellen Sie Trust → Always Trust ein

Mindestversion von Node für --use-system-ca

Node-Bridges (mcp-remote) dürfen NODE_OPTIONS=--use-system-ca nur verwenden, wenn Node folgende Mindestanforderung erfüllt:

Node-Linie Mindestversion
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ beliebig

Setzen Sie bei älteren Node-Versionen stattdessen NODE_EXTRA_CA_CERTS auf einen PEM-Pfad, den der Bridge-Prozess lesen kann. Die Verwendung von --use-system-ca auf einer nicht unterstützten Node-Version verhindert den Start des Prozesses.

Vertrauensbereich: --use-system-ca vertraut der gesamten System-Keychain, nicht nur der CA dieser App. NODE_EXTRA_CA_CERTS beschränkt das Vertrauen auf eine einzelne PEM-Datei (Fallback für ältere Node-Versionen). Das Flag ist für macOS/Windows dokumentiert.

Client-Typ Einrichtung
Cursor, VS Code, Claude Code, Codex Keychain-Vertrauen auf dem Client-Mac — verwenden Sie den https://-Endpunkt vom Server-Bildschirm
mcp-remote (iOS / LAN) Vertrauen Sie der CA in der Keychain auf dem Mac, auf dem mcp-remote läuft. Der Snippet verwendet NODE_OPTIONS=--use-system-ca, wenn Node die Mindestversion erfüllt; bei älteren Node-Versionen setzen Sie NODE_EXTRA_CA_CERTS auf einen lesbaren PEM-Pfad
curl / Skripte Übergeben Sie --cacert /path/to/mcp-ca.pem oder setzen Sie NODE_EXTRA_CA_CERTS

Der CA-Fingerabdruck wird auf dem Server-Bildschirm angezeigt, damit Sie überprüfen können, dass Sie das richtige Zertifikat exportiert haben.

Änderungen der LAN-IP auf iOS

Wenn sich die LAN-IP Ihres iPhones ändert, generiert die App das Leaf-Zertifikat mit aktualisierten Subject Alternative Names neu und startet den HTTPS-Listener neu. Kopieren Sie die Endpunkt-URL erneut, wenn sich die IP geändert hat. Das CA-Zertifikat bleibt gleich, es sei denn, Sie generieren es neu, indem Sie HTTPS aus- und wieder einschalten.

Beispiel für einen HTTPS-Endpunkt

https://192.168.1.42:9000/mcp

Ersetzen Sie den Host durch den auf dem Server-Bildschirm angezeigten Wert.

Vertragsversion

Version TCP-Tool-Namen Hinweise
v1.1.0 (Standard) get_* Empfohlen für neue Setups
v1.0.0 Legacy (health_metrics, …) Kompatibilitäts-Update v1.0.0 für Claude Desktop
v0.0.1 Legacy Älteste Kompatibilität

HTTP verwendet immer get_*-Tool-Namen; die Vertragsversion wirkt sich nur auf die Standard-Schemas aus.

Client-Konfiguration

Der Server-Bildschirm enthält Copy-Paste-Snippets für jede Integration. Verwenden Sie den dort angezeigten Endpunkt und das Token. Überprüfen Sie die Formate anhand Ihrer Client-Version.

Alle folgenden Beispiele verwenden eine Platzhalter-LAN-Adresse — ersetzen Sie diese durch die Adresse Ihres iPhones vom Server-Bildschirm.

Claude Code (CLI)

Auf Ihrem Mac ausführen (erfordert die Claude Code CLI):

HTTP:

claude mcp add --transport http health-auto-export \
  http://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

HTTPS (nachdem Sie die CA auf Ihrem Mac exportiert und ihr vertraut haben):

claude mcp add --transport http health-auto-export \
  https://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

Claude Code / Projektdatei (.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 verbindet sich direkt über Streamable HTTP — es ist keine Node.js-Bridge erforderlich. Die Konfiguration befindet sich in ~/.codex/config.toml (global) oder .codex/config.toml in einem vertrauenswürdigen Projektverzeichnis.

CLI (empfohlen):

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

Manuelle config.toml:

[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true

Exportieren Sie HAE_MCP_TOKEN mit Ihrem Bearer-Token, bevor Sie Codex starten. Führen Sie nach der Einrichtung /mcp in einer Codex-Sitzung aus, um zu überprüfen, dass der Server verbunden ist.

Wenn Sie das Bearer-Token in Health Auto Export neu generieren, aktualisieren Sie HAE_MCP_TOKEN und führen Sie codex mcp add erneut aus, oder entfernen und fügen Sie den Server-Eintrag erneut hinzu.

mcp-remote (iOS / LAN)

Für ausschließlich stdio-fähige Clients (wie Claude Desktop), die sich nicht direkt über HTTP verbinden können. Erfordert Node.js auf dem Mac, auf dem der Client läuft.

  1. Starten Sie den Server auf dem iPhone und kopieren Sie den Endpunkt und das Token
  2. Wählen Sie auf Ihrem Mac mcp-remote (iOS / LAN) auf dem Server-Bildschirm und kopieren Sie das JSON-Snippet, oder fügen Sie Folgendes in die MCP-Konfiguration des Clients ein (Claude Desktop → Settings → Developer → Edit Config):
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

Wenn HTTPS aktiviert ist:

  1. Exportieren Sie die CA vom iPhone und vertrauen Sie ihr in Keychain Access (Always Trust) auf Ihrem Mac
  2. Verwenden Sie https://192.168.1.42:9000/mcp in args
  3. Wenn Node die Mindestversion für --use-system-ca erfüllt (22.19.0 bei 22.x, 23.8.0 bei 23.x, 24.6.0 bei 24.x oder jede 25+-Version), fügen Sie Folgendes hinzu:
"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

Setzen Sie bei älteren Node-Versionen stattdessen NODE_EXTRA_CA_CERTS auf einen lesbaren PEM-Pfad. Starten Sie den stdio-Client nach der Aktualisierung der Konfiguration neu.

Startverzögerung reduzieren: npx -y lädt mcp-remote bei der ersten Verwendung herunter und prüft es erneut, wenn der Cache abläuft, was mehrsekündige Verzögerungen verursachen kann. Eine globale Vorabinstallation beseitigt dies:

npm install -g mcp-remote@0.1.16

Tool-Argumente

Datumsformate

Die Parameter start und end akzeptieren zwei Formate:

Format Beispiel Hinweise
yyyy-MM-dd 2026-06-13 Startdatum: Mitternacht; Enddatum: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Explizite Uhrzeit und Zeitzonen-Offset

TCP

  • Unverschlüsseltes, nicht authentifiziertes JSON-RPC auf Port 9000
  • Verwenden Sie Vertrag v1.0.0 mit der Node-Bridge health-auto-export-mcp-server für Legacy-Tool-Namen
  • Verwenden Sie Vertrag v1.1.0 für get_*-TCP-Tool-Namen (aktualisieren Sie die Node-Bridge separat)

Tipps

  1. Halten Sie Health Auto Export im Vordergrund auf dem iPhone, während Clients verbunden sind
  2. Erzeugen Sie das Token neu, wenn Sie vermuten, dass es offengelegt wurde
  3. Kopieren Sie die Endpunkt-URL erneut, nachdem sich die LAN-IP Ihres iPhones geändert hat

Chat-Support

Sammeln Sie Diagnosedaten aus den App-Ereignisprotokollen unter Einstellungen → Erweitert → Ereignisprotokolle exportieren. Siehe Leitfaden zu App-Ereignisprotokollen. Teilen Sie die generierte ZIP-Datei über den Chat-Support oder per E-Mail.