Hjelpsenter HealthyApps
Norsk Bokmål
Hjelpsenter
Hovednettsted ↗

Søk i hjelpeemner

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
OversiktForutsetningerStarte serverenAutentisering (HTTP)
HTTPS (TLS) HTTPS (TLS) Aktivere HTTPSStole på CA-en på klienterEndringer i iOS LAN-IPEksempel på HTTPS-endepunkt
Kontraktversjon
Klientkonfigurasjon 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)
Verktøyargumenter Verktøyargumenter Datoformater
TCPTipsFå hjelp

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

  1. På iPhone åpner du Server fra fanen Eksporter. På iPad bruker du sidefeltet.
  2. Velg HTTP (anbefalt) eller TCP
  3. Aktiver valgfritt Bruk HTTPS (veiledning nedenfor)
  4. Trykk på Start server
  5. 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

  1. Åpne visningen Server (iPhone: fanen Eksporter; iPad: sidefelt)
  2. Slå på Bruk HTTPS
  3. Trykk på Eksporter CA-sertifikat og bruk delingsarket for å sende via AirDrop eller lagre CA-filen på hver klientenhet
  4. 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):

  1. Eksporter CA-en fra Server-skjermen på iPhone
  2. Åpne PEM-filen i Nøkkelringtilgang på klient-Mac
  3. 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-ca stoler på hele systemnøkkelringen, ikke bare denne appens CA. NODE_EXTRA_CA_CERTS legger 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.

  1. Start serveren på iPhone og kopier endepunktet og tokenet
  2. 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:

  1. Eksporter CA-en fra iPhone og stol på den i Nøkkelringtilgang (Stol alltid på) på Mac
  2. Bruk https://192.168.1.42:9000/mcp i args
  3. 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-server for legacy-verktøynavn
  • Bruk kontrakt v1.1.0 for TCP-verktøynavn get_* (oppdater Node-bridgen separat)

Tips

  1. Hold Health Auto Export i forgrunnen på iPhone mens klienter er tilkoblet
  2. Generer tokenet på nytt hvis du mistenker at det er eksponert
  3. 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.