Připojení k serveru

MCP Server na iOS umožňuje AI klientům a skriptům ve vaší místní síti dotazovat se na vaše zdravotní data. HTTP (Streamable MCP) je doporučený transport. iOS také podporuje TCP pro nastavení Node bridge.

Klienti běží na vašem Macu nebo jiných zařízeních ve stejné síti a připojují se ke koncovému bodu zobrazenému na iPhonu.

Přehled

Transport	Koncový bod
HTTP (doporučeno)	http://{LAN_IP}:9000/mcp (nebo https://, když je HTTPS zapnuté)
TCP	{LAN_IP}:9000 (bez autentizace)

Nahraďte {LAN_IP} adresou zobrazenou na obrazovce Server, zatímco server běží.

Případy použití:

• Připojte Claude Code, Codex, Cursor nebo VS Code na Macu ke zdravotním datům na iPhonu
• Použijte mcp-remote (iOS / LAN) pro klienty pouze se stdio, například Claude Desktop
• Dotazujte metriky a tréninky ze skriptů ve vaší místní síti (HTTP)
• Integrace TCP přes Node bridge health-auto-export-mcp-server

Předpoklady

• Health Auto Export na iPhonu (aplikace musí zůstat v popředí, zatímco jsou klienti připojeni)
• Předplatné Premium
• HTTP: Bearer token z obrazovky Server
• Oprávnění Místní síť na iPhonu
• Klientské zařízení: Stejné Wi‑Fi nebo LAN jako iPhone; Node.js pouze pokud používáte mcp-remote (iOS / LAN)

Spuštění serveru

1. Na iPhonu otevřete Server z karty Export. Na iPadu použijte postranní panel.
2. Zvolte HTTP (doporučeno) nebo TCP
3. Volitelně povolte Použít HTTPS (pokyny níže)
4. Klepněte na Spustit server
5. Zkopírujte URL koncového bodu a bearer token

Aktivní server se automaticky zastaví, pokud je Health Auto Export přesunut na pozadí, ať používáte HTTP nebo TCP.

Autentizace (HTTP)

Všechny HTTP požadavky vyžadují:

Authorization: Bearer <your-token>

• V případě potřeby znovu vygenerujte token z obrazovky Server
• Na prostém HTTP se token odesílá přes nešifrované připojení — používejte pouze v důvěryhodných sítích, nebo povolte HTTPS
• Legacy TCP nemá žádnou autentizaci (beze změny)

HTTPS (TLS)

HTTPS používá lokálně generovanou Certifikační autoritu (CA). Před připojením přes https:// exportujte a důvěřujte jejímu certifikátu na každém klientském zařízení.

Povolení HTTPS

1. Otevřete zobrazení Server (iPhone: karta Export; iPad: postranní panel)
2. Zapněte Použít HTTPS
3. Klepněte na Exportovat CA certifikát a pomocí sdílení AirDropem nebo uložením přeneste soubor CA na každé klientské zařízení
4. Spusťte server — ujistěte se, že URL koncového bodu přepne na https://

Důvěra CA na klientech

Důvěřujte exportované CA na zařízení, na kterém běží AI klient (obvykle váš Mac):

1. Exportujte CA z obrazovky Server na iPhonu
2. Otevřete PEM v Klíčence na klientském Macu
3. Nastavte Důvěra → Vždy důvěřovat

Verze Node pro generované nastavení

Generované nastavení Node bridge v aplikaci používá NODE_OPTIONS=--use-system-ca pro tyto verze Node:

Řada Node	Minimální verze
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	any

Na starším Node místo toho nastavte NODE_EXTRA_CA_CERTS na cestu PEM, kterou proces bridge dokáže číst. Emise --use-system-ca na nepodporovaném Node zabrání spuštění procesu.

Rozsah důvěry: --use-system-ca důvěřuje celé systémové Klíčence, nejen CA této aplikace. NODE_EXTRA_CA_CERTS přidává exportovanou CA k důvěryhodným certifikátům Node. Viz Node certificate options.

Typ klienta	Nastavení
Cursor, VS Code, Claude Code, Codex	Důvěra v Klíčence na klientském Macu — použijte koncový bod https:// z obrazovky Server
mcp-remote (iOS / LAN)	Důvěřujte CA v Klíčence na Macu spouštějícím mcp-remote. Úryvek používá NODE_OPTIONS=--use-system-ca, když Node splňuje minimální verzi; na starším Node nastavte NODE_EXTRA_CA_CERTS na čitelnou cestu PEM
curl / skripty	Předávejte --cacert /path/to/mcp-ca.pem nebo nastavte NODE_EXTRA_CA_CERTS

Otisk CA je zobrazen na obrazovce Server, abyste mohli ověřit, že jste exportovali správný certifikát.

Změny LAN IP na iOS

Pokud se síťová adresa iPhonu změní, znovu zkopírujte URL koncového bodu. Pokud je poskytnut náhradní certifikát CA, exportujte jej a aktualizujte důvěru na každém klientském zařízení.

Příklad koncového bodu HTTPS

https://192.168.1.42:9000/mcp

Nahraďte hostitele hodnotou zobrazenou na obrazovce Server.

Verze smlouvy

Verze	Názvy nástrojů TCP	Poznámky
v1.1.0 (výchozí)	get_*	Doporučeno pro nová nastavení
v1.0.0	Legacy (health_metrics, …)	Aktualizace kompatibility Claude Desktop v1.0.0
v0.0.1	Legacy	Nejstarší kompatibilita

HTTP vždy používá názvy nástrojů get_*; verze smlouvy ovlivňuje pouze výchozí hodnoty schématu.

Konfigurace klienta

Obrazovka Server obsahuje úryvky ke kopírování pro každou integraci. Použijte koncový bod a token zobrazené tam. Formáty ověřte podle verze klienta.

Všechny příklady níže používají zástupnou LAN adresu — nahraďte ji adresou iPhonu z obrazovky Server.

Claude Code (CLI)

Spusťte 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 exportu a důvěře 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ý soubor (.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 se připojuje přímo přes Streamable HTTP — Node.js bridge není vyžadován. Konfigurace žije v ~/.codex/config.toml (globální) nebo .codex/config.toml v důvěryhodném adresáři projektu.

CLI (doporučeno):

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ální konfigurace (config.toml):

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

Před spuštěním Codexu exportujte HAE_MCP_TOKEN s vaším bearer tokenem. Po nastavení spusťte /mcp uvnitř relace Codex pro ověření, že je server připojen.

Pokud v Health Auto Export znovu vygenerujete bearer token, aktualizujte HAE_MCP_TOKEN a znovu spusťte codex mcp add, nebo odstraňte a znovu přidejte položku serveru.

mcp-remote (iOS / LAN)

Pro klienty pouze se stdio (například Claude Desktop), které se nemohou připojit přímo přes HTTP. Vyžaduje Node.js na Macu spouštějícím klienta.

1. Spusťte server na iPhonu a zkopírujte koncový bod a token
2. Na Macu vyberte mcp-remote (iOS / LAN) na obrazovce Server a zkopírujte JSON úryvek, nebo jej vložte do MCP konfigurace klienta (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>"
  ]
}

Když je HTTPS zapnuté:

1. Exportujte CA z iPhonu a důvěřujte jí v Klíčence (Vždy důvěřovat) na Macu
2. Použijte https://192.168.1.42:9000/mcp v args
3. Pro verze Node podporované generovaným nastavením výše přidejte tento objekt env do stejného objektu konfigurace serveru:

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

Na starším Node místo toho nastavte NODE_EXTRA_CA_CERTS na čitelnou cestu PEM. Po aktualizaci konfigurace restartujte stdio klienta.

Argumenty nástrojů

Formáty dat

Parametry start a end přijímají dva formáty:

Formát	Příklad	Poznámky
yyyy-MM-dd	2026-06-13	Datum začátku: půlnoc; datum konce: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Explicitní čas a offset časového pásma

TCP

• Nešifrované, neautentizované JSON-RPC na portu 9000
• Pro legacy názvy nástrojů použijte smlouvu v1.0.0 s Node bridge health-auto-export-mcp-server
• Pro názvy nástrojů TCP get_* použijte smlouvu v1.1.0 (aktualizujte Node bridge samostatně)

Tipy

1. Držte Health Auto Export v popředí na iPhonu, zatímco jsou klienti připojeni
2. Znovu vygenerujte token, pokud máte podezření, že byl odhalen
3. Po změně LAN IP iPhonu znovu zkopírujte URL koncového bodu

Získání pomoci

Pro odeslání podpory viz Získání pomoci a pro diagnostické exporty Protokoly událostí aplikace.