Hjälpcenter HealthyApps
Svenska
Hjälpcenter
Huvudwebbplats ↗

Sök bland hjälpämnen

Anslut till server

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

Senast uppdaterad: 31 oktober 2026

På denna sida
ÖversiktFörutsättningarStarta servernAutentisering (HTTP)
HTTPS (TLS) HTTPS (TLS) Aktivera HTTPSLita på CA:n på klienterÄndringar i iOS LAN-IPExempel på HTTPS-slutpunkt
Kontraktversion
Klientkonfiguration Klientkonfiguration Claude Code (CLI)Claude Code / projektfil (<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)
Verktygsargument Verktygsargument Datumformat
TCPTipsFå hjälp

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

Klienter körs på din Mac eller andra enheter på 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 (utan autentisering)

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

Användningsområden:

  • 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 bara stöder stdio, såsom Claude Desktop
  • Fråga mått och träningspass från skript på ditt lokala nätverk (HTTP)
  • TCP-integrationer via Node-bridge health-auto-export-mcp-server

Förutsättningar

  • Health Auto Export på iPhone (appen måste förbli i förgrunden medan klienter är anslutna)
  • Premiumabonnemang
  • HTTP: Bearer-token från Server-skärmen
  • Behörighet för Lokalt nätverk på iPhone
  • Klientenhet: Samma Wi‑Fi eller LAN som iPhone; Node.js bara om du använder mcp-remote (iOS / LAN)

Starta servern

  1. Öppna på iPhone Server från fliken Exportera. På iPad använder du sidofältet.
  2. Välj HTTP (rekommenderas) eller TCP
  3. Aktivera valfritt Använd HTTPS (guide nedan)
  4. Tryck på Starta server
  5. Kopiera slutpunkts-URL:en och bearer-tokenet

Den aktiva servern stoppas automatiskt om Health Auto Export skickas till bakgrunden, oavsett om du använder HTTP eller TCP.

Autentisering (HTTP)

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

Authorization: Bearer <your-token>
  • Generera tokenet igen från Server-skärmen om det behövs
  • På vanlig HTTP skickas tokenet över en okrypterad anslutning—använd det bara på betrodda nätverk, eller aktivera HTTPS
  • TCP legacy har ingen autentisering (oförändrat)

HTTPS (TLS)

HTTPS använder en lokalt genererad Certificate Authority (CA). Exportera och lita på dess certifikat på varje klientenhet innan du ansluter via https://.

Aktivera HTTPS

  1. Öppna vyn Server (iPhone: fliken Exportera; iPad: sidofält)
  2. Slå på Använd HTTPS
  3. Tryck på Exportera CA-certifikat och använd delningsbladet för att AirDrop:a eller spara CA-filen på varje klientenhet
  4. Starta servern — se till att slutpunkts-URL:en byter 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 Server-skärmen på iPhone
  2. Öppna PEM-filen i Nyckelhanterare på klient-Mac
  3. Ställ in Tillit → Lita alltid på

Node-versioner för den genererade konfigurationen

Appens genererade Node-bridge-konfiguration använder NODE_OPTIONS=--use-system-ca för dessa Node-versioner:

Node-linje Minimiversion
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ vilken som helst

På äldre Node anger du i stället NODE_EXTRA_CA_CERTS till en PEM-sökväg som bridge-processen kan läsa. Att skicka --use-system-ca på icke stödd Node hindrar processen från att starta.

Tillitsomfattning: --use-system-ca litar på hela systemnyckelringen, inte bara den här appens CA. NODE_EXTRA_CA_CERTS lägger till den exporterade CA:n till Nodes betrodda certifikat. Se Node-certifikatinställningar.

Klienttyp Konfiguration
Cursor, VS Code, Claude Code, Codex Nyckelringstillit på klient-Mac — använd https://-slutpunkten från Server-skärmen
mcp-remote (iOS / LAN) Lita på CA i Nyckelhanterare på den Mac som kör mcp-remote. Snippet använder NODE_OPTIONS=--use-system-ca när Node uppfyller minimiversionen; på äldre Node anger du NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg
curl / skript Skicka --cacert /path/to/mcp-ca.pem, eller ange NODE_EXTRA_CA_CERTS

CA-fingeravtrycket visas på Server-skärmen så att du kan bekräfta att du exporterade rätt certifikat.

Ändringar i iOS LAN-IP

Kopiera slutpunkts-URL:en igen om din iPhones nätverksadress ändras. Om ett ersättnings-CA-certifikat tillhandahålls exporterar du det och uppdaterar tilliten på varje klientenhet.

Exempel på HTTPS-slutpunkt

https://192.168.1.42:9000/mcp

Ersätt värden med det värde som visas på Server-skärmen.

Kontraktversion

Version TCP-verktygsnamn Anteckningar
v1.1.0 (standard) get_* Rekommenderas för nya konfigurationer
v1.0.0 Legacy (health_metrics, …) Claude Desktop-kompatibilitetsuppdatering v1.0.0
v0.0.1 Legacy Äldsta kompatibilitet

HTTP använder alltid verktygsnamn get_*; kontraktversionen påverkar bara schemastandarder.

Klientkonfiguration

Server-skärmen innehåller copy-paste-snippets för varje integration. Använd den slutpunkt och token som visas där. Verifiera format mot din klientversion.

Alla exempel nedan använder en tillfällig LAN-adress—ersätt den med din iPhones adress från Server-skärmen.

Claude Code (CLI)

Kör 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 ha exporterat CA:n och gett den tillit 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-bridge krävs. Konfigurationen ligger i ~/.codex/config.toml (global) eller .codex/config.toml i en betrodd projektmapp.

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 konfiguration (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 efter konfiguration /mcp inne i en Codex-session för att bekräfta att servern är ansluten.

Om du regenererar bearer-tokenet i Health Auto Export uppdaterar du HAE_MCP_TOKEN och kör codex mcp add igen, eller tar bort och lägger till serverposten igen.

mcp-remote (iOS / LAN)

För klienter som bara stöder stdio (såsom Claude Desktop), 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 tokenet
  2. Välj på din Mac mcp-remote (iOS / LAN) på Server-skärmen och kopiera JSON-snippetet, eller klistra in detta i klientens MCP-konfiguration (Claude Desktop → Inställningar → Utvecklare → Redigera konfiguration):
{
  "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 Nyckelhanterare (Lita alltid på) på din Mac
  2. Använd https://192.168.1.42:9000/mcp i args
  3. För Node-versioner som stöds av den genererade konfigurationen ovan lägger du till detta env-objekt i samma serverkonfigurationsobjekt:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

På äldre Node anger du i stället NODE_EXTRA_CA_CERTS till en läsbar PEM-sökväg. Starta om stdio-klienten efter att ha uppdaterat konfigurationen.

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, oauktoriserad JSON-RPC på port 9000
  • Använd kontrakt v1.0.0 med Node-bridgen health-auto-export-mcp-server för legacy-verktygsnamn
  • Använd kontrakt v1.1.0 för TCP-verktygsnamn get_* (uppdatera Node-bridgen separat)

Tips

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

Få hjälp

Se Få hjälp för supportinskick och App-händelseloggar för diagnostiska exporter.