Helpcentrum HealthyApps
Nederlands
Helpcentrum
Hoofdwebsite ↗

Zoek in helponderwerpen

Verbinding met de server

Maak verbinding met de Health Auto Export MCP-server voor AI-clients en scripts op je lokale netwerk.

Laatst bijgewerkt: 31 oktober 2026

Op deze pagina
OverzichtVereistenDe server startenAuthenticatie (HTTP)
HTTPS (TLS) HTTPS (TLS) HTTPS inschakelenDe CA op clients vertrouwenWijzigingen in iOS LAN-IPVoorbeeld HTTPS-eindpunt
Contractversie
Clientconfiguratie Clientconfiguratie Claude Code (CLI)Claude Code / projectbestand (<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)
Toolargumenten Toolargumenten Datumindelingen
TCPTipsHulp krijgen

De MCP-server op iOS laat AI-clients en scripts op je lokale netwerk je gezondheidsgegevens opvragen. HTTP (Streamable MCP) is het aanbevolen transport. iOS ondersteunt ook TCP voor Node-bridge-opstellingen.

Clients draaien op je Mac of andere apparaten op hetzelfde netwerk en verbinden met het eindpunt dat op je iPhone wordt getoond.

Overzicht

Transport Eindpunt
HTTP (aanbevolen) http://{LAN_IP}:9000/mcp (of https:// wanneer HTTPS is ingeschakeld)
TCP {LAN_IP}:9000 (zonder authenticatie)

Vervang {LAN_IP} door het adres dat op het scherm Server wordt getoond terwijl de server draait.

Gebruikssituaties:

  • Claude Code, Codex, Cursor of VS Code op je Mac verbinden met gezondheidsgegevens op je iPhone
  • mcp-remote (iOS / LAN) gebruiken voor clients die alleen stdio ondersteunen, zoals Claude Desktop
  • Metrieken en trainingen 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 zijn verbonden)
  • Premium-abonnement
  • HTTP: Bearer-token vanaf het Server-scherm
  • Machtiging Lokaal netwerk op iPhone
  • Clientapparaat: dezelfde Wi‑Fi of LAN als de iPhone; Node.js alleen als je mcp-remote (iOS / LAN) gebruikt

De server starten

  1. Open op iPhone Server vanaf het tabblad Exporteren. Op iPad gebruik je de zijbalk.
  2. Kies HTTP (aanbevolen) of TCP
  3. Schakel optioneel Gebruik HTTPS in (instructies hieronder)
  4. Tik op Start server
  5. Kopieer de eindpunt-URL en het bearer-token

De actieve server stopt automatisch als Health Auto Export naar de achtergrond gaat, of je nu HTTP of TCP gebruikt.

Authenticatie (HTTP)

Alle HTTP-verzoeken vereisen:

Authorization: Bearer <your-token>
  • Genereer het token opnieuw vanaf het Server-scherm indien nodig
  • Op plain HTTP wordt het token over een onversleutelde verbinding verzonden—gebruik dit alleen op vertrouwde netwerken, of schakel HTTPS in
  • TCP legacy heeft geen authenticatie (ongewijzigd)

HTTPS (TLS)

HTTPS gebruikt een lokaal gegenereerde Certificate Authority (CA). Exporteer en vertrouw het certificaat op elk clientapparaat voordat je via https:// verbindt.

HTTPS inschakelen

  1. Open de weergave Server (iPhone: tabblad Exporteren; iPad: zijbalk)
  2. Schakel Gebruik HTTPS in
  3. Tik op CA-certificaat exporteren en gebruik het deelblad om het CA-bestand via AirDrop of opslaan op elk clientapparaat te zetten
  4. Start de server — controleer dat de eindpunt-URL overschakelt naar https://

De CA op clients vertrouwen

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

  1. Exporteer de CA vanaf het Server-scherm op iPhone
  2. Open de PEM in Sleutelhangertoegang op de client-Mac
  3. Stel Vertrouwen → Altijd vertrouwen in

Node-versies voor de gegenereerde setup

De gegenereerde Node-bridgesetup van de app gebruikt NODE_OPTIONS=--use-system-ca voor deze Node-versies:

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

Op oudere Node stel je NODE_EXTRA_CA_CERTS in op een PEM-pad dat het bridgeproces kan lezen. --use-system-ca uitzenden op niet-ondersteunde Node voorkomt dat het proces start.

Vertrouwensbereik: --use-system-ca vertrouwt de volledige systeemsleutelhanger, niet alleen de CA van deze app. NODE_EXTRA_CA_CERTS voegt de geëxporteerde CA toe aan de vertrouwde certificaten van Node. Zie Node-certificaatopties.

Clienttype Setup
Cursor, VS Code, Claude Code, Codex Sleutelhangervertrouwen op de client-Mac — gebruik het https://-eindpunt vanaf het Server-scherm
mcp-remote (iOS / LAN) Vertrouw CA in Sleutelhanger op de Mac die mcp-remote draait. Snippet gebruikt NODE_OPTIONS=--use-system-ca wanneer Node de minimumversie haalt; op oudere Node stel 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 CA-vingerafdruk wordt op het Server-scherm getoond zodat je kunt controleren dat je het juiste certificaat hebt geëxporteerd.

Wijzigingen in iOS LAN-IP

Kopieer de eindpunt-URL opnieuw als het netwerkadres van je iPhone wijzigt. Als er een vervangend CA-certificaat wordt geleverd, exporteer het en werk het vertrouwen op elk clientapparaat bij.

Voorbeeld HTTPS-eindpunt

https://192.168.1.42:9000/mcp

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

Contractversie

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

HTTP gebruikt altijd toolnamen get_*; de contractversie beïnvloedt alleen schema-standaardwaarden.

Clientconfiguratie

Het Server-scherm bevat copy-paste-snippets voor elke integratie. Gebruik het eindpunt en token die daar worden getoond. Controleer indelingen tegen je clientversie.

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

Claude Code (CLI)

Voer uit 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 (nadat je de CA op je Mac hebt geëxporteerd en vertrouwd):

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 verbindt rechtstreeks via Streamable HTTP — er is geen Node.js-bridge nodig. Configuratie staat in ~/.codex/config.toml (globaal) 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 configuratie (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 de setup /mcp uit in een Codex-sessie om te controleren dat de server is verbonden.

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

mcp-remote (iOS / LAN)

Voor clients die alleen stdio ondersteunen (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 iPhone en kopieer het eindpunt en 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-config van de client (Claude Desktop → Instellingen → Ontwikkelaar → Configuratie bewerken):
{
  "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 iPhone en vertrouw deze in Sleutelhangertoegang (Altijd vertrouwen) op je Mac
  2. Gebruik https://192.168.1.42:9000/mcp in args
  3. Voor Node-versies die door de gegenereerde setup hierboven worden ondersteund, voeg dit env-object toe aan hetzelfde serverconfiguratieobject:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Op oudere Node stel je NODE_EXTRA_CA_CERTS in op een leesbaar PEM-pad. Herstart de stdio-client na het bijwerken van de config.

Toolargumenten

Datumindelingen

De parameters start en end accepteren twee indelingen:

Indeling Voorbeeld Opmerkingen
yyyy-MM-dd 2026-06-13 Begindatum: middernacht; einddatum: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Expliciete tijd en tijdzone-offset

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 TCP-toolnamen get_* (werk de Node-bridge apart bij)

Tips

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

Hulp krijgen

Zie Hulp krijgen voor supportmeldingen en App-gebeurtenislogboeken voor diagnostische exporten.