Handleiding voor serververbinding

Met de MCP-server op iOS kunnen AI-clients en scripts op je lokale netwerk je gezondheidsgegevens opvragen. HTTP (Streamable MCP) is de aanbevolen transportmethode. iOS ondersteunt ook TCP voor opstellingen met een Node-bridge.

Clients draaien op je Mac of andere apparaten in hetzelfde netwerk en maken verbinding met het endpoint dat op je iPhone wordt weergegeven.

Overzicht

Transport	Endpoint
HTTP (aanbevolen)	http://{LAN_IP}:9000/mcp (of https:// wanneer HTTPS is ingeschakeld)
TCP	{LAN_IP}:9000 (niet-geauthenticeerd)

Vervang {LAN_IP} door het adres dat wordt weergegeven op het scherm Server terwijl de server actief is.

Toepassingen:

• Claude Code, Codex, Cursor of VS Code op je Mac verbinden met gezondheidsgegevens op je iPhone
• mcp-remote (iOS / LAN) gebruiken voor alleen-stdio-clients zoals Claude Desktop
• Statistieken en workouts opvragen vanuit scripts op je lokale netwerk (HTTP)
• TCP-integraties via de Node-bridge health-auto-export-mcp-server

Vereisten

• Health Auto Export op iPhone (de app moet op de voorgrond blijven terwijl clients verbonden zijn)
• Premium-abonnement
• HTTP: Bearer-token van het Server-scherm
• Toestemming voor Lokaal netwerk op de iPhone
• Clientapparaat: hetzelfde wifi- of LAN-netwerk als de iPhone; Node.js alleen als je mcp-remote (iOS / LAN) gebruikt

De server starten

1. Open op de iPhone Server via de navigatie in de zijbalk
2. Kies HTTP (aanbevolen) of TCP
3. Schakel eventueel HTTPS gebruiken in (instructies hieronder)
4. Tik op Server starten
5. Kopieer de endpoint-URL en het Bearer-token

De server stopt automatisch wanneer Health Auto Export naar de achtergrond gaat (zowel bij HTTP als TCP).

Authenticatie (HTTP)

Alle HTTP-verzoeken vereisen:

Authorization: Bearer <your-token>

• Genereer het token opnieuw vanuit het Server-scherm als je dat nodig acht
• Bij gewone HTTP wordt het token verzonden via een onversleutelde verbinding — gebruik dit alleen op vertrouwde netwerken, of schakel HTTPS in
• Legacy TCP heeft geen authenticatie (ongewijzigd)

HTTPS (TLS)

Wanneer HTTPS gebruiken is ingeschakeld, genereert de app een privé lokale Certificate Authority (CA) en een servercertificaat dat door deze CA is ondertekend. Clients moeten de geëxporteerde CA vertrouwen voordat ze via https:// verbinding kunnen maken.

HTTPS inschakelen

1. Open de weergave Server via de navigatie in de zijbalk
2. Schakel HTTPS gebruiken in
3. Tik op CA-certificaat exporteren en gebruik het deelvenster om het CA-bestand via AirDrop te versturen of op te slaan op elk clientapparaat
4. Start de server — controleer of de endpoint-URL overschakelt naar https://

De CA vertrouwen op clients

Vertrouw de geëxporteerde CA op het apparaat waarop de AI-client draait (meestal je Mac):

1. Exporteer de CA vanuit het Server-scherm op de iPhone
2. Open het PEM-bestand in Keychain Access op de client-Mac
3. Stel Trust → Always Trust in

Minimale Node-versie voor --use-system-ca

Node-bridges (mcp-remote) mogen NODE_OPTIONS=--use-system-ca alleen gebruiken wanneer Node minimaal voldoet aan:

Node-lijn	Minimale versie
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	elke versie

Stel bij oudere Node-versies in plaats daarvan NODE_EXTRA_CA_CERTS in op een PEM-pad dat het bridgeproces kan lezen. Het gebruik van --use-system-ca op een niet-ondersteunde Node-versie voorkomt dat het proces start.

Vertrouwensbereik: --use-system-ca vertrouwt de volledige systeem-Keychain, niet alleen de CA van deze app. NODE_EXTRA_CA_CERTS beperkt het vertrouwen tot één enkel PEM-bestand (terugvaloptie op oudere Node-versies). De flag is gedocumenteerd voor macOS/Windows.

Clienttype	Instellen
Cursor, VS Code, Claude Code, Codex	Keychain-vertrouwen op de client-Mac — gebruik het https://-endpoint van het Server-scherm
mcp-remote (iOS / LAN)	Vertrouw de CA in Keychain op de Mac waarop mcp-remote draait. Het snippet gebruikt NODE_OPTIONS=--use-system-ca wanneer Node aan de minimale versie voldoet; stel bij oudere Node-versies NODE_EXTRA_CA_CERTS in op een leesbaar PEM-pad
curl / scripts	Geef --cacert /path/to/mcp-ca.pem door of stel NODE_EXTRA_CA_CERTS in

De vingerafdruk van de CA wordt weergegeven op het Server-scherm, zodat je kunt controleren of je het juiste certificaat hebt geëxporteerd.

Wijzigingen van het LAN-IP-adres op iOS

Wanneer het LAN-IP-adres van je iPhone wijzigt, genereert de app het servercertificaat opnieuw met bijgewerkte Subject Alternative Names en start de HTTPS-listener opnieuw. Kopieer de endpoint-URL opnieuw als het IP-adres is gewijzigd. Het CA-certificaat blijft hetzelfde, tenzij je het opnieuw genereert door HTTPS uit en weer aan te zetten.

Voorbeeld van een HTTPS-endpoint

https://192.168.1.42:9000/mcp

Vervang de host door de waarde die op het Server-scherm wordt weergegeven.

Contractversie

Versie	TCP-toolnamen	Opmerkingen
v1.1.0 (standaard)	get_*	Aanbevolen voor nieuwe installaties
v1.0.0	Legacy (health_metrics, …)	Compatibiliteitsupdate v1.0.0 voor Claude Desktop
v0.0.1	Legacy	Oudste compatibiliteit

HTTP gebruikt altijd get_*-toolnamen; de contractversie heeft alleen invloed op de standaardschema's.

Clientconfiguratie

Het Server-scherm bevat kopieer-en-plak-snippets voor elke integratie. Gebruik het endpoint en het token die daar worden weergegeven. Controleer de indeling aan de hand van je clientversie.

Alle onderstaande voorbeelden gebruiken een voorbeeld-LAN-adres — vervang dit door het adres van je iPhone vanaf het Server-scherm.

Claude Code (CLI)

Uitvoeren op je Mac (vereist de Claude Code CLI):

HTTP:

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

HTTPS (na het exporteren en vertrouwen van de CA op je Mac):

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

Claude Code / projectbestand (.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 maakt rechtstreeks verbinding via Streamable HTTP — er is geen Node.js-bridge nodig. De configuratie staat in ~/.codex/config.toml (algemeen) of .codex/config.toml in een vertrouwde projectmap.

CLI (aanbevolen):

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

Handmatige config.toml:

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

Exporteer HAE_MCP_TOKEN met je Bearer-token voordat je Codex start. Voer na het instellen /mcp uit binnen een Codex-sessie om te controleren of de server verbonden is.

Als je het Bearer-token in Health Auto Export opnieuw genereert, werk dan HAE_MCP_TOKEN bij en voer codex mcp add opnieuw uit, of verwijder en voeg de serverinvoer opnieuw toe.

mcp-remote (iOS / LAN)

Voor alleen-stdio-clients (zoals Claude Desktop) die niet rechtstreeks via HTTP kunnen verbinden. Vereist Node.js op de Mac waarop de client draait.

1. Start de server op de iPhone en kopieer het endpoint en het token
2. Selecteer op je Mac mcp-remote (iOS / LAN) op het Server-scherm en kopieer het JSON-snippet, of plak dit in de MCP-configuratie van de client (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>"
  ]
}

Wanneer HTTPS is ingeschakeld:

1. Exporteer de CA vanaf de iPhone en vertrouw deze in Keychain Access (Always Trust) op je Mac
2. Gebruik https://192.168.1.42:9000/mcp in args
3. Wanneer Node voldoet aan de minimale versie voor --use-system-ca (22.19.0 op 22.x, 23.8.0 op 23.x, 24.6.0 op 24.x, of elke 25+-versie), voeg je het volgende toe:

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

Stel bij oudere Node-versies in plaats daarvan NODE_EXTRA_CA_CERTS in op een leesbaar PEM-pad. Start de stdio-client opnieuw na het bijwerken van de configuratie.

Opstartvertraging verminderen: npx -y downloadt mcp-remote bij het eerste gebruik en controleert opnieuw wanneer de cache verloopt, wat vertragingen van meerdere seconden kan veroorzaken. Door het globaal vooraf te installeren, wordt dit voorkomen:

npm install -g mcp-remote@0.1.16

Toolargumenten

Datumformaten

De parameters start en end accepteren twee formaten:

Formaat	Voorbeeld	Opmerkingen
yyyy-MM-dd	2026-06-13	Startdatum: middernacht; einddatum: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Expliciete tijd en tijdzoneverschuiving

TCP

• Onversleutelde, niet-geauthenticeerde JSON-RPC op poort 9000
• Gebruik contract v1.0.0 met de Node-bridge health-auto-export-mcp-server voor legacy-toolnamen
• Gebruik contract v1.1.0 voor get_*-TCP-toolnamen (werk de Node-bridge apart bij)

Tips

1. Houd Health Auto Export op de voorgrond op de iPhone terwijl clients verbonden zijn
2. Genereer het token opnieuw als je vermoedt dat het is blootgesteld
3. Kopieer de endpoint-URL opnieuw nadat het LAN-IP-adres van je iPhone is gewijzigd

Chatondersteuning

Verzamel diagnostische gegevens uit de gebeurtenislogboeken van de app via Instellingen → Geavanceerd → Gebeurtenislogboeken exporteren. Zie de handleiding voor app-gebeurtenislogboeken. Deel het gegenereerde zip-bestand via chatondersteuning of e-mail.