Pripojenie k serveru

MCP server na iOS umožňuje AI klientom a skriptom vo vašej lokálnej sieti dopytovať vaše zdravotné údaje. HTTP (streamovateľné MCP) je odporúčaný transport. iOS tiež podporuje TCP pre nastavenia s mostom Node.

Klienti bežia na Macu alebo iných zariadeniach v tej istej sieti a pripájajú sa ku koncovému bodu zobrazenému na iPhone.

Prehľad

Transport	Koncový bod
HTTP (odporúčané)	http://{LAN_IP}:9000/mcp (alebo https://, keď je zapnuté HTTPS)
TCP	{LAN_IP}:9000 (bez overenia)

Nahraďte {LAN_IP} adresou zobrazenou na obrazovke Server, kým server beží.

Scenáre použitia:

• Pripojenie Claude Code, Codex, Cursor alebo VS Code na Macu k zdravotným údajom na iPhone
• Použitie mcp-remote (iOS / LAN) pre klientov len so stdio, napríklad Claude Desktop
• Dopytovanie metrík a tréningov zo skriptov vo vašej lokálnej sieti (HTTP)
• TCP integrácie cez Node most health-auto-export-mcp-server

Predpoklady

• Health Auto Export na iPhone (aplikácia musí zostať v popredí, kým sú klienti pripojení)
• Predplatné Premium
• HTTP: Bearer token z obrazovky Server
• Povolenie Lokálna sieť na iPhone
• Klientské zariadenie: Rovnaká Wi‑Fi alebo LAN ako iPhone; Node.js len ak používate mcp-remote (iOS / LAN)

Spustenie servera

1. Na iPhone otvorte Server z karty Export. Na iPade použite bočný panel.
2. Zvoľte HTTP (odporúčané) alebo TCP
3. Voliteľne zapnite Použiť HTTPS (pokyny nižšie)
4. Klepnite na Spustiť server
5. Skopírujte URL koncového bodu a bearer token

Aktívny server sa automaticky zastaví, ak Health Auto Export prejde na pozadie, či už používate HTTP alebo TCP.

Overenie (HTTP)

Všetky HTTP požiadavky vyžadujú:

Authorization: Bearer <your-token>

• Token podľa potreby regenerujte z obrazovky Server
• Na bežnom HTTP sa token odosiela cez nešifrované pripojenie—používajte len na dôveryhodných sieťach, alebo zapnite HTTPS
• Legacy TCP nemá overenie (nezmenené)

HTTPS (TLS)

HTTPS používa lokálne generovanú certifikačnú autoritu (CA). Pred pripojením cez https:// exportujte a dôverujte jej certifikátu na každom klientskom zariadení.

Zapnutie HTTPS

1. Otvorte pohľad Server (iPhone: karta Export; iPad: bočný panel)
2. Zapnite Použiť HTTPS
3. Klepnite na Exportovať CA certifikát a použite hárok zdieľania na AirDrop alebo uloženie CA súboru na každé klientské zariadenie
4. Spustite server — uistite sa, že URL koncového bodu sa prepne na https://

Dôvera CA na klientoch

Dôverujte exportovanej CA na zariadení, na ktorom beží AI klient (zvyčajne váš Mac):

1. Exportujte CA z obrazovky Server na iPhone
2. Otvorte PEM v Prístupe ku kľúčenke na klientskom Macu
3. Nastavte Dôvera → Vždy dôverovať

Verzie Node pre generované nastavenie

Generované nastavenie Node mosta aplikácie používa NODE_OPTIONS=--use-system-ca pre tieto verzie Node:

Rada Node	Minimálna verzia
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	ľubovoľná

Na staršom Node nastavte NODE_EXTRA_CA_CERTS na cestu PEM, ktorú proces mosta dokáže čítať. Vydanie --use-system-ca na nepodporovanom Node zabráni spusteniu procesu.

Rozsah dôvery: --use-system-ca dôveruje celej systémovej kľúčenke, nielen CA tejto aplikácie. NODE_EXTRA_CA_CERTS pridá exportovanú CA k dôveryhodným certifikátom Node. Pozrite možnosti certifikátov Node.

Typ klienta	Nastavenie
Cursor, VS Code, Claude Code, Codex	Dôvera v kľúčenke na klientskom Macu — použite koncový bod https:// z obrazovky Server
mcp-remote (iOS / LAN)	Dôverujte CA v kľúčenke na Macu, na ktorom beží mcp-remote. Úryvok používa NODE_OPTIONS=--use-system-ca, keď Node spĺňa minimálnu verziu; na staršom Node nastavte NODE_EXTRA_CA_CERTS na čitateľnú cestu PEM
curl / skripty	Odovzdajte --cacert /path/to/mcp-ca.pem alebo nastavte NODE_EXTRA_CA_CERTS

Odtlačok CA je zobrazený na obrazovke Server, aby ste overili, že ste exportovali správny certifikát.

Zmeny LAN IP na iOS

Ak sa zmení sieťová adresa iPhonu, znova skopírujte URL koncového bodu. Ak je poskytnutý náhradný CA certifikát, exportujte ho a aktualizujte dôveru na každom klientskom zariadení.

Príklad HTTPS koncového bodu

https://192.168.1.42:9000/mcp

Nahraďte hostiteľa hodnotou zobrazenou na obrazovke Server.

Verzia kontraktu

Verzia	Názvy nástrojov TCP	Poznámky
v1.1.0 (predvolené)	get_*	Odporúčané pre nové nastavenia
v1.0.0	Legacy (health_metrics, …)	Aktualizácia kompatibility Claude Desktop v1.0.0
v0.0.1	Legacy	Najstaršia kompatibilita

HTTP vždy používa názvy nástrojov get_*; verzia kontraktu ovplyvňuje len predvolené hodnoty schémy.

Konfigurácia klienta

Obrazovka Server obsahuje úryvky na kopírovanie a vloženie pre každú integráciu. Použite koncový bod a token zobrazené tam. Overte formáty podľa verzie klienta.

Všetky príklady nižšie používajú zástupnú LAN adresu—nahraďte ju adresou vášho iPhonu z obrazovky Server.

Claude Code (CLI)

Spustite na Macu (vyžaduje Claude Code CLI):

HTTP:

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

HTTPS (po exportovaní a dôvere CA na Macu):

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

Claude Code / projektový súbor (.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 sa pripája priamo cez streamovateľné HTTP — most Node.js nie je potrebný. Konfigurácia je v ~/.codex/config.toml (globálna) alebo .codex/config.toml v dôveryhodnom projektovom adresári.

CLI (odporúčané):

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

Manuálna konfigurácia (config.toml):

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

Pred spustením Codexu exportujte HAE_MCP_TOKEN s vaším bearer tokenom. Po nastavení spustite /mcp v relácii Codex a overte, že je server pripojený.

Ak regenerujete bearer token v Health Auto Export, aktualizujte HAE_MCP_TOKEN a znova spustite codex mcp add, alebo odstráňte a znova pridajte položku servera.

mcp-remote (iOS / LAN)

Pre klientov len so stdio (napríklad Claude Desktop), ktoré sa nemôžu pripojiť priamo cez HTTP. Vyžaduje Node.js na Macu, na ktorom beží klient.

1. Spustite server na iPhone a skopírujte koncový bod a token
2. Na Macu vyberte mcp-remote (iOS / LAN) na obrazovke Server a skopírujte JSON úryvok, alebo ho vložte do MCP konfigurácie klienta (Claude Desktop → Nastavenia → 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>"
  ]
}

Keď je zapnuté HTTPS:

1. Exportujte CA z iPhonu a dôverujte jej v Prístupe ku kľúčenke (Vždy dôverovať) na Macu
2. Použite https://192.168.1.42:9000/mcp v args
3. Pre verzie Node podporované generovaným nastavením vyššie pridajte tento objekt env do toho istého objektu konfigurácie servera:

{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Na staršom Node nastavte NODE_EXTRA_CA_CERTS na čitateľnú cestu PEM. Po aktualizácii konfigurácie reštartujte stdio klienta.

Argumenty nástrojov

Formáty dátumov

Parametre start a end prijímajú dva formáty:

Formát	Príklad	Poznámky
yyyy-MM-dd	2026-06-13	Začiatočný dátum: polnoc; koncový dátum: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Explicitný čas a posun časového pásma

TCP

• Nešifrované, neoverené JSON-RPC na porte 9000
• Použite kontrakt v1.0.0 s Node mostom health-auto-export-mcp-server pre legacy názvy nástrojov
• Použite kontrakt v1.1.0 pre TCP názvy nástrojov get_* (aktualizujte Node most samostatne)

Tipy

1. Ponechajte Health Auto Export v popredí na iPhone, kým sú klienti pripojení
2. Regenerujte token, ak máte podozrenie, že bol vystavený
3. Po zmene LAN IP iPhonu znova skopírujte URL koncového bodu

Získanie pomoci

Pozrite Získanie pomoci pre odoslanie podpory a Denníky udalostí aplikácie pre diagnostické exporty.