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
HTTPS (TLS)
HTTPS (TLS) HTTPS aktivierenDer CA auf Clients vertraueniOS-LAN-IP-ÄnderungenBeispiel-HTTPS-EndpointClient-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)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
- Öffne auf dem iPhone Server im Tab Exportieren. Auf dem iPad die Seitenleiste verwenden.
- Wähle HTTP (empfohlen) oder TCP
- Aktiviere optional HTTPS verwenden (Anweisungen unten)
- Tippe auf Server starten
- 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
- Öffne die Server-Ansicht (iPhone: Tab Exportieren; iPad: Seitenleiste)
- Schalte HTTPS verwenden ein
- Tippe auf CA-Zertifikat exportieren und verwende das Freigabeblatt für AirDrop oder speichere die CA-Datei auf jedem Client-Gerät
- 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):
- Exportiere die CA vom Server-Bildschirm auf dem iPhone
- Öffne die PEM in Schlüsselbundverwaltung auf dem Client-Mac
- 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-cavertraut dem gesamten System-Schlüsselbund, nicht nur der CA dieser App.NODE_EXTRA_CA_CERTSfü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.
- Starte den Server auf dem iPhone und kopiere Endpoint und Token
- 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:
- Exportiere die CA vom iPhone und vertraue ihr in Schlüsselbundverwaltung (Immer vertrauen) auf deinem Mac
- Verwende
https://192.168.1.42:9000/mcpinargs - 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
- Halte Health Auto Export im Vordergrund auf dem iPhone, solange Clients verbunden sind
- Regeneriere den Token, wenn du vermutest, dass er exponiert wurde
- 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.