Vodič za povezivanje s poslužiteljem

MCP poslužitelj na iOS-u omogućuje AI klijentima i skriptama na vašoj lokalnoj mreži postavljanje upita nad vašim zdravstvenim podacima. HTTP (Streamable MCP) je preporučeni transport. iOS također podržava TCP za konfiguracije s Node mostom.

Klijenti se izvode na vašem Macu ili drugim uređajima na istoj mreži i povezuju se s krajnjom točkom (endpoint) prikazanom na vašem iPhoneu.

Pregled

Transport	Krajnja točka
HTTP (preporučeno)	http://{LAN_IP}:9000/mcp (ili https:// kada je HTTPS omogućen)
TCP	{LAN_IP}:9000 (bez autentifikacije)

Zamijenite {LAN_IP} adresom prikazanom na zaslonu Poslužitelj dok poslužitelj radi.

Primjene:

• Povezivanje Claude Codea, Codexa, Cursora ili VS Codea na Macu sa zdravstvenim podacima na iPhoneu
• Korištenje mcp-remote (iOS / LAN) za klijente koji podržavaju samo stdio, kao Claude Desktop
• Postavljanje upita o metrikama i treninzima iz skripti na vašoj lokalnoj mreži (HTTP)
• TCP integracije putem Node mosta health-auto-export-mcp-server

Preduvjeti

• Health Auto Export na iPhoneu (aplikacija mora ostati u prvom planu dok su klijenti povezani)
• Premium pretplata
• HTTP: Bearer token sa zaslona Poslužitelj
• Dozvola Lokalna mreža na iPhoneu
• Klijentski uređaj: ista Wi‑Fi ili lokalna mreža kao iPhone; Node.js samo ako koristite mcp-remote (iOS / LAN)

Pokretanje poslužitelja

1. Na iPhoneu otvorite Poslužitelj putem navigacije u bočnoj traci
2. Odaberite HTTP (preporučeno) ili TCP
3. Po želji uključite Koristi HTTPS (upute u nastavku)
4. Dodirnite Pokreni poslužitelj
5. Kopirajte URL krajnje točke i Bearer token

Poslužitelj se automatski zaustavlja ako Health Auto Export ode u pozadinu (i za HTTP i za TCP).

Autentifikacija (HTTP)

Svi HTTP zahtjevi zahtijevaju:

Authorization: Bearer <vaš-token>

• Token po potrebi ponovno generirajte na zaslonu Poslužitelj
• Kod običnog HTTP-a token se šalje nešifriranom vezom — koristite samo na pouzdanim mrežama ili uključite HTTPS
• Stariji TCP nema autentifikaciju (nepromijenjeno)

HTTPS (TLS)

Kada je uključeno Koristi HTTPS, aplikacija generira privatno lokalno certifikacijsko tijelo (CA) i certifikat poslužitelja koji ono potpisuje. Klijenti se moraju pouzdati u izvezeni CA prije nego što se mogu povezati putem https://.

Omogućavanje HTTPS-a

1. Otvorite prikaz Poslužitelj putem navigacije u bočnoj traci
2. Uključite Koristi HTTPS
3. Dodirnite Izvezi CA certifikat i putem izbornika za deljenje ga poveži AirDropom ili spremite datoteku CA na svaki klijentski uređaj
4. Pokrenite poslužitelj — provjerite da se URL krajnje točke promijenio u https://

Pouzdanost CA na klijentima

Postavite pouzdanost izvezenog CA na uređaju na kojem se izvodi AI klijent (obično vaš Mac):

1. Izvezite CA sa zaslona Poslužitelj na iPhoneu
2. Otvorite PEM u aplikaciji Keychain Access na klijentskom Macu
3. Postavite Trust → Always Trust

Minimalna verzija Node-a za --use-system-ca

Node mostovi (mcp-remote) mogu koristiti NODE_OPTIONS=--use-system-ca samo kada Node zadovoljava:

Linija Node-a	Minimalna verzija
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	bilo koja

Na starijim verzijama Node-a postavite NODE_EXTRA_CA_CERTS na putanju do PEM datoteke koju proces mosta može pročitati. Korištenje --use-system-ca na nepodržanoj verziji Node-a spriječit će pokretanje procesa.

Opseg pouzdanosti: --use-system-ca pouzdaje se u cijeli sustavski Keychain, a ne samo u CA ove aplikacije. NODE_EXTRA_CA_CERTS ograničava pouzdanost na jednu PEM datoteku (alternativa na starijim verzijama Node-a). Ova zastavica dokumentirana je za macOS/Windows.

Vrsta klijenta	Postavljanje
Cursor, VS Code, Claude Code, Codex	Pouzdanost u Keychainu na klijentskom Macu — koristite endpoint https:// sa zaslona Poslužitelj
mcp-remote (iOS / LAN)	Postavite pouzdanost CA u Keychainu na Macu na kojem se izvodi mcp-remote. Isječak koristi NODE_OPTIONS=--use-system-ca kada Node zadovoljava minimalnu verziju; na starijim verzijama postavite NODE_EXTRA_CA_CERTS na čitljivu putanju do PEM-a
curl / skripte	Proslijedite --cacert /putanja/do/mcp-ca.pem ili postavite NODE_EXTRA_CA_CERTS

Otisak CA prikazuje se na zaslonu Poslužitelj kako biste mogli provjeriti da ste izvezli ispravan certifikat.

Promjene LAN IP adrese na iOS-u

Kada se LAN IP adresa vašeg iPhonea promijeni, aplikacija ponovno generira krajnji certifikat s ažuriranim Subject Alternative Names i ponovno pokreće HTTPS listener. Ponovno kopirajte URL krajnje točke ako se IP adresa promijenila. Certifikat CA ostaje isti osim ako ga ponovno generirate isključivanjem i uključivanjem HTTPS-a.

Primjer HTTPS krajnje točke

https://192.168.1.42:9000/mcp

Zamijenite hosta vrijednošću prikazanom na zaslonu Poslužitelj.

Verzija ugovora

Verzija	Nazivi TCP alata	Napomene
v1.1.0 (zadano)	get_*	Preporučeno za nove postavke
v1.0.0	Naslijeđeno (health_metrics, …)	Ažuriranje kompatibilnosti v1.0.0 za Claude Desktop
v0.0.1	Naslijeđeno	Najstarije, zbog kompatibilnosti

HTTP uvijek koristi nazive alata get_*; verzija ugovora utječe samo na zadane vrijednosti sheme.

Konfiguracija klijenta

Zaslon Poslužitelj sadrži isječke za kopiranje i lijepljenje za svaku integraciju. Koristite krajnju točku i token prikazane tamo. Provjerite formate u odnosu na verziju vašeg klijenta.

Svi primjeri u nastavku koriste primjer LAN adrese — zamijenite je adresom vašeg iPhonea sa zaslona Poslužitelj.

Claude Code (CLI)

Pokrenite na svom Macu (zahtijeva Claude Code CLI):

HTTP:

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

HTTPS (nakon izvoza i postavljanja pouzdanosti CA na vašem Macu):

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

Claude Code / datoteka projekta (.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 povezuje izravno putem Streamable HTTP-a — Node.js most nije potreban. Konfiguracija se nalazi u ~/.codex/config.toml (globalno) ili u .codex/config.toml unutar pouzdanog direktorija projekta.

CLI (preporuč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

Ručni config.toml:

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

Izvezite HAE_MCP_TOKEN s vašim Bearer tokenom prije pokretanja Codexa. Nakon postavljanja pokrenite /mcp unutar sesije Codexa da biste provjerili je li poslužitelj povezan.

Ako ponovno generirate Bearer token u Health Auto Exportu, ažurirajte HAE_MCP_TOKEN i ponovno pokrenite codex mcp add, ili uklonite i ponovno dodajte unos poslužitelja.

mcp-remote (iOS / LAN)

Za klijente koji podržavaju samo stdio (kao Claude Desktop) i ne mogu se povezati izravno putem HTTP-a. Zahtijeva Node.js na Macu na kojem se izvodi klijent.

1. Pokrenite poslužitelj na iPhoneu i kopirajte krajnju točku i token
2. Na svom Macu odaberite mcp-remote (iOS / LAN) na zaslonu Poslužitelj i kopirajte JSON isječak, ili ga zalijepite u MCP konfiguraciju klijenta (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>"
  ]
}

Kada je HTTPS uključen:

1. Izvezite CA s iPhonea i postavite njegovu pouzdanost u Keychain Accessu (Always Trust) na svom Macu
2. Koristite https://192.168.1.42:9000/mcp u args
3. Kada Node zadovoljava minimalnu verziju za --use-system-ca (22.19.0 na 22.x, 23.8.0 na 23.x, 24.6.0 na 24.x, ili bilo koju verziju 25+), dodajte:

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

Na starijim verzijama Node-a postavite NODE_EXTRA_CA_CERTS na čitljivu putanju do PEM-a. Ponovno pokrenite stdio klijent nakon ažuriranja konfiguracije.

Smanjenje latencije pri pokretanju: npx -y preuzima mcp-remote prilikom prve upotrebe i ponovno provjerava kada predmemorija istekne, što može uzrokovati kašnjenja od nekoliko sekundi. Globalna instalacija ovo uklanja:

npm install -g mcp-remote@0.1.16

Argumenti alata

Formati datuma

Parametri start i end prihvaćaju dva formata:

Format	Primjer	Napomene
yyyy-MM-dd	2026-06-13	Početni datum: ponoć; krajnji datum: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Izričito vrijeme i pomak vremenske zone

TCP

• Nešifrirani, neautentificirani JSON-RPC na portu 9000
• Za naslijeđene nazive alata koristite ugovor v1.0.0 s Node mostom health-auto-export-mcp-server
• Za TCP nazive alata get_* koristite ugovor v1.1.0 (Node most ažurirajte odvojeno)

Savjeti

1. Držite Health Auto Export u prvom planu na iPhoneu dok su klijenti povezani
2. Ponovno generirajte token ako sumnjate da je izložen
3. Ponovno kopirajte URL krajnje točke nakon promjene LAN IP adrese vašeg iPhonea

Podrška putem chata

Prikupite dijagnostiku iz zapisa događaja aplikacije putem Postavke → Napredno → Izvezi zapise događaja. Pogledajte Vodič za zapise događaja aplikacije. Podijelite generiranu zip datoteku putem podrške u chatu ili e-poštom.