Kiszolgáló csatlakoztatása

Az MCP-kiszolgáló iOS-en 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 átvitel. Az iOS TCP-t is támogat Node-híd beállításokhoz.

A kliensek a Macen vagy a ugyanazon a hálózaton lévő más eszközökön futnak, és az iPhone-on megjelenő 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 a {LAN_IP} értéket a Kiszolgáló képernyőn megjelenő címre, amíg a kiszolgáló fut.

Használati esetek:

• Csatlakoztassa a Claude Code, Codex, Cursor vagy VS Code alkalmazásokat Macen az iPhone egészségügyi adataihoz
• Használja az mcp-remote (iOS / LAN) lehetőséget csak stdio kliensekhez, például Claude Desktop
• Lekérdezzen metrikákat és edzéseket szkriptekből a helyi hálózaton (HTTP)
• TCP-integrációk a health-auto-export-mcp-server Node-híddal

Előfeltételek

• Health Auto Export iPhone-on (az alkalmazásnak az előtérben kell maradnia, amíg a kliensek csatlakoznak)
• Premium előfizetés
• HTTP: Bearer token a Kiszolgáló képernyőről
• Helyi hálózat jogosultság iPhone-on
• Klienseszköz: Ugyanaz a Wi‑Fi vagy LAN, mint az iPhone; Node.js csak ha mcp-remote (iOS / LAN)-t használ

A kiszolgáló indítása

1. iPhone-on nyissa meg a Kiszolgáló lehetőséget az Exportálás lapról. iPaden használja az oldalsávot.
2. Válassza a HTTP (ajánlott) vagy TCP lehetőséget
3. Opcionálisan engedélyezze a HTTPS használata lehetőséget (utasítások alább)
4. Koppintson a Kiszolgáló indítása gombra
5. Másolja a végpont URL-jét és a bearer tokent

Az aktív kiszolgáló automatikusan leáll, ha a Health Auto Export a háttérbe kerül, akár HTTP-t, akár TCP-t használ.

Hitelesítés (HTTP)

Minden HTTP-kéréshez szükséges:

Authorization: Bearer <your-token>

• Szükség esetén generálja újra a tokent a Kiszolgáló képernyőről
• Sima HTTP-n a token titkosítatlan kapcsolaton megy — csak megbízható hálózatokon használja, vagy engedélyezze a HTTPS-t
• A legacy TCP-nek nincs hitelesítése (változatlan)

HTTPS (TLS)

A HTTPS helyileg generált hitelesítésszolgáltatót (CA) használ. Exportálja és bízzon meg a tanúsítványában minden klienseszközön, mielőtt https:// kapcsolaton csatlakozna.

HTTPS engedélyezése

1. Nyissa meg a Kiszolgáló nézetet (iPhone: Exportálás lap; iPad: oldalsáv)
2. Kapcsolja be a HTTPS használata lehetőséget
3. Koppintson a CA-tanúsítvány exportálása gombra, és AirDroppal vagy mentéssel juttassa el a CA-fájlt minden klienseszközre
4. Indítsa el a kiszolgálót — erősítse meg, hogy a végpont URL https://-re vált

A CA megbízhatóságának beállítása a klienseken

Bízzon meg az exportált CA-ban az AI-klienst futtató eszközön (általában a Macjén):

1. Exportálja a CA-t a Kiszolgáló képernyőről iPhone-on
2. Nyissa meg a PEM-et a Kulcstartó-elérésben a kliens Macen
3. Állítsa a Megbízhatóság → Mindig megbízható értéket

Node-verziók a generált beállításhoz

Az alkalmazás generált Node-híd beállítása a NODE_OPTIONS=--use-system-ca értéket használja ezekhez a Node-verziókhoz:

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

Régebbi Node esetén állítsa a NODE_EXTRA_CA_CERTS értéket a híd folyamat által olvasható PEM-útvonalra. A --use-system-ca kibocsátása nem támogatott Node-on megakadályozza a folyamat indítását.

Megbízhatósági hatókör: A --use-system-ca a teljes rendszer-kulcstartóban bízik meg, nem csak ezen alkalmazás CA-jában. A NODE_EXTRA_CA_CERTS hozzáadja az exportált CA-t a Node megbízható tanúsítványaihoz. Lásd Node certificate options.

Klienstípus	Beállítás
Cursor, VS Code, Claude Code, Codex	Kulcstartó-megbízhatóság a kliens Macen — használja a https:// végpontot a Kiszolgáló képernyőről
mcp-remote (iOS / LAN)	Bízzon meg a CA-ban a Mac Kulcstartójában, ahol az mcp-remote fut. A snippet NODE_OPTIONS=--use-system-ca értéket használ, ha a Node eléri a minimális verziót; régebbi Node esetén állítsa a NODE_EXTRA_CA_CERTS értéket olvasható PEM-útvonalra
curl / szkriptek	Adja át a --cacert /path/to/mcp-ca.pem kapcsolót, vagy állítsa a NODE_EXTRA_CA_CERTS értéket

A CA ujjlenyomata a Kiszolgáló képernyőn jelenik meg, hogy ellenőrizhesse a megfelelő tanúsítvány exportálását.

iOS LAN IP változások

Másolja újra a végpont URL-jét, ha az iPhone hálózati címe megváltozik. Ha csere CA-tanúsítványt adnak, exportálja, és frissítse a megbízhatóságot minden klienseszközön.

Példa HTTPS-végpont

https://192.168.1.42:9000/mcp

Cserélje a gazdagépet a Kiszolgáló képernyőn megjelenő értékre.

Szerződésverzió

Verzió	TCP eszköznevek	Megjegyzések
v1.1.0 (alapértelmezett)	get_*	Új beállításokhoz ajánlott
v1.0.0	Legacy (health_metrics, …)	Claude Desktop kompatibilitási frissítés v1.0.0
v0.0.1	Legacy	Legrégebbi kompatibilitás

A HTTP mindig get_* eszközneveket használ; a szerződésverzió csak a sémaalapértelmezéseket érinti.

Klienskonfiguráció

A Kiszolgáló képernyő másolható snippeteket tartalmaz minden integrációhoz. Használja az ott megjelenő végpontot és tokent. Ellenőrizze a formátumokat a kliensverziója alapján.

Az alábbi példák mind helyőrző LAN-címet használnak — cserélje az iPhone címére a Kiszolgáló képernyőről.

Claude Code (CLI)

Futtassa Macen (Claude Code CLI szükséges):

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óságának beállítása után Macen):

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 csatlakozik — nincs szükség Node.js-hídra. A konfiguráció a ~/.codex/config.toml (globális) vagy .codex/config.toml fájlban van 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

Kézi konfiguráció (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 értéket a bearer tokennel, mielőtt elindítaná a Codexet. Beállítás után futtassa a /mcp parancsot egy Codex-munkamenetben a kiszolgáló csatlakozásának ellenőrzéséhez.

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

mcp-remote (iOS / LAN)

Csak stdio kliensekhez (például Claude Desktop), amelyek nem tudnak közvetlenül HTTP-n csatlakozni. Node.js szükséges a klienst futtató Macen.

1. Indítsa el a kiszolgálót iPhone-on, és másolja a végpontot és a tokent
2. Macen válassza az mcp-remote (iOS / LAN) lehetőséget a Kiszolgáló képernyőn, és másolja a JSON snippetet, 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 iPhone-ról, és bízzon meg benne a Kulcstartó-elérésben (Mindig megbízható) Macen
2. Használja a https://192.168.1.42:9000/mcp értéket az args listában
3. A fenti generált beállítás által támogatott Node-verzióknál adja hozzá ezt az env objektumot ugyanahhoz a kiszolgálókonfiguráció-objektumhoz:

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

Régebbi Node esetén állítsa a NODE_EXTRA_CA_CERTS értéket olvasható PEM-útvonalra. Indítsa újra a stdio klienst a konfiguráció frissítése után.

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; záró 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áljon v1.0.0 szerződést a Node health-auto-export-mcp-server híddal legacy eszköznevekhez
• Használjon v1.1.0 szerződést get_* TCP eszköznevekhez (frissítse a Node-hídat külön)

Tippek

1. Tartsa a Health Auto Exportot az előtérben iPhone-on, amíg a kliensek csatlakoznak
2. Generálja újra a tokent, ha gyanítja, hogy kikerült
3. Másolja újra a végpont URL-jét az iPhone LAN IP változása után

Segítségkérés

Támogatási beküldéshez lásd Segítségkérés, diagnosztikai exportokhoz Alkalmazásesemény-naplók.