Opret forbindelse til server
Opret forbindelse til Health Auto Export MCP-serveren for AI-klienter og scripts på dit lokale netværk.
Senest opdateret: 31. oktober 2026
På denne side
HTTPS (TLS)
HTTPS (TLS) Aktivér HTTPSStol på CA'en på klienterÆndringer i iOS LAN-IPEksempel på HTTPS-slutpunktKlientkonfiguration
Klientkonfiguration Claude Code (CLI)Claude Code / projektfil (<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)MCP-serveren på iOS lader AI-klienter og scripts på dit lokale netværk forespørge dine sundhedsdata. HTTP (Streamable MCP) er den anbefalede transport. iOS understøtter også TCP til Node-bridge-opsætninger.
Klienter kører på din Mac eller andre enheder på det samme netværk og opretter forbindelse til det slutpunkt, der vises på din iPhone.
Oversigt
| Transport | Slutpunkt |
|---|---|
| HTTP (anbefalet) | http://{LAN_IP}:9000/mcp (eller https://, når HTTPS er aktiveret) |
| TCP | {LAN_IP}:9000 (uden godkendelse) |
Erstat {LAN_IP} med den adresse, der vises på skærmen Server, mens serveren kører.
Anvendelsesområder:
- Forbind Claude Code, Codex, Cursor eller VS Code på din Mac til sundhedsdata på din iPhone
- Brug mcp-remote (iOS / LAN) til klienter, der kun understøtter stdio, såsom Claude Desktop
- Forespørg målinger og træninger fra scripts på dit lokale netværk (HTTP)
- TCP-integrationer via Node-bridge health-auto-export-mcp-server
Forudsætninger
- Health Auto Export på iPhone (appen skal forblive i forgrunden, mens klienter er forbundet)
- Premium-abonnement
- HTTP: Bearer-token fra Server-skærmen
- Tilladelse til Lokalt netværk på iPhone
- Klientenhed: Samme Wi‑Fi eller LAN som iPhonen; Node.js kun hvis du bruger mcp-remote (iOS / LAN)
Start serveren
- Åbn på iPhone Server fra fanen Eksporter. På iPad bruger du sidebjælken.
- Vælg HTTP (anbefalet) eller TCP
- Aktivér valgfrit Brug HTTPS (vejledning nedenfor)
- Tryk på Start server
- Kopiér slutpunkts-URL'en og bearer-tokenet
Den aktive server stopper automatisk, hvis Health Auto Export sendes til baggrunden, uanset om du bruger HTTP eller TCP.
Godkendelse (HTTP)
Alle HTTP-anmodninger kræver:
Authorization: Bearer <your-token>
- Generer tokenet igen fra Server-skærmen, hvis det er nødvendigt
- På almindelig HTTP sendes tokenet over en ukrypteret forbindelse—brug det kun på betroede netværk, eller aktivér HTTPS
- TCP legacy har ingen godkendelse (uændret)
HTTPS (TLS)
HTTPS bruger en lokalt genereret Certificate Authority (CA). Eksporter og stol på dens certifikat på hver klientenhed, før du opretter forbindelse via https://.
Aktivér HTTPS
- Åbn visningen Server (iPhone: fanen Eksporter; iPad: sidebjælke)
- Slå Brug HTTPS til
- Tryk på Eksporter CA-certifikat, og brug delearket til at AirDrop'e eller gemme CA-filen på hver klientenhed
- Start serveren — sørg for, at slutpunkts-URL'en skifter til
https://
Stol på CA'en på klienter
Stol på den eksporterede CA på den enhed, der kører AI-klienten (normalt din Mac):
- Eksporter CA'en fra Server-skærmen på iPhone
- Åbn PEM-filen i Nøglering på klient-Mac'en
- Indstil Tillid → Stol altid på
Node-versioner til den genererede opsætning
Appens genererede Node-bridge-opsætning bruger NODE_OPTIONS=--use-system-ca til disse Node-versioner:
| Node-linje | Minimumversion |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | enhver |
På ældre Node skal du i stedet angive NODE_EXTRA_CA_CERTS til en PEM-sti, som bridge-processen kan læse. At udsende --use-system-ca på ikke-understøttet Node forhindrer processen i at starte.
Tillidsomfang:
--use-system-castoler på hele systemnøgleringen, ikke kun denne apps CA.NODE_EXTRA_CA_CERTStilføjer den eksporterede CA til Nodes betroede certifikater. Se Node-certifikatindstillinger.
| Klienttype | Opsætning |
|---|---|
| Cursor, VS Code, Claude Code, Codex | Nøgleringstillid på klient-Mac — brug https://-slutpunktet fra Server-skærmen |
| mcp-remote (iOS / LAN) | Stol på CA i Nøglering på den Mac, der kører mcp-remote. Snippet bruger NODE_OPTIONS=--use-system-ca, når Node opfylder minimumversionen; på ældre Node skal du angive NODE_EXTRA_CA_CERTS til en læsbar PEM-sti |
| curl / scripts | Send --cacert /path/to/mcp-ca.pem, eller angiv NODE_EXTRA_CA_CERTS |
CA-fingeraftrykket vises på Server-skærmen, så du kan bekræfte, at du eksporterede det korrekte certifikat.
Ændringer i iOS LAN-IP
Kopiér slutpunkts-URL'en igen, hvis din iPhones netværksadresse ændres. Hvis der leveres et erstatnings-CA-certifikat, skal du eksportere det og opdatere tilliden på hver klientenhed.
Eksempel på HTTPS-slutpunkt
https://192.168.1.42:9000/mcp
Erstat værten med den værdi, der vises på Server-skærmen.
Kontraktversion
| Version | TCP-værktøjsnavne | Bemærkninger |
|---|---|---|
| v1.1.0 (standard) | get_* |
Anbefalet til nye opsætninger |
| v1.0.0 | Legacy (health_metrics, …) |
Claude Desktop-kompatibilitetsopdatering v1.0.0 |
| v0.0.1 | Legacy | Ældste kompatibilitet |
HTTP bruger altid værktøjsnavne get_*; kontraktversionen påvirker kun skemastandarder.
Klientkonfiguration
Server-skærmen indeholder copy-paste-snippets til hver integration. Brug det slutpunkt og token, der vises der. Verificer formater i forhold til din klientversion.
Alle eksempler nedenfor bruger en midlertidig LAN-adresse—erstat den med din iPhones adresse fra Server-skærmen.
Claude Code (CLI)
Kør på din Mac (kræver Claude Code CLI):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS (efter at have eksporteret CA'en og givet den tillid på din Mac):
claude mcp add --transport http health-auto-export \
https://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
Claude Code / projektfil (.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 opretter forbindelse direkte via Streamable HTTP — der kræves ingen Node.js-bridge. Konfigurationen ligger i ~/.codex/config.toml (global) eller .codex/config.toml i en betroet projektmappe.
CLI (anbefalet):
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
Manuel 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
Eksporter HAE_MCP_TOKEN med dit bearer-token, før du starter Codex. Kør efter opsætning /mcp inde i en Codex-session for at bekræfte, at serveren er forbundet.
Hvis du regenererer bearer-tokenet i Health Auto Export, skal du opdatere HAE_MCP_TOKEN og køre codex mcp add igen, eller fjerne og tilføje serverposten igen.
mcp-remote (iOS / LAN)
Til klienter, der kun understøtter stdio (såsom Claude Desktop), som ikke kan oprette forbindelse direkte via HTTP. Kræver Node.js på den Mac, der kører klienten.
- Start serveren på iPhone, og kopiér slutpunktet og tokenet
- Vælg på din Mac mcp-remote (iOS / LAN) på Server-skærmen, og kopiér JSON-snippettet, eller indsæt dette i klientens MCP-konfiguration (Claude Desktop → Indstillinger → Udvikler → Rediger konfiguration):
{
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.16",
"http://192.168.1.42:9000/mcp",
"--transport",
"http-only",
"--header",
"Authorization: Bearer <token>"
]
}
Når HTTPS er aktiveret:
- Eksporter CA'en fra iPhone, og stol på den i Nøglering (Stol altid på) på din Mac
- Brug
https://192.168.1.42:9000/mcpiargs - Til Node-versioner, der understøttes af den genererede opsætning ovenfor, skal du tilføje dette
env-objekt til det samme serverkonfigurationsobjekt:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
På ældre Node skal du i stedet angive NODE_EXTRA_CA_CERTS til en læsbar PEM-sti. Genstart stdio-klienten efter at have opdateret konfigurationen.
Værktøjsargumenter
Datoformater
Parametrene start og end accepterer to formater:
| Format | Eksempel | Bemærkninger |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
Startdato: midnat; slutdato: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
Eksplicit tid og tidszoneoffset |
TCP
- Ukrypteret, uautoriseret JSON-RPC på port 9000
- Brug kontrakt v1.0.0 med Node-bridgen
health-auto-export-mcp-servertil legacy-værktøjsnavne - Brug kontrakt v1.1.0 til TCP-værktøjsnavne
get_* (opdater Node-bridgen separat)
Tips
- Hold Health Auto Export i forgrunden på iPhone, mens klienter er forbundet
- Generer tokenet igen, hvis du mistænker, at det er blevet eksponeret
- Kopiér slutpunkts-URL'en igen, efter at din iPhones LAN-IP ændres
Få hjælp
Se Få hjælp for supportindsendelser og App-hændelseslogfiler for diagnostiske eksporter.