Szerverkapcsolat útmutató

Az iOS-en futó MCP szerver lehetővé teszi, hogy a helyi hálózaton lévő AI-kliensek és szkriptek lekérdezzék az egészségügyi adatait. A HTTP (Streamable MCP) az ajánlott átviteli mód. Az iOS a TCP-t is támogatja Node-bridge beállításokhoz.

A kliensek a Mac-en vagy más, azonos hálózaton lévő eszközökön futnak, és az iPhone-on megjelenített végponthoz csatlakoznak.

Áttekintés

Átvitel	Végpont
HTTP (ajánlott)	http://{LAN_IP}:9000/mcp (vagy https://, ha a HTTPS engedélyezve van)
TCP	{LAN_IP}:9000 (hitelesítés nélkül)

Cserélje ki a {LAN_IP} értéket a Server képernyőn megjelenített címre, amíg a szerver fut.

Felhasználási esetek:

• Kapcsolja össze a Claude Code-ot, a Codexet, a Cursort vagy a VS Code-ot a Mac-en az iPhone-on lévő egészségügyi adatokkal
• Használja az mcp-remote (iOS / LAN) eszközt csak stdio-t támogató kliensekhez, mint a Claude Desktop
• Kérdezzen le mérőszámokat és edzéseket szkriptekből a helyi hálózaton (HTTP)
• TCP integrációk a health-auto-export-mcp-server Node-bridge segítségével

Előfeltételek

• Health Auto Export az iPhone-on (az alkalmazásnak előtérben kell maradnia, amíg kliensek csatlakoznak)
• Premium előfizetés
• HTTP: Bearer token a Server képernyőről
• Helyi hálózat engedély az iPhone-on
• Kliens eszköz: Ugyanaz a Wi-Fi vagy LAN, mint az iPhone-é; Node.js csak akkor szükséges, ha az mcp-remote (iOS / LAN)-ot használja

A szerver elindítása

1. Az iPhone-on nyissa meg a Server oldalt az oldalsó navigáció segítségével
2. Válassza a HTTP (ajánlott) vagy a TCP lehetőséget
3. Opcionálisan engedélyezze a Use HTTPS funkciót (lásd az alábbi utasításokat)
4. Koppintson a Start Server gombra
5. Másolja ki a végpont URL-t és a bearer tokent

A szerver automatikusan leáll, ha a Health Auto Export háttérbe kerül (mind HTTP, mind TCP esetén).

Hitelesítés (HTTP)

Minden HTTP-kérésnek tartalmaznia kell:

Authorization: Bearer <your-token>

• Szükség esetén generálja újra a tokent a Server képernyőn
• Egyszerű HTTP esetén a token titkosítatlan kapcsolaton keresztül kerül továbbításra — csak megbízható hálózatokon használja, vagy engedélyezze a HTTPS-t
• A régi TCP-nek nincs hitelesítése (nem változott)

HTTPS (TLS)

Ha a Use HTTPS engedélyezve van, az alkalmazás létrehoz egy privát, helyi hitelesítésszolgáltatót (CA) és egy ezzel a CA-val aláírt szerver leaf tanúsítványt. A kliensnek meg kell bíznia az exportált CA-ban, mielőtt https://-en keresztül csatlakozhat.

A HTTPS engedélyezése

1. Nyissa meg a Server nézetet az oldalsó navigáció segítségével
2. Kapcsolja be a Use HTTPS opciót
3. Koppintson az Export CA Certificate gombra, és a megosztási menü segítségével AirDrop-pal küldje el vagy mentse el a CA fájlt minden kliens eszközön
4. Indítsa el a szervert — ellenőrizze, hogy a végpont URL-je https://-re vált

A CA megbízhatóvá tétele a kliensek oldalán

Tegye megbízhatóvá az exportált CA-t azon az eszközön, amelyen az AI-kliens fut (jellemzően a Mac-en):

1. Exportálja a CA-t a Server képernyőről az iPhone-on
2. Nyissa meg a PEM fájlt a kliens Mac Keychain Access alkalmazásában
3. Állítsa be a Trust → Always Trust opciót

Minimális Node verzió a --use-system-ca-hoz

A Node bridge-ek (mcp-remote) csak akkor használhatják a NODE_OPTIONS=--use-system-ca opciót, ha a Node megfelel a következőknek:

Node vonal	Minimális verzió
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	bármelyik

Régebbi Node esetén állítsa be a NODE_EXTRA_CA_CERTS változót egy olyan PEM elérési útra, amelyet a bridge folyamat el tud olvasni. A --use-system-ca használata nem támogatott Node verzión megakadályozza a folyamat elindulását.

Megbízhatósági kör: A --use-system-ca a teljes rendszer Keychain-ben bízik, nem csak ennek az alkalmazásnak a CA-jában. A NODE_EXTRA_CA_CERTS a megbízhatóságot egyetlen PEM fájlra korlátozza (visszaesési megoldás régebbi Node esetén). A kapcsoló macOS/Windows rendszerekre dokumentált.

Kliens típusa	Beállítás
Cursor, VS Code, Claude Code, Codex	Keychain megbízhatóság a kliens Mac-en — használja a https:// végpontot a Server képernyőről
mcp-remote (iOS / LAN)	Bízzon meg a CA-ban a Keychain-ben azon a Mac-en, amelyen az mcp-remote fut. A kódrészlet a NODE_OPTIONS=--use-system-ca opciót használja, ha a Node megfelel a minimális verziónak; régebbi Node esetén állítsa be a NODE_EXTRA_CA_CERTS-t egy olvasható PEM elérési útra
curl / szkriptek	Adja meg a --cacert /path/to/mcp-ca.pem opciót, vagy állítsa be a NODE_EXTRA_CA_CERTS-t

A CA lenyomata megjelenik a Server képernyőn, így ellenőrizheti, hogy a megfelelő tanúsítványt exportálta.

iOS LAN IP-változások

Ha az iPhone LAN IP-je megváltozik, az alkalmazás újragenerálja a leaf tanúsítványt a frissített Subject Alternative Names-szel, és újraindítja a HTTPS listenert. Másolja ki újra a végpont URL-t, ha az IP megváltozott. A CA tanúsítvány ugyanaz marad, kivéve, ha újragenerálja a HTTPS ki- és bekapcsolásával.

HTTPS végpont példa

https://192.168.1.42:9000/mcp

Cserélje ki a hostot a Server képernyőn megjelenített értékre.

Szerződésverzió

Verzió	TCP eszköznevek	Megjegyzések
v1.1.0 (alapértelmezett)	get_*	Ajánlott új telepítésekhez
v1.0.0	Régi (health_metrics, …)	Claude Desktop kompatibilitási frissítés v1.0.0
v0.0.1	Régi	Legrégebbi kompatibilitás

A HTTP mindig get_* eszközneveket használ; a szerződésverzió csak a séma alapértékeit érinti.

Kliens konfigurálása

A Server képernyő másolható-beilleszthető kódrészleteket tartalmaz minden integrációhoz. Használja az ott megjelenített végpontot és tokent. Ellenőrizze a formátumokat a kliens verziójának megfelelően.

Az alábbi példák mindegyike egy helyőrző LAN-címet használ — cserélje ki az iPhone-ja címére a Server képernyőről.

Claude Code (CLI)

Futtassa a Mac-en (szükséges a Claude Code CLI):

HTTP:

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

HTTPS (a CA exportálása és megbízhatóvá tétele után a Mac-en):

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

Claude Code / projektfájl (.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)

A Codex közvetlenül Streamable HTTP-n keresztül csatlakozik — nincs szükség Node.js bridge-re. A konfiguráció a ~/.codex/config.toml (globális) vagy a .codex/config.toml fájlban található egy megbízható projektkönyvtárban.

CLI (ajánlott):

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ális config.toml:

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

Exportálja a HAE_MCP_TOKEN-t a bearer tokenjével, mielőtt elindítja a Codexet. A beállítás után futtassa a /mcp parancsot egy Codex-sessionben, hogy ellenőrizze, a szerver csatlakozott.

Ha újragenerálja a bearer tokent a Health Auto Exportban, frissítse a HAE_MCP_TOKEN-t, és futtassa újra a codex mcp add parancsot, vagy távolítsa el és adja hozzá újra a szerverbejegyzést.

mcp-remote (iOS / LAN)

Csak stdio-t támogató kliensekhez (mint a Claude Desktop), amelyek nem tudnak közvetlenül HTTP-n keresztül csatlakozni. Node.js-t igényel a klienst futtató Mac-en.

1. Indítsa el a szervert az iPhone-on, és másolja ki a végpontot és a tokent
2. A Mac-en válassza az mcp-remote (iOS / LAN) opciót a Server képernyőn, és másolja ki a JSON kódrészletet, vagy illessze be a kliens MCP konfigurációjába (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>"
  ]
}

Ha a HTTPS engedélyezve van:

1. Exportálja a CA-t az iPhone-ról, és tegye megbízhatóvá a Keychain Access-ben (Always Trust) a Mac-en
2. Használja a https://192.168.1.42:9000/mcp címet az args-ban
3. Ha a Node megfelel a --use-system-ca minimális verziójának (22.19.0 a 22.x-en, 23.8.0 a 23.x-en, 24.6.0 a 24.x-en, vagy bármely 25+ kiadás), adja hozzá:

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

Régebbi Node esetén állítsa be helyette a NODE_EXTRA_CA_CERTS-t egy olvasható PEM elérési útra. A konfiguráció frissítése után indítsa újra a stdio klienst.

Az indítási késleltetés csökkentése: Az npx -y az első használatkor letölti a mcp-remote-ot, és a gyorsítótár lejáratakor újra ellenőrzi, ami több másodperces késleltetést okozhat. A globális előzetes telepítés ezt megszünteti:

npm install -g mcp-remote@0.1.16

Eszközargumentumok

Dátumformátumok

A start és end paraméterek két formátumot fogadnak el:

Formátum	Példa	Megjegyzések
yyyy-MM-dd	2026-06-13	Kezdő dátum: éjfél; befejező dátum: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Explicit idő és időzóna-eltolás

TCP

• Titkosítatlan, hitelesítés nélküli JSON-RPC a 9000-es porton
• Használja a v1.0.0 szerződést a Node health-auto-export-mcp-server bridge-dzsel a régi eszköznevekhez
• Használja a v1.1.0 szerződést a get_* TCP eszközneveihez (a Node bridge-et külön frissítse)

Tippek

1. Tartsa a Health Auto Exportot előtérben az iPhone-on, amíg kliensek csatlakoznak
2. Generálja újra a tokent, ha felmerül, hogy nyilvánosságra került
3. Másolja ki újra a végpont URL-t, ha megváltozott az iPhone LAN IP-je

Csevegéses támogatás

Gyűjtsön diagnosztikai adatokat az exportáló alkalmazás eseménynaplóiból a Settings → Advanced → Export Event Logs menüponton keresztül. Lásd az Alkalmazás eseménynaplók útmutatót. Ossza meg a létrehozott zip fájlt a Csevegéses támogatáson vagy e-mailben.