Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Mit dem Server verbinden

Verbinde dich mit dem Health-Auto-Export-MCP-Server für KI-Clients und Skripte in deinem lokalen Netzwerk.

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
ÜbersichtVoraussetzungenDen Server startenAuthentifizierung (HTTP)
HTTPS (TLS) HTTPS (TLS) HTTPS aktivierenDer CA auf Clients vertraueniOS-LAN-IP-ÄnderungenBeispiel-HTTPS-Endpoint
Vertragsversion
Client-Konfiguration Client-Konfiguration Claude Code (CLI)Claude Code / Projektdatei (<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)
Tool-Argumente Tool-Argumente Datumsformate
TCPTippsHilfe erhalten

Der MCP-Server auf iOS lässt KI-Clients und Skripte in deinem lokalen Netzwerk deine Gesundheitsdaten abfragen. HTTP (Streamable MCP) ist der empfohlene Transport. iOS unterstützt auch TCP für Node-Bridge-Setups.

Clients laufen auf deinem Mac oder anderen Geräten im selben Netzwerk und verbinden sich mit dem auf deinem iPhone angezeigten Endpoint.

Übersicht

Transport Endpoint
HTTP (empfohlen) http://{LAN_IP}:9000/mcp (oder https://, wenn HTTPS aktiviert ist)
TCP {LAN_IP}:9000 (ohne Authentifizierung)

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

Anwendungsfälle:

  • Claude Code, Codex, Cursor oder VS Code auf deinem Mac mit Gesundheitsdaten auf deinem iPhone verbinden
  • mcp-remote (iOS / LAN) für reine stdio-Clients wie Claude Desktop verwenden
  • Metriken und Workouts von Skripten in deinem 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, solange Clients verbunden sind)
  • Premium-Abonnement
  • HTTP: Bearer-Token vom Server-Bildschirm
  • Lokales Netzwerk-Berechtigung auf dem iPhone
  • Client-Gerät: dasselbe Wi‑Fi oder LAN wie das iPhone; Node.js nur bei mcp-remote (iOS / LAN)

Den Server starten

  1. Öffne auf dem iPhone Server im Tab Exportieren. Auf dem iPad die Seitenleiste verwenden.
  2. Wähle HTTP (empfohlen) oder TCP
  3. Aktiviere optional HTTPS verwenden (Anweisungen unten)
  4. Tippe auf Server starten
  5. Kopiere die Endpoint-URL und den Bearer-Token

Der aktive Server stoppt automatisch, wenn Health Auto Export in den Hintergrund geht, ob HTTP oder TCP.

Authentifizierung (HTTP)

Alle HTTP-Anfragen erfordern:

Authorization: Bearer <your-token>
  • Regeneriere den Token vom Server-Bildschirm, wenn nötig
  • Bei klarem HTTP wird der Token über eine unverschlüsselte Verbindung gesendet—nur in vertrauenswürdigen Netzwerken verwenden oder HTTPS aktivieren
  • Legacy-TCP hat keine Authentifizierung (unverändert)

HTTPS (TLS)

HTTPS verwendet eine lokal generierte Zertifizierungsstelle (CA). Exportiere und vertraue ihrem Zertifikat auf jedem Client-Gerät, bevor du dich über https:// verbindest.

HTTPS aktivieren

  1. Öffne die Server-Ansicht (iPhone: Tab Exportieren; iPad: Seitenleiste)
  2. Schalte HTTPS verwenden ein
  3. Tippe auf CA-Zertifikat exportieren und verwende das Freigabeblatt für AirDrop oder speichere die CA-Datei auf jedem Client-Gerät
  4. Starte den Server — stelle sicher, dass die Endpoint-URL zu https:// wechselt

Der CA auf Clients vertrauen

Vertraue der exportierten CA auf dem Gerät, das den KI-Client ausführt (meist dein Mac):

  1. Exportiere die CA vom Server-Bildschirm auf dem iPhone
  2. Öffne die PEM in Schlüsselbundverwaltung auf dem Client-Mac
  3. Setze Vertrauen → Immer vertrauen

Node-Versionen für das generierte Setup

Das generierte Node-Bridge-Setup der App verwendet NODE_OPTIONS=--use-system-ca für diese Node-Versionen:

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

Auf älterem Node setze NODE_EXTRA_CA_CERTS auf einen PEM-Pfad, den der Bridge-Prozess lesen kann. --use-system-ca auf nicht unterstütztem Node verhindert den Start des Prozesses.

Vertrauensumfang: --use-system-ca vertraut dem gesamten System-Schlüsselbund, nicht nur der CA dieser App. NODE_EXTRA_CA_CERTS fügt die exportierte CA zu Nodes vertrauenswürdigen Zertifikaten hinzu. Siehe Node-Zertifikatsoptionen.

Client-Typ Setup
Cursor, VS Code, Claude Code, Codex Schlüsselbund-Vertrauen auf dem Client-Mac — verwende den https://-Endpoint vom Server-Bildschirm
mcp-remote (iOS / LAN) CA im Schlüsselbund auf dem Mac vertrauen, der mcp-remote ausführt. Snippet verwendet NODE_OPTIONS=--use-system-ca, wenn Node die Mindestversion erfüllt; auf älterem Node NODE_EXTRA_CA_CERTS auf einen lesbaren PEM-Pfad setzen
curl / Skripte --cacert /path/to/mcp-ca.pem übergeben oder NODE_EXTRA_CA_CERTS setzen

Der CA-Fingerprint wird auf dem Server-Bildschirm angezeigt, damit du prüfen kannst, dass du das richtige Zertifikat exportiert hast.

iOS-LAN-IP-Änderungen

Kopiere die Endpoint-URL erneut, wenn sich die Netzwerkadresse deines iPhones ändert. Wenn ein Ersatz-CA-Zertifikat bereitgestellt wird, exportiere es und aktualisiere das Vertrauen auf jedem Client-Gerät.

Beispiel-HTTPS-Endpoint

https://192.168.1.42:9000/mcp

Ersetze den Host durch den auf dem Server-Bildschirm angezeigten Wert.

Vertragsversion

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

HTTP verwendet immer get_*-Toolnamen; die Vertragsversion betrifft nur Schema-Standards.

Client-Konfiguration

Der Server-Bildschirm enthält Copy-Paste-Snippets für jede Integration. Verwende den dort angezeigten Endpoint und Token. Prüfe Formate gegen deine Client-Version.

Alle Beispiele unten verwenden eine Platzhalter-LAN-Adresse—ersetze sie durch die Adresse deines iPhones vom Server-Bildschirm.

Claude Code (CLI)

Auf deinem 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 (nach Export und Vertrauen der CA auf deinem Mac):

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 — keine Node.js-Bridge erforderlich. Die Konfiguration liegt 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 Konfiguration (config.toml):

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

Exportiere HAE_MCP_TOKEN mit deinem Bearer-Token, bevor du Codex startest. Nach dem Setup führe /mcp in einer Codex-Sitzung aus, um zu prüfen, dass der Server verbunden ist.

Wenn du den Bearer-Token in Health Auto Export regenerierst, aktualisiere HAE_MCP_TOKEN und führe codex mcp add erneut aus, oder entferne und füge den Servereintrag erneut hinzu.

mcp-remote (iOS / LAN)

Für reine stdio-Clients (wie Claude Desktop), die sich nicht direkt über HTTP verbinden können. Erfordert Node.js auf dem Mac, der den Client ausführt.

  1. Starte den Server auf dem iPhone und kopiere Endpoint und Token
  2. Wähle auf deinem Mac mcp-remote (iOS / LAN) auf dem Server-Bildschirm und kopiere das JSON-Snippet, oder füge dies in die MCP-Konfiguration des Clients ein (Claude Desktop → Einstellungen → Entwickler → Config bearbeiten):
{
  "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. Exportiere die CA vom iPhone und vertraue ihr in Schlüsselbundverwaltung (Immer vertrauen) auf deinem Mac
  2. Verwende https://192.168.1.42:9000/mcp in args
  3. Für vom generierten Setup oben unterstützte Node-Versionen füge dieses env-Objekt zum selben Server-Konfigurationsobjekt hinzu:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Auf älterem Node setze NODE_EXTRA_CA_CERTS auf einen lesbaren PEM-Pfad. Starte den stdio-Client nach der Config-Aktualisierung neu.

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 Zeit und Zeitzonenoffset

TCP

  • Unverschlüsseltes, unauthentifiziertes JSON-RPC auf Port 9000
  • Verwende Vertrag v1.0.0 mit der Node-health-auto-export-mcp-server-Bridge für Legacy-Toolnamen
  • Verwende Vertrag v1.1.0 für TCP-Toolnamen get_* (aktualisiere die Node-Bridge separat)

Tipps

  1. Halte Health Auto Export im Vordergrund auf dem iPhone, solange Clients verbunden sind
  2. Regeneriere den Token, wenn du vermutest, dass er exponiert wurde
  3. Kopiere die Endpoint-URL erneut, nachdem sich die LAN-IP deines iPhones ändert

Hilfe erhalten

Siehe Hilfe erhalten für Support-Einreichungen und App-Ereignisprotokolle für Diagnoseexporte.