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
HTTPS (TLS)
HTTPS (TLS) HTTPS inschakelenDe CA op clients vertrouwenWijzigingen in iOS LAN-IPVoorbeeld HTTPS-eindpuntClientconfiguratie
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)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
- Open op iPhone Server vanaf het tabblad Exporteren. Op iPad gebruik je de zijbalk.
- Kies HTTP (aanbevolen) of TCP
- Schakel optioneel Gebruik HTTPS in (instructies hieronder)
- Tik op Start server
- 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
- Open de weergave Server (iPhone: tabblad Exporteren; iPad: zijbalk)
- Schakel Gebruik HTTPS in
- Tik op CA-certificaat exporteren en gebruik het deelblad om het CA-bestand via AirDrop of opslaan op elk clientapparaat te zetten
- 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):
- Exporteer de CA vanaf het Server-scherm op iPhone
- Open de PEM in Sleutelhangertoegang op de client-Mac
- 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-cavertrouwt de volledige systeemsleutelhanger, niet alleen de CA van deze app.NODE_EXTRA_CA_CERTSvoegt 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.
- Start de server op iPhone en kopieer het eindpunt en token
- 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:
- Exporteer de CA vanaf iPhone en vertrouw deze in Sleutelhangertoegang (Altijd vertrouwen) op je Mac
- Gebruik
https://192.168.1.42:9000/mcpinargs - 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-servervoor legacy-toolnamen - Gebruik contract v1.1.0 voor TCP-toolnamen
get_* (werk de Node-bridge apart bij)
Tips
- Houd Health Auto Export op de voorgrond op iPhone terwijl clients zijn verbonden
- Genereer het token opnieuw als je vermoedt dat het is blootgesteld
- 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.