Veiledning for serverforbindelse

MCP-serveren på iOS lar AI-klienter og skript på ditt lokale nettverk spørre etter helsedataene dine. HTTP (Streamable MCP) er den anbefalte transporten. iOS støtter også TCP for oppsett med Node-bro.

Klienter kjører på Mac-en din eller andre enheter på samme nettverk og kobler til endepunktet som vises på iPhonen din.

Oversikt

Transport	Endepunkt
HTTP (anbefalt)	http://{LAN_IP}:9000/mcp (eller https:// når HTTPS er aktivert)
TCP	{LAN_IP}:9000 (uautentisert)

Erstatt {LAN_IP} med adressen som vises på skjermen Server mens serveren kjører.

Bruksområder:

• Koble Claude Code, Codex, Cursor eller VS Code på Mac-en din til helsedata på iPhonen din
• Bruk mcp-remote (iOS / LAN) for klienter som kun støtter stdio, som Claude Desktop
• Spørre etter målinger og treninger fra skript på ditt lokale nettverk (HTTP)
• TCP-integrasjoner via Node-broen health-auto-export-mcp-server

Forutsetninger

• Health Auto Export på iPhone (appen må forbli i forgrunnen mens klienter er tilkoblet)
• Premium-abonnement
• HTTP: Bearer-token fra Server-skjermen
• Lokalt nettverk-tillatelse på iPhone
• Klientenhet: Samme Wi-Fi eller LAN som iPhonen; Node.js kun hvis du bruker mcp-remote (iOS / LAN)

Starte serveren

1. Åpne sidefeltet, og trykk på Server
2. Velg HTTP (anbefalt) eller TCP
3. Slå eventuelt på Bruk HTTPS (instruksjoner nedenfor)
4. Trykk på Start server
5. Kopier endepunkt-URL-en og Bearer-tokenet

Serveren stopper automatisk hvis Health Auto Export sendes til bakgrunnen (både for HTTP og TCP).

Autentisering (HTTP)

Alle HTTP-forespørsler krever:

Authorization: Bearer <your-token>

• Regenerer tokenet fra Server-skjermen hvis du anser det nødvendig
• På vanlig HTTP sendes tokenet over en ukryptert forbindelse — bruk det kun på tiltrodde nettverk, eller aktiver HTTPS
• Eldre TCP har ingen autentisering (uendret)

HTTPS (TLS)

Når Bruk HTTPS er aktivert, genererer appen en privat lokal sertifiseringsinstans (CA) og et serversertifikat signert av denne CA-en. Klienter må tiltro den eksporterte CA-en før de kan koble til via https://.

Aktivere HTTPS

1. Åpne sidefeltet, og trykk på Server
2. Slå på Bruk HTTPS
3. Trykk på Eksporter CA-sertifikat og bruk delingsmenyen til å sende via AirDrop eller lagre CA-filen på hver klientenhet
4. Start serveren — kontroller at endepunkt-URL-en bytter til https://

Tiltro CA-en på klienter

Tiltro den eksporterte CA-en på enheten som kjører AI-klienten (vanligvis Mac-en din):

1. Eksporter CA-en fra Server-skjermen på iPhone
2. Åpne PEM-filen i Keychain Access på klient-Mac-en
3. Sett Trust → Always Trust

Minste Node-versjon for --use-system-ca

Node-broer (mcp-remote) kan bare bruke NODE_OPTIONS=--use-system-ca når Node minst oppfyller:

Node-linje	Minimumsversjon
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	hvilken som helst

På eldre Node-versjoner, sett i stedet NODE_EXTRA_CA_CERTS til en PEM-sti som broprosessen kan lese. Å bruke --use-system-ca på en Node-versjon som ikke støttes, forhindrer at prosessen starter.

Tillitsomfang: --use-system-ca tiltror hele system-Keychain, ikke bare denne appens CA. NODE_EXTRA_CA_CERTS begrenser tilliten til én enkelt PEM-fil (reserveløsning på eldre Node). Flagget er dokumentert for macOS/Windows.

Klienttype	Oppsett
Cursor, VS Code, Claude Code, Codex	Keychain-tillit på klient-Mac-en — bruk https://-endepunktet fra Server-skjermen
mcp-remote (iOS / LAN)	Tiltro CA-en i Keychain på Mac-en som kjører mcp-remote. Snippet bruker NODE_OPTIONS=--use-system-ca når Node oppfyller minimumsversjonen; på eldre Node, sett NODE_EXTRA_CA_CERTS til en lesbar PEM-sti
curl / skript	Send --cacert /path/to/mcp-ca.pem eller sett NODE_EXTRA_CA_CERTS

CA-fingeravtrykket vises på Server-skjermen, slik at du kan bekrefte at du eksporterte riktig sertifikat.

Endringer i LAN-IP på iOS

Når iPhonens LAN-IP endres, genererer appen leaf-sertifikatet på nytt med oppdaterte Subject Alternative Names og starter HTTPS-lytteren på nytt. Kopier endepunkt-URL-en på nytt hvis IP-en har endret seg. CA-sertifikatet forblir det samme med mindre du genererer det på nytt ved å slå HTTPS av og på.

Eksempel på HTTPS-endepunkt

https://192.168.1.42:9000/mcp

Erstatt verten med verdien som vises på Server-skjermen.

Kontraktsversjon

Versjon	TCP-verktøysnavn	Merknader
v1.1.0 (standard)	get_*	Anbefales for nye oppsett
v1.0.0	Eldre (health_metrics, …)	Kompatibilitetsoppdatering v1.0.0 for Claude Desktop
v0.0.1	Eldre	Eldste kompatibilitet

HTTP bruker alltid get_*-verktøysnavn; kontraktsversjonen påvirker bare standardskjemaene.

Klientkonfigurasjon

Server-skjermen inneholder kopier-og-lim-inn-utdrag for hver integrasjon. Bruk endepunktet og tokenet som vises der. Kontroller formatene mot klientversjonen din.

Alle eksemplene nedenfor bruker en plassholder-LAN-adresse — erstatt den med iPhonens adresse fra Server-skjermen.

Claude Code (CLI)

Kjøres på Mac-en din (krever Claude Code CLI):

HTTP:

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

HTTPS (etter at du har eksportert og tiltrodd CA-en på Mac-en din):

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

Claude Code / prosjektfil (.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 kobler til direkte via Streamable HTTP — ingen Node.js-bro er nødvendig. Konfigurasjonen finnes i ~/.codex/config.toml (global) eller .codex/config.toml i en tiltrodd prosjektmappe.

CLI (anbefalt):

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

Manuell 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 Bearer-tokenet ditt før du starter Codex. Kjør /mcp i en Codex-sesjon etter oppsettet for å bekrefte at serveren er tilkoblet.

Hvis du regenererer Bearer-tokenet i Health Auto Export, må du oppdatere HAE_MCP_TOKEN og kjøre codex mcp add på nytt, eller fjerne og legge til serveroppføringen på nytt.

mcp-remote (iOS / LAN)

For klienter som kun støtter stdio (som Claude Desktop), og som ikke kan koble til direkte via HTTP. Krever Node.js på Mac-en som kjører klienten.

1. Start serveren på iPhone og kopier endepunktet og tokenet
2. Velg mcp-remote (iOS / LAN) på Server-skjermen på Mac-en din og kopier JSON-utdraget, eller lim inn følgende i klientens MCP-konfigurasjon (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 aktivert:

1. Eksporter CA-en fra iPhone og tiltro den i Keychain Access (Always Trust) på Mac-en din
2. Bruk https://192.168.1.42:9000/mcp i args
3. Når Node oppfyller minimumsversjonen for --use-system-ca (22.19.0 på 22.x, 23.8.0 på 23.x, 24.6.0 på 24.x, eller en hvilken som helst 25+-versjon), legg til:

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

På eldre Node-versjoner, sett i stedet NODE_EXTRA_CA_CERTS til en lesbar PEM-sti. Start stdio-klienten på nytt etter at konfigurasjonen er oppdatert.

Redusere oppstartsforsinkelse: npx -y laster ned mcp-remote ved første bruk og sjekker på nytt når hurtigbufferen utløper, noe som kan forårsake forsinkelser på flere sekunder. Forhåndsinstallering globalt eliminerer dette:

npm install -g mcp-remote@0.1.16

Verktøyargumenter

Datoformater

Parameterne start og end godtar to formater:

Format	Eksempel	Merknader
yyyy-MM-dd	2026-06-13	Startdato: midnatt; sluttdato: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Eksplisitt tid og tidssoneforskyvning

TCP

• Ukryptert, uautentisert JSON-RPC på port 9000
• Bruk kontrakt v1.0.0 med Node-broen health-auto-export-mcp-server for eldre verktøysnavn
• Bruk kontrakt v1.1.0 for get_*-TCP-verktøysnavn (oppdater Node-broen separat)

Tips

1. Hold Health Auto Export i forgrunnen på iPhone mens klienter er tilkoblet
2. Regenerer tokenet hvis du har grunn til å tro at det er blitt eksponert
3. Kopier endepunkt-URL-en på nytt etter at iPhonens LAN-IP har endret seg

Chattstøtte

Samle inn diagnostikk fra appens hendelseslogger ved å gå til Innstillinger → Avansert → Eksporter hendelseslogger. Se Veiledning for app-hendelseslogger. Del den genererte zip-filen via chattstøtte eller e-post.