Koble til server
Koble til Health Auto Export MCP-serveren for AI-klienter og skript på det lokale nettverket.
Sist oppdatert: 31. oktober 2026
På denne siden
HTTPS (TLS)
HTTPS (TLS) Aktivere HTTPSStole på CA-en på klienterEndringer i iOS LAN-IPEksempel på HTTPS-endepunktKlientkonfigurasjon
Klientkonfigurasjon Claude Code (CLI)Claude Code / prosjektfil (<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)MCP-serveren på iOS lar AI-klienter og skript på det lokale nettverket spørre helsedataene dine. HTTP (Streamable MCP) er den anbefalte transporten. iOS støtter også TCP for Node-bridge-oppsett.
Klienter kjører på Mac eller andre enheter på samme nettverk og kobler til endepunktet som vises på iPhone.
Oversikt
| Transport | Endepunkt |
|---|---|
| HTTP (anbefalt) | http://{LAN_IP}:9000/mcp (eller https:// når HTTPS er aktivert) |
| TCP | {LAN_IP}:9000 (uten autentisering) |
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 til helsedata på iPhone
- Bruk mcp-remote (iOS / LAN) for klienter som bare støtter stdio, for eksempel Claude Desktop
- Spør mål og treningsøkter fra skript på det lokale nettverket (HTTP)
- TCP-integrasjoner via Node-bridgen health-auto-export-mcp-server
Forutsetninger
- Health Auto Export på iPhone (appen må forbli i forgrunnen mens klienter er tilkoblet)
- Premiumabonnement
- HTTP: Bearer-token fra Server-skjermen
- Tillatelse for Lokalt nettverk på iPhone
- Klientenhet: Samme Wi‑Fi eller LAN som iPhone; Node.js bare hvis du bruker mcp-remote (iOS / LAN)
Starte serveren
- På iPhone åpner du Server fra fanen Eksporter. På iPad bruker du sidefeltet.
- Velg HTTP (anbefalt) eller TCP
- Aktiver valgfritt Bruk HTTPS (veiledning nedenfor)
- Trykk på Start server
- Kopier endepunkt-URL-en og bearer-tokenet
Den aktive serveren stoppes automatisk hvis Health Auto Export sendes til bakgrunnen, enten du bruker HTTP eller TCP.
Autentisering (HTTP)
Alle HTTP-forespørsler krever:
Authorization: Bearer <your-token>
- Generer tokenet på nytt fra Server-skjermen hvis det er nødvendig
- På vanlig HTTP sendes tokenet over en ukryptert tilkobling—bruk det bare på betrodde nettverk, eller aktiver HTTPS
- TCP legacy har ingen autentisering (uendret)
HTTPS (TLS)
HTTPS bruker en lokalt generert Certificate Authority (CA). Eksporter og stol på sertifikatet på hver klientenhet før du kobler til via https://.
Aktivere HTTPS
- Åpne visningen Server (iPhone: fanen Eksporter; iPad: sidefelt)
- Slå på Bruk HTTPS
- Trykk på Eksporter CA-sertifikat og bruk delingsarket for å sende via AirDrop eller lagre CA-filen på hver klientenhet
- Start serveren — sørg for at endepunkt-URL-en bytter til
https://
Stole på CA-en på klienter
Stol på den eksporterte CA-en på enheten som kjører AI-klienten (vanligvis Mac):
- Eksporter CA-en fra Server-skjermen på iPhone
- Åpne PEM-filen i Nøkkelringtilgang på klient-Mac
- Sett Tillit → Stol alltid på
Node-versjoner for det genererte oppsettet
Appens genererte Node-bridge-oppsett bruker NODE_OPTIONS=--use-system-ca for disse Node-versjonene:
| 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 angir du i stedet NODE_EXTRA_CA_CERTS til en PEM-sti som bridge-prosessen kan lese. Å sende --use-system-ca på Node som ikke støttes hindrer prosessen fra å starte.
Tillitsomfang:
--use-system-castoler på hele systemnøkkelringen, ikke bare denne appens CA.NODE_EXTRA_CA_CERTSlegger den eksporterte CA-en til Nodes betrodde sertifikater. Se Node-sertifikatalternativer.
| Klienttype | Oppsett |
|---|---|
| Cursor, VS Code, Claude Code, Codex | Nøkkelringtillit på klient-Mac — bruk https://-endepunktet fra Server-skjermen |
| mcp-remote (iOS / LAN) | Stol på CA i Nøkkelringtilgang på Mac som kjører mcp-remote. Snippet bruker NODE_OPTIONS=--use-system-ca når Node oppfyller minimumsversjonen; på eldre Node angir du 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 iOS LAN-IP
Kopier endepunkt-URL-en på nytt hvis iPhones nettverksadresse endres. Hvis et erstatnings-CA-sertifikat gis, eksporterer du det og oppdaterer tilliten på hver klientenhet.
Eksempel på HTTPS-endepunkt
https://192.168.1.42:9000/mcp
Erstatt verten med verdien som vises på Server-skjermen.
Kontraktversjon
| Versjon | TCP-verktøynavn | Merknader |
|---|---|---|
| v1.1.0 (standard) | get_* |
Anbefales for nye oppsett |
| v1.0.0 | Legacy (health_metrics, …) |
Claude Desktop-kompatibilitetsoppdatering v1.0.0 |
| v0.0.1 | Legacy | Eldste kompatibilitet |
HTTP bruker alltid verktøynavn get_*; kontraktversjonen påvirker bare skjemastandarder.
Klientkonfigurasjon
Server-skjermen inneholder copy-paste-snippets for hver integrasjon. Bruk endepunktet og tokenet som vises der. Verifiser formater mot klientversjonen din.
Alle eksemplene nedenfor bruker en midlertidig LAN-adresse—erstatt den med iPhones adresse fra Server-skjermen.
Claude Code (CLI)
Kjør på Mac (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 å ha eksportert CA-en og gitt den tillit på Mac):
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 direkte via Streamable HTTP — ingen Node.js-bridge kreves. Konfigurasjonen ligger i ~/.codex/config.toml (global) eller .codex/config.toml i en betrodd 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 konfigurasjon (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 før du starter Codex. Kjør etter oppsett /mcp inne i en Codex-økt for å bekrefte at serveren er tilkoblet.
Hvis du regenererer bearer-tokenet i Health Auto Export, oppdaterer du HAE_MCP_TOKEN og kjører codex mcp add på nytt, eller fjerner og legger til serveroppføringen på nytt.
mcp-remote (iOS / LAN)
For klienter som bare støtter stdio (for eksempel Claude Desktop), som ikke kan koble direkte via HTTP. Krever Node.js på Mac som kjører klienten.
- Start serveren på iPhone og kopier endepunktet og tokenet
- Velg på Mac mcp-remote (iOS / LAN) på Server-skjermen og kopier JSON-snippetet, eller lim inn dette i klientens MCP-konfigurasjon (Claude Desktop → Innstillinger → Utvikler → Rediger konfigurasjon):
{
"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:
- Eksporter CA-en fra iPhone og stol på den i Nøkkelringtilgang (Stol alltid på) på Mac
- Bruk
https://192.168.1.42:9000/mcpiargs - For Node-versjoner som støttes av det genererte oppsettet ovenfor legger du til dette
env-objektet i samme serverkonfigurasjonsobjekt:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
På eldre Node angir du i stedet NODE_EXTRA_CA_CERTS til en lesbar PEM-sti. Start stdio-klienten på nytt etter at du har oppdatert konfigurasjonen.
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, uautorisert JSON-RPC på port 9000
- Bruk kontrakt v1.0.0 med Node-bridgen
health-auto-export-mcp-serverfor legacy-verktøynavn - Bruk kontrakt v1.1.0 for TCP-verktøynavn
get_* (oppdater Node-bridgen separat)
Tips
- Hold Health Auto Export i forgrunnen på iPhone mens klienter er tilkoblet
- Generer tokenet på nytt hvis du mistenker at det er eksponert
- Kopier endepunkt-URL-en på nytt etter at iPhones LAN-IP endres
Få hjelp
Se Få hjelp for supportinnsendinger og App-hendelseslogger for diagnostiske eksporter.