Průvodce připojením k serveru

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

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

Přehled

Transport	Endpoint
HTTP (doporučeno)	http://{LAN_IP}:9000/mcp (nebo https://, pokud je aktivováno HTTPS)
TCP	{LAN_IP}:9000 (bez autentizace)

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

Případy použití:

• Připojení Claude Code, Codex, Cursoru nebo VS Code na Macu ke zdravotním datům na iPhonu
• Použití mcp-remote (iOS / LAN) pro klienty, kteří umí jen stdio, jako Claude Desktop
• Dotazování na metriky a tréninky ze skriptů ve vaší místní síti (HTTP)
• TCP integrace prostřednictvím Node můstku health-auto-export-mcp-server

Předpoklady

• Health Auto Export na iPhonu (aplikace musí zůstat v popředí, dokud 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 místní síť jako iPhone; Node.js pouze pokud používáte mcp-remote (iOS / LAN)

Spuštění serveru

1. Na iPhonu otevřete Server z navigace v postranním panelu
2. Zvolte HTTP (doporučeno) nebo TCP
3. Volitelně aktivujte Použít HTTPS (instrukce níže)
4. Klepněte na Spustit server
5. Zkopírujte URL endpointu a Bearer token

Server se automaticky zastaví, pokud je Health Auto Export přesunut na pozadí (u HTTP i TCP).

Autentizace (HTTP)

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

Authorization: Bearer <váš-token>

• Token na obrazovce Server znovu vygenerujte, pokud to považujete za nutné
• Přes prosté HTTP se token odesílá nešifrovaným spojením — používejte jen v důvěryhodných sítích, nebo aktivujte HTTPS
• Starší TCP nemá žádnou autentizaci (beze změny)

HTTPS (TLS)

Když je aktivováno Použít HTTPS, aplikace vygeneruje soukromou lokální certifikační autoritu (CA) a certifikát serveru podepsaný touto CA. Klienti musí této exportované CA důvěřovat, aby se mohli připojit přes https://.

Aktivace HTTPS

1. Otevřete zobrazení Server z navigace v postranním panelu
2. Zapněte Použít HTTPS
3. Klepněte na Exportovat certifikát CA a přes nabídku sdílení jej odešlete přes AirDrop nebo uložte na každé klientské zařízení
4. Spusťte server; ověřte, že se URL endpointu změní na https://

Důvěra v CA na klientech

Nastavte důvěru 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 aplikaci Přístup ke klíčence na klientském Macu
3. Nastavte Trust → Always Trust

Minimální verze Node pro --use-system-ca

Node můstky (mcp-remote) mohou použít NODE_OPTIONS=--use-system-ca pouze pokud Node splňuje:

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

Na starších verzích Node nastavte NODE_EXTRA_CA_CERTS na cestu k PEM souboru, který proces můstku umí přečíst. Použití --use-system-ca na nepodporované verzi 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 omezuje důvěru na jediný PEM soubor (alternativa na starších verzích Node). Přepínač je dokumentován pro macOS/Windows.

Typ klienta	Konfigurace
Cursor, VS Code, Claude Code, Codex	Důvěra v klíčence na klientském Macu — použijte endpoint https:// z obrazovky Server
mcp-remote (iOS / LAN)	Nastavte důvěru CA v klíčence na Macu, na kterém běží mcp-remote. Ukázka použije NODE_OPTIONS=--use-system-ca, pokud Node splňuje minimální verzi; na starších verzích nastavte NODE_EXTRA_CA_CERTS na čitelnou cestu k PEM
curl / skripty	Předejte --cacert /cesta/k/mcp-ca.pem nebo nastavte NODE_EXTRA_CA_CERTS

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

Změny LAN IP na iOS

Když se změní IP adresa vašeho iPhonu v místní síti, aplikace znovu vygeneruje koncový certifikát s aktualizovanými Subject Alternative Names a restartuje HTTPS listener. Pokud se IP adresa změnila, znovu zkopírujte URL endpointu. Certifikát CA zůstává stejný, pokud jej nezregenerujete vypnutím a zapnutím HTTPS.

Příklad HTTPS endpointu

https://192.168.1.42:9000/mcp

Nahraďte hostitele hodnotou zobrazenou na obrazovce Server.

Verze kontraktu

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

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

Konfigurace klienta

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

Všechny níže uvedené příklady používají ukázkovou LAN adresu — nahraďte ji adresou svého iPhonu z obrazovky Server.

Claude Code (CLI)

Spusťte na svém Macu (vyžaduje CLI Claude Code):

HTTP:

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

HTTPS (po exportu a nastavení důvěry v CA na Macu):

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

Claude Code / soubor projektu (.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 můstek není potřeba. Konfigurace se nachází v ~/.codex/config.toml (globální) nebo v .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í 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 v relaci Codexu /mcp a ověřte, ž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, kteří umí jen stdio (jako Claude Desktop) a nemohou se připojit přímo přes HTTP. Vyžaduje Node.js na Macu, na kterém běží klient.

1. Spusťte server na iPhonu a zkopírujte endpoint a token
2. Na svém Macu vyberte na obrazovce Server mcp-remote (iOS / LAN) a zkopírujte JSON úryvek, nebo jej vložte do konfigurace MCP 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 aktivováno:

1. Exportujte CA z iPhonu a nastavte její důvěru v Přístupu ke klíčence (Always Trust) na svém Macu
2. Použijte https://192.168.1.42:9000/mcp v args
3. Pokud Node splňuje minimální verzi pro --use-system-ca (22.19.0 na 22.x, 23.8.0 na 23.x, 24.6.0 na 24.x, nebo jakákoli verze 25+), přidejte:

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

Na starších verzích Node nastavte NODE_EXTRA_CA_CERTS na čitelnou cestu k PEM. Po aktualizaci konfigurace restartujte stdio klienta.

Snížení latence při startu: npx -y stáhne mcp-remote při prvním použití a znovu kontroluje po vypršení cache, což může způsobit několikasekundové zpoždění. Instalace globálně toto eliminuje:

npm install -g mcp-remote@0.1.16

Argumenty nástrojů

Formáty data

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

Formát	Příklad	Poznámky
yyyy-MM-dd	2026-06-13	Počáteční datum: půlnoc; koncové datum: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Explicitní čas a časové pásmo

TCP

• Nešifrovaný, neautentizovaný JSON-RPC na portu 9000
• Pro starší názvy nástrojů použijte kontrakt v1.0.0 s Node můstkem health-auto-export-mcp-server
• Pro TCP názvy nástrojů get_* použijte kontrakt v1.1.0 (Node můstek aktualizujte samostatně)

Tipy

1. Držte Health Auto Export na iPhonu v popředí, dokud jsou klienti připojeni
2. Pokud máte podezření, že token unikl, znovu jej vygenerujte
3. Po změně LAN IP vašeho iPhonu znovu zkopírujte URL endpointu

Podpora přes chat

Získejte diagnostiku z protokolů událostí aplikace v Nastavení → Pokročilé → Exportovat protokoly událostí. Viz Průvodce protokoly událostí aplikace. Vygenerovaný soubor zip sdílejte přes chatovou podporu nebo e-mailem.