Vejledning til serverforbindelse

MCP-serveren på iOS giver AI-klienter og scripts på dit lokale netværk mulighed for at forespørge dine sundhedsdata. HTTP (Streamable MCP) er den anbefalede transport. iOS understøtter også TCP til opsætninger med Node-bridge.

Klienter køres på din Mac eller andre enheder på samme netværk og opretter forbindelse til det endpoint, der vises på din iPhone.

Oversigt

Transport	Endpoint
HTTP (anbefalet)	http://{LAN_IP}:9000/mcp (eller https:// når HTTPS er aktiveret)
TCP	{LAN_IP}:9000 (uautentificeret)

Erstat {LAN_IP} med den adresse, der vises på skærmen Server, mens serveren kører.

Anvendelser:

• 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, som Claude Desktop
• Forespørg målinger og træninger fra scripts på dit lokale netværk (HTTP)
• TCP-integrationer via Node-bridgen health-auto-export-mcp-server

Forudsætninger

• Health Auto Export på iPhone (appen skal forblive i forgrunden, mens klienter er tilsluttet)
• Premium-abonnement
• HTTP: Bearer-token fra Server-skærmen
• Tilladelse til Lokalt netværk på iPhone
• Klientenhed: Samme Wi-Fi eller LAN som iPhone; Node.js kun hvis du bruger mcp-remote (iOS / LAN)

Start af serveren

1. Åbn Server på iPhone via sidebjælkens navigation
2. Vælg HTTP (anbefalet) eller TCP
3. Aktivér eventuelt Brug HTTPS (instruktioner nedenfor)
4. Tryk på Start server
5. Kopiér endpoint-URL'en og Bearer-tokenet

Serveren stopper automatisk, hvis Health Auto Export sendes til baggrunden (både ved HTTP og TCP).

Autentificering (HTTP)

Alle HTTP-anmodninger kræver:

Authorization: Bearer <your-token>

• Generér tokenet igen fra Server-skærmen, hvis du finder det nødvendigt
• Ved almindelig HTTP sendes tokenet over en ukrypteret forbindelse — brug det kun på betroede netværk, eller aktivér HTTPS
• Gammel TCP har ingen autentificering (uændret)

HTTPS (TLS)

Når Brug HTTPS er aktiveret, genererer appen en privat lokal Certificate Authority (CA) og et servercertifikat underskrevet af denne CA. Klienter skal have tillid til den eksporterede CA, før de kan oprette forbindelse via https://.

Aktivering af HTTPS

1. Åbn visningen Server via sidebjælkens navigation
2. Slå Brug HTTPS til
3. Tryk på Eksportér CA-certifikat, og brug delingsmenuen til at sende filen via AirDrop eller gemme CA-filen på hver klientenhed
4. Start serveren — kontrollér, at endpoint-URL'en skifter til https://

Tildeling af tillid til CA'en på klienter

Giv tillid til den eksporterede CA på den enhed, der kører AI-klienten (normalt din Mac):

1. Eksportér CA'en fra Server-skærmen på iPhone
2. Åbn PEM-filen i Keychain Access på klient-Mac'en
3. Angiv Trust → Always Trust

Minimumsversion af Node til --use-system-ca

Node-bridges (mcp-remote) må kun bruge NODE_OPTIONS=--use-system-ca, når Node som minimum opfylder:

Node-linje	Minimumsversion
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	enhver

På ældre Node-versioner skal du i stedet indstille NODE_EXTRA_CA_CERTS til en PEM-sti, som bridge-processen kan læse. Brug af --use-system-ca på en ikke-understøttet Node-version forhindrer processen i at starte.

Tillidsomfang: --use-system-ca giver tillid til hele system-Keychain'en, ikke kun denne apps CA. NODE_EXTRA_CA_CERTS begrænser tilliden til en enkelt PEM-fil (reserveløsning på ældre Node). Flaget er dokumenteret for macOS/Windows.

Klienttype	Opsætning
Cursor, VS Code, Claude Code, Codex	Keychain-tillid på klient-Mac'en — brug https://-endpointet fra Server-skærmen
mcp-remote (iOS / LAN)	Giv tillid til CA'en i Keychain på den Mac, der kører mcp-remote. Snippetten bruger NODE_OPTIONS=--use-system-ca, når Node opfylder minimumsversionen; på ældre Node skal du indstille NODE_EXTRA_CA_CERTS til en læsbar PEM-sti
curl / scripts	Angiv --cacert /path/to/mcp-ca.pem, eller indstil NODE_EXTRA_CA_CERTS

CA-fingeraftrykket vises på Server-skærmen, så du kan bekræfte, at du har eksporteret det korrekte certifikat.

Ændringer af LAN-IP på iOS

Når din iPhones LAN-IP ændres, genererer appen leaf-certifikatet med opdaterede Subject Alternative Names og genstarter HTTPS-listeneren. Kopiér endpoint-URL'en igen, hvis IP'en er ændret. CA-certifikatet forbliver det samme, med mindre du genererer det igen ved at slå HTTPS fra og til.

Eksempel på HTTPS-endpoint

https://192.168.1.42:9000/mcp

Erstat host'en med den værdi, der vises på Server-skærmen.

Kontraktversion

Version	TCP-værktøjsnavne	Bemærkninger
v1.1.0 (standard)	get_*	Anbefales til nye opsætninger
v1.0.0	Ældre (health_metrics, …)	Kompatibilitetsopdatering v1.0.0 til Claude Desktop
v0.0.1	Ældre	Ældste kompatibilitet

HTTP bruger altid get_*-værktøjsnavne; kontraktversionen påvirker kun standardskemaerne.

Klientkonfiguration

Server-skærmen indeholder kopiér-og-indsæt-snippets til hver integration. Brug endpointet og tokenet, der vises der. Kontrollér formaterne i forhold til din klientversion.

Alle eksemplerne nedenfor bruger en pladsholder-LAN-adresse — udskift den med din iPhones adresse fra Server-skærmen.

Claude Code (CLI)

Køres 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 og givet tillid til CA'en 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 findes 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 config.toml:

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

Eksportér HAE_MCP_TOKEN med dit Bearer-token, før du starter Codex. Efter opsætningen skal du køre /mcp i en Codex-session for at bekræfte, at serveren er forbundet.

Hvis du genererer Bearer-tokenet i Health Auto Export igen, skal du opdatere HAE_MCP_TOKEN og køre codex mcp add igen, eller fjerne og gentilføje serverposten.

mcp-remote (iOS / LAN)

Til klienter, der kun understøtter stdio (som Claude Desktop), og som ikke kan oprette forbindelse direkte via HTTP. Kræver Node.js på den Mac, der kører klienten.

1. Start serveren på iPhone, og kopiér endpointet og tokenet
2. Vælg mcp-remote (iOS / LAN) på Server-skærmen på din Mac, og kopiér JSON-snippetten, eller indsæt følgende i klientens MCP-konfiguration (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>"
  ]
}

Når HTTPS er aktiveret:

1. Eksportér CA'en fra iPhone, og giv den tillid i Keychain Access (Always Trust) på din Mac
2. Brug https://192.168.1.42:9000/mcp i args
3. Når Node opfylder minimumsversionen for --use-system-ca (22.19.0 på 22.x, 23.8.0 på 23.x, 24.6.0 på 24.x, eller enhver 25+-version), skal du tilføje:

"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

På ældre Node-versioner skal du i stedet indstille NODE_EXTRA_CA_CERTS til en læsbar PEM-sti. Genstart stdio-klienten efter opdatering af konfigurationen.

Reducering af opstartsforsinkelse: npx -y downloader mcp-remote ved første brug og kontrollerer igen, når cachen udløber, hvilket kan forårsage forsinkelser på flere sekunder. Forudinstallation globalt eliminerer dette:

npm install -g mcp-remote@0.1.16

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 tidszoneforskydning

TCP

• Ukrypteret, uautentificeret JSON-RPC på port 9000
• Brug kontrakt v1.0.0 med Node-bridgen health-auto-export-mcp-server til ældre værktøjsnavne
• Brug kontrakt v1.1.0 til get_*-TCP-værktøjsnavne (opdater Node-bridgen separat)

Tips

1. Hold Health Auto Export i forgrunden på iPhone, mens klienter er tilsluttet
2. Generér tokenet igen, hvis du har en formodning om, at det er blevet eksponeret
3. Kopiér endpoint-URL'en igen, efter din iPhones LAN-IP er ændret

Chatsupport

Indsaml diagnostik fra appens hændelseslogfiler ved at gå til Indstillinger → Avanceret → Eksportér hændelseslogfiler. Se Vejledning til app-hændelseslogfiler. Del den genererede zip-fil via chatsupport eller e-mail.