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 Server på iPhone via navigasjonen i sidefeltet
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 visningen Server via navigasjonen i sidefeltet
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.