Veza s poslužiteljem

MCP poslužitelj na iOS-u omogućuje AI klijentima i skriptama u vašoj lokalnoj mreži da upituju vaše zdravstvene podatke. HTTP (Streamable MCP) je preporučeni transport. iOS također podržava TCP za postavljanje Node mosta.

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

Pregled

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

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

Slučajevi uporabe:

• Povežite Claude Code, Codex, Cursor ili VS Code na Macu sa zdravstvenim podacima na iPhoneu
• Koristite mcp-remote (iOS / LAN) za klijente samo sa stdio, na primjer Claude Desktop
• Upitujte metrike i treninge iz skripti u vašoj lokalnoj mreži (HTTP)
• TCP integracija putem Node mosta health-auto-export-mcp-server

Preduvjeti

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

Pokretanje poslužitelja

1. Na iPhoneu otvorite Poslužitelj s kartice Izvoz. Na iPadu koristite bočnu traku.
2. Odaberite HTTP (preporučeno) ili TCP
3. Po želji omogućite Koristi HTTPS (upute ispod)
4. Dodirnite Pokreni poslužitelj
5. Kopirajte URL krajnje točke i bearer token

Aktivni poslužitelj automatski se zaustavlja ako se Health Auto Export premjesti u pozadinu, bilo da koristite HTTP ili TCP.

Autentifikacija (HTTP)

Svi HTTP zahtjevi zahtijevaju:

Authorization: Bearer <your-token>

• Po potrebi ponovno generirajte token sa zaslona Poslužitelj
• Na običnom HTTP-u token se šalje preko nešifrirane veze — koristite samo u pouzdanim mrežama ili omogućite HTTPS
• Legacy TCP nema nikakvu autentifikaciju (bez promjene)

HTTPS (TLS)

HTTPS koristi lokalno generirani certifikatni autoritet (CA). Prije povezivanja preko https:// izvezite i pouzdajte se u njegov certifikat na svakom klijentskom uređaju.

Omogućavanje HTTPS-a

1. Otvorite prikaz Poslužitelj (iPhone: kartica Izvoz; iPad: bočna traka)
2. Uključite Koristi HTTPS
3. Dodirnite Izvezi CA certifikat i pomoću dijeljenja AirDropom ili spremanjem prenijete CA datoteku na svaki klijentski uređaj
4. Pokrenite poslužitelj — provjerite da se URL krajnje točke prebaci na https://

Pouzdanje u CA na klijentima

Pouzdajte se u izvezeni CA na uređaju na kojem radi AI klijent (obično vaš Mac):

1. Izvezite CA sa zaslona Poslužitelj na iPhoneu
2. Otvorite PEM u Privjesku ključeva na klijentskom Macu
3. Postavite Pouzdanje → Uvijek pouzdaj

Verzije Node za generirano postavljanje

Generirano postavljanje Node mosta u aplikaciji koristi NODE_OPTIONS=--use-system-ca za ove verzije Node:

Serija Node	Minimalna verzija
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	any

Na starijem Nodeu umjesto toga postavite NODE_EXTRA_CA_CERTS na PEM putanju koju proces mosta može čitati. Izdavanje --use-system-ca na nepodržanom Nodeu spriječit će pokretanje procesa.

Opseg pouzdanja: --use-system-ca pouzdaje se u cijeli sustavski Privjesak ključeva, ne samo CA ove aplikacije. NODE_EXTRA_CA_CERTS dodaje izvezeni CA pouzdanim certifikatima Nodea. Pogledajte Node certificate options.

Tip klijenta	Postavljanje
Cursor, VS Code, Claude Code, Codex	Pouzdanje u Privjesku ključeva na klijentskom Macu — koristite krajnju točku https:// sa zaslona Poslužitelj
mcp-remote (iOS / LAN)	Pouzdajte se u CA u Privjesku ključeva na Macu koji pokreće mcp-remote. Isječak koristi NODE_OPTIONS=--use-system-ca kada Node ispunjava minimalnu verziju; na starijem Nodeu postavite NODE_EXTRA_CA_CERTS na čitljivu PEM putanju
curl / skripte	Proslijedite --cacert /path/to/mcp-ca.pem ili postavite NODE_EXTRA_CA_CERTS

Otisak CA prikazan je na zaslonu Poslužitelj kako biste mogli potvrditi da ste izvezli ispravan certifikat.

Promjene LAN IP-a na iOS-u

Ako se mrežna adresa iPhonea promijeni, ponovno kopirajte URL krajnje točke. Ako je izdan zamjenski CA certifikat, izvezite ga i ažurirajte pouzdanje na svakom klijentskom uređaju.

Primjer krajnje točke HTTPS

https://192.168.1.42:9000/mcp

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

Verzija ugovora

Verzija	Nazivi alata TCP	Napomene
v1.1.0 (zadano)	get_*	Preporučeno za nova postavljanja
v1.0.0	Legacy (health_metrics, …)	Ažuriranje kompatibilnosti Claude Desktop v1.0.0
v0.0.1	Legacy	Najstarija kompatibilnost

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 za svaku integraciju. Koristite krajnju točku i token prikazane tamo. Formate potvrdite prema verziji klijenta.

Svi primjeri u nastavku koriste zamjensku LAN adresu — zamijenite je adresom iPhonea sa zaslona Poslužitelj.

Claude Code (CLI)

Pokrenite na 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 pouzdanja u CA na Macu):

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

Claude Code / projektna datoteka (.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 — Node.js most nije potreban. Konfiguracija živi u ~/.codex/config.toml (globalno) ili .codex/config.toml u pouzdanom direktoriju 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čna konfiguracija (config.toml):

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

Prije pokretanja Codexa izvezite HAE_MCP_TOKEN s vašim bearer tokenom. Nakon postavljanja pokrenite /mcp unutar sesije Codex za potvrdu da je poslužitelj povezan.

Ako u Health Auto Exportu ponovno generirate bearer token, 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 samo sa stdio (na primjer Claude Desktop) koji se ne mogu povezati izravno putem HTTP-a. Zahtijeva Node.js na Macu koji pokreće klijenta.

1. Pokrenite poslužitelj na iPhoneu i kopirajte krajnju točku i token
2. Na 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 pouzdajte se u njega u Privjesku ključeva (Uvijek pouzdaj) na Macu
2. Koristite https://192.168.1.42:9000/mcp u args
3. Za verzije Node podržane generiranim postavljanjem iznad dodajte ovaj objekt env u isti objekt konfiguracije poslužitelja:

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

Na starijem Nodeu umjesto toga postavite NODE_EXTRA_CA_CERTS na čitljivu PEM putanju. Nakon ažuriranja konfiguracije ponovno pokrenite stdio klijenta.

Argumenti alata

Formati datuma

Parametri start i end prihvaćaju dva formata:

Format	Primjer	Napomene
yyyy-MM-dd	2026-06-13	Datum početka: ponoć; datum kraja: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Eksplicitno vrijeme i pomak vremenske zone

TCP

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

Savjeti

1. Držite Health Auto Export u prednjem planu na iPhoneu dok su klijenti povezani
2. Ponovno generirajte token ako sumnjate da je otkriven
3. Nakon promjene LAN IP-a iPhonea ponovno kopirajte URL krajnje točke

Dobivanje pomoći

Za slanje podrške pogledajte Dobivanje pomoći i za dijagnostičke izvoze Zapisnike događaja aplikacije.