Príručka pripojenia k serveru

Server MCP na iOS umožňuje AI klientom a skriptom vo vašej lokálnej sieti dopytovať vaše zdravotné údaje. Odporúčaným transportom je HTTP (Streamable MCP). iOS podporuje aj TCP pre konfigurácie s Node mostíkom.

Klienti bežia na vašom Macu alebo iných zariadeniach v rovnakej sieti a pripájajú sa na endpoint zobrazený na vašom iPhone.

Prehľad

Transport	Endpoint
HTTP (odporúčané)	http://{LAN_IP}:9000/mcp (alebo https://, keď je aktivované HTTPS)
TCP	{LAN_IP}:9000 (bez autentifikácie)

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

Prípady použitia:

• Pripojenie Claude Code, Codex, Cursoru alebo VS Code na Macu k zdravotným údajom na iPhone
• Použitie mcp-remote (iOS / LAN) pre klientov, ktorí podporujú iba stdio, ako je Claude Desktop
• Dopytovanie metrík a tréningov zo skriptov vo vašej lokálnej sieti (HTTP)
• TCP integrácie prostredníctvom Node mostíka health-auto-export-mcp-server

Predpoklady

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

Spustenie servera

1. Na iPhone otvorte Server z navigácie v bočnom paneli
2. Vyberte HTTP (odporúčané) alebo TCP
3. Voliteľne aktivujte Použiť HTTPS (pokyny nižšie)
4. Ťuknite na Spustiť server
5. Skopírujte URL endpointu a Bearer token

Server sa automaticky zastaví, ak sa Health Auto Export presunie na pozadie (pri HTTP aj TCP).

Autentifikácia (HTTP)

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

Authorization: Bearer <váš-token>

• Token na obrazovke Server znova vygenerujte, ak to považujete za potrebné
• Cez bežné HTTP sa token odosiela nezašifrovaným spojením — používajte iba v dôveryhodných sieťach, alebo aktivujte HTTPS
• Staršie TCP nemá žiadnu autentifikáciu (bez zmeny)

HTTPS (TLS)

Keď je aktivované Použiť HTTPS, aplikácia vygeneruje súkromnú lokálnu certifikačnú autoritu (CA) a certifikát servera podpísaný touto CA. Klienti musia tejto exportovanej CA dôverovať, aby sa mohli pripojiť cez https://.

Aktivácia HTTPS

1. Otvorte zobrazenie Server z navigácie v bočnom paneli
2. Zapnite Použiť HTTPS
3. Ťuknite na Exportovať certifikát CA a použite ponuku zdieľania na odoslanie cez AirDrop alebo uloženie na každé klientske zariadenie
4. Spustite server; overte, že sa URL endpointu zmení na https://

Dôvera v CA na klientoch

Nastavte dôveru v exportovanú CA na zariadení, na ktorom beží AI klient (spravidla váš Mac):

1. Exportujte CA z obrazovky Server na iPhone
2. Otvorte PEM v aplikácii Prístup ku kľúčenke na klientskom Macu
3. Nastavte Trust → Always Trust

Minimálna verzia Node pre --use-system-ca

Node mostíky (mcp-remote) môžu použiť NODE_OPTIONS=--use-system-ca iba ak Node spĺňa:

Rad Node	Minimálna verzia
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	akákoľvek

Na starších verziách Node nastavte NODE_EXTRA_CA_CERTS na cestu k PEM súboru, ktorý proces mostíka vie prečítať. Použitie --use-system-ca na nepodporovanej verzii 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 obmedzuje dôveru na jediný PEM súbor (alternatíva na starších verziách Node). Príznak je dokumentovaný pre macOS/Windows.

Typ klienta	Konfigurácia
Cursor, VS Code, Claude Code, Codex	Dôvera v kľúčenke na klientskom Macu — použite endpoint https:// z obrazovky Server
mcp-remote (iOS / LAN)	Nastavte dôveru CA v kľúčenke na Macu, na ktorom beží mcp-remote. Ukážka použije NODE_OPTIONS=--use-system-ca, ak Node spĺňa minimálnu verziu; na starších verziách nastavte NODE_EXTRA_CA_CERTS na čitateľnú cestu k PEM
curl / skripty	Zadajte --cacert /cesta/k/mcp-ca.pem alebo nastavte NODE_EXTRA_CA_CERTS

Odtlačok CA sa zobrazuje na obrazovke Server, aby ste mohli overiť, že ste exportovali správny certifikát.

Zmeny LAN IP na iOS

Keď sa zmení IP adresa vášho iPhonu v lokálnej sieti, aplikácia znova vygeneruje koncový certifikát s aktualizovanými Subject Alternative Names a restartuje HTTPS listener. Ak sa IP adresa zmenila, znova skopírujte URL endpointu. Certifikát CA zostáva rovnaký, pokiaľ ho nezregenerujete vypnutím a zapnutím HTTPS.

Príklad HTTPS endpointu

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	Staršia (health_metrics, …)	Aktualizácia kompatibility v1.0.0 pre Claude Desktop
v0.0.1	Staršia	Najstaršia, pre kompatibilitu

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

Konfigurácia klienta

Obrazovka Server obsahuje úryvky na kopírovanie a vloženie pre každú integráciu. Použite endpoint a token zobrazené tam. Formáty overte podľa verzie svojho klienta.

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

Claude Code (CLI)

Spustite na svojom 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 exportovaní a nastavení dôvery 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 / súbor 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 sa pripája priamo cez Streamable HTTP — mostík Node.js nie je potrebný. Konfigurácia sa nachádza v ~/.codex/config.toml (globálna) alebo v .codex/config.toml v dôveryhodnom adresári projektu.

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álny 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 v relácii Codexu /mcp a overte, že je server pripojený.

Ak v Health Auto Export znova vygenerujete Bearer token, 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, ktorí podporujú iba stdio (ako Claude Desktop) a nemôžu sa pripojiť priamo cez HTTP. Vyžaduje Node.js na Macu, na ktorom beží klient.

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

Keď je HTTPS aktivované:

1. Exportujte CA z iPhonu a nastavte jej dôveru v Prístupe ku kľúčenke (Always Trust) na svojom Macu
2. Použite https://192.168.1.42:9000/mcp v args
3. Keď Node spĺňa minimálnu verziu pre --use-system-ca (22.19.0 na 22.x, 23.8.0 na 23.x, 24.6.0 na 24.x, alebo akákoľvek verzia 25+), pridajte:

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

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

Zníženie latencie pri spustení: npx -y stiahne mcp-remote pri prvom použití a znova kontroluje po vypršaní vyrovnávacej pamäte, čo môže spôsobiť niekoľkosekundové oneskorenia. Globálna inštalácia to eliminuje:

npm install -g mcp-remote@0.1.16

Argumenty nástrojov

Formáty dátumu

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

Formát	Príklad	Poznámky
yyyy-MM-dd	2026-06-13	Poč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 časové pásmo

TCP

• Nezašifrované, neautentifikované JSON-RPC na porte 9000
• Pre staršie názvy nástrojov použite kontrakt v1.0.0 s Node mostíkom health-auto-export-mcp-server
• Pre TCP názvy nástrojov get_* použite kontrakt v1.1.0 (Node mostík aktualizujte samostatne)

Tipy

1. Držte Health Auto Export na iPhone v popredí, kým sú klienti pripojení
2. Ak máte podozrenie, že token unikol, znova ho vygenerujte
3. Po zmene LAN IP vášho iPhonu znova skopírujte URL endpointu

Podpora cez chat

Získajte diagnostiku z protokolov udalostí aplikácie v Nastavenia → Pokročilé → Exportovať protokoly udalostí. Pozrite si Príručku protokolov udalostí aplikácie. Vygenerovaný súbor zip zdieľajte cez chatovú podporu alebo e-mailom.