HealthyApps Help Center

Anslut till server

Anslut till Health Auto Export MCP-servern för AI-klienter och skript på ditt lokala nätverk.

Last updated: July 14, 2026

På denna sida

Guide för serveranslutning

MCP-servern på iOS låter AI-klienter och skript på ditt lokala nätverk fråga efter dina hälsodata. HTTP (Streamable MCP) är den rekommenderade transporten. iOS stöder även TCP för konfigurationer med Node-brygga.

Klienter körs på din Mac eller andra enheter i samma nätverk och ansluter till den slutpunkt som visas på din iPhone.

Översikt

Transport Slutpunkt
HTTP (rekommenderas) http://{LAN_IP}:9000/mcp (eller https:// när HTTPS är aktiverat)
TCP {LAN_IP}:9000 (ej autentiserad)

Ersätt {LAN_IP} med adressen som visas på skärmen Server medan servern körs.

Användningsfall:

  • Anslut Claude Code, Codex, Cursor eller VS Code på din Mac till hälsodata på din iPhone
  • Använd mcp-remote (iOS / LAN) för klienter som endast stöder stdio, som Claude Desktop
  • Fråga efter mätvärden och träningspass från skript på ditt lokala nätverk (HTTP)
  • TCP-integrationer via Node-bryggan health-auto-export-mcp-server

Förutsättningar

  • Health Auto Export på iPhone (appen måste vara i förgrunden medan klienter är anslutna)
  • Premium-prenumeration
  • HTTP: Bearer-token från servervyn
  • Lokalt nätverk-behörighet på iPhone
  • Klientenhet: samma Wi-Fi eller LAN som iPhone; Node.js krävs endast om du använder mcp-remote (iOS / LAN)

Starta servern

  1. Öppna Server på iPhone via navigeringen i sidofältet
  2. Välj HTTP (rekommenderas) eller TCP
  3. Aktivera eventuellt Använd HTTPS (instruktioner nedan)
  4. Tryck på Starta server
  5. Kopiera slutpunktens URL och Bearer-token

Servern stoppas automatiskt om Health Auto Export läggs i bakgrunden (både för HTTP och TCP).

Autentisering (HTTP)

Alla HTTP-förfrågningar kräver:

Authorization: Bearer <your-token>
  • Generera om token från servervyn om du anser det nödvändigt
  • Vid vanlig HTTP skickas token via en okrypterad anslutning — använd bara på betrodda nätverk, eller aktivera HTTPS
  • Äldre TCP har ingen autentisering (oförändrat)

HTTPS (TLS)

När Använd HTTPS är aktiverat genererar appen en privat lokal certifikatutfärdare (CA) och ett servercertifikat signerat av denna CA. Klienter måste lita på den exporterade CA:n innan de kan ansluta via https://.

Aktivera HTTPS

  1. Öppna vyn Server via navigeringen i sidofältet
  2. Aktivera Använd HTTPS
  3. Tryck på Exportera CA-certifikat och använd delningsmenyn för att skicka via AirDrop eller spara CA-filen på varje klientenhet
  4. Starta servern — kontrollera att slutpunktens URL växlar till https://

Lita på CA:n på klienter

Lita på den exporterade CA:n på den enhet som kör AI-klienten (vanligtvis din Mac):

  1. Exportera CA:n från servervyn på iPhone
  2. Öppna PEM-filen i Keychain Access på klient-Mac:en
  3. Ställ in Trust → Always Trust

Minsta Node-version för --use-system-ca

Node-bryggor (mcp-remote) får endast använda NODE_OPTIONS=--use-system-ca när Node uppfyller minst:

Node-linje Minsta version
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ valfri

På äldre Node-versioner, ställ istället in NODE_EXTRA_CA_CERTS till en PEM-sökväg som bryggprocessen kan läsa. Att använda --use-system-ca på en Node-version som inte stöds hindrar processen från att starta.

Förtroendeomfång: --use-system-ca litar på hela systemets Keychain, inte bara den här appens CA. NODE_EXTRA_CA_CERTS begränsar förtroendet till en enda PEM-fil (reservlösning på äldre Node). Flaggan är dokumenterad för macOS/Windows.

Klienttyp Konfiguration
Cursor, VS Code, Claude Code, Codex Keychain-förtroende på klient-Mac:en — använd https://-slutpunkten från servervyn
mcp-remote (iOS / LAN) Lita på CA:n i Keychain på den Mac som kör mcp-remote. Snippet använder NODE_OPTIONS=--use-system-ca när Node uppfyller miniminversionen; på äldre Node, ställ in NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg
curl / skript Skicka --cacert /path/to/mcp-ca.pem eller ställ in NODE_EXTRA_CA_CERTS

CA-fingeravtrycket visas på servervyn så att du kan verifiera att du exporterade rätt certifikat.

Ändringar av LAN-IP på iOS

När din iPhones LAN-IP ändras genererar appen om leaf-certifikatet med uppdaterade Subject Alternative Names och startar om HTTPS-lyssnaren. Kopiera slutpunktens URL igen om IP-adressen har ändrats. CA-certifikatet förblir detsamma om du inte genererar om det genom att stänga av och sätta på HTTPS igen.

Exempel på HTTPS-slutpunkt

https://192.168.1.42:9000/mcp

Ersätt värden med det värde som visas på servervyn.

Kontraktsversion

Version TCP-verktygsnamn Anteckningar
v1.1.0 (standard) get_* Rekommenderas för nya installationer
v1.0.0 Äldre (health_metrics, …) Kompatibilitetsuppdatering v1.0.0 för Claude Desktop
v0.0.1 Äldre Äldsta kompatibiliteten

HTTP använder alltid get_*-verktygsnamn; kontraktsversionen påverkar bara standardscheman.

Klientkonfiguration

Servervyn innehåller kopiera-och-klistra-in-snippets för varje integration. Använd slutpunkten och token som visas där. Kontrollera formaten mot din klientversion.

Alla exempel nedan använder en platshållar-LAN-adress — ersätt den med din iPhones adress från servervyn.

Claude Code (CLI)

Körs på din Mac (kräver Claude Code CLI):

HTTP:

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

HTTPS (efter att du exporterat och litat på CA:n på din Mac):

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

Claude Code / projektfil (.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 ansluter direkt via Streamable HTTP — ingen Node.js-brygga krävs. Konfigurationen finns i ~/.codex/config.toml (global) eller .codex/config.toml i en betrodd projektkatalog.

CLI (rekommenderas):

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 config.toml:

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

Exportera HAE_MCP_TOKEN med ditt Bearer-token innan du startar Codex. Kör /mcp i en Codex-session efter konfigurationen för att bekräfta att servern är ansluten.

Om du genererar om Bearer-token i Health Auto Export, uppdatera HAE_MCP_TOKEN och kör codex mcp add igen, eller ta bort och lägg till serverposten igen.

mcp-remote (iOS / LAN)

För klienter som endast stöder stdio (som Claude Desktop) och som inte kan ansluta direkt via HTTP. Kräver Node.js på den Mac som kör klienten.

  1. Starta servern på iPhone och kopiera slutpunkten och token
  2. Välj mcp-remote (iOS / LAN) på servervyn på din Mac och kopiera JSON-snippet, eller klistra in följande i klientens MCP-konfiguration (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>"
  ]
}

När HTTPS är aktiverat:

  1. Exportera CA:n från iPhone och lita på den i Keychain Access (Always Trust) på din Mac
  2. Använd https://192.168.1.42:9000/mcp i args
  3. När Node uppfyller miniminversionen för --use-system-ca (22.19.0 på 22.x, 23.8.0 på 23.x, 24.6.0 på 24.x, eller valfri 25+-version), lägg till:
"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

På äldre Node-versioner, ställ istället in NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg. Starta om stdio-klienten efter att konfigurationen har uppdaterats.

Minska startfördröjningen: npx -y laddar ner mcp-remote vid första användningen och kontrollerar igen när cachen upphör, vilket kan orsaka flersekundsfördröjningar. Att förinstallera det globalt eliminerar detta:

npm install -g mcp-remote@0.1.16

Verktygsargument

Datumformat

Parametrarna start och end accepterar två format:

Format Exempel Anteckningar
yyyy-MM-dd 2026-06-13 Startdatum: midnatt; slutdatum: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Explicit tid och tidszonsförskjutning

TCP

  • Okrypterad, oautentiserad JSON-RPC på port 9000
  • Använd kontrakt v1.0.0 med Node-bryggan health-auto-export-mcp-server för äldre verktygsnamn
  • Använd kontrakt v1.1.0 för get_*-TCP-verktygsnamn (uppdatera Node-bryggan separat)

Tips

  1. Håll Health Auto Export i förgrunden på iPhone medan klienter är anslutna
  2. Generera om token om du misstänker att det har exponerats
  3. Kopiera slutpunktens URL igen efter att din iPhones LAN-IP har ändrats

Chattsupport

Samla in diagnostik från appens händelseloggar genom att gå till Inställningar → Avancerat → Exportera händelseloggar. Se guiden för app-händelseloggar. Dela den genererade zip-filen via chattsupport eller e-post.