Ghid de conectare la server

Serverul MCP pe iOS permite clienților de AI și scripturilor din rețeaua locală să interogheze datele dvs. de sănătate. HTTP (Streamable MCP) este transportul recomandat. iOS acceptă și TCP pentru configurații cu punte Node.

Clienții se execută pe Mac-ul dvs. sau pe alte dispozitive din aceeași rețea și se conectează la endpoint-ul afișat pe iPhone.

Prezentare generală

Transport	Endpoint
HTTP (recomandat)	http://{LAN_IP}:9000/mcp (sau https:// când HTTPS este activat)
TCP	{LAN_IP}:9000 (fără autentificare)

Înlocuiți {LAN_IP} cu adresa afișată pe ecranul Server cât timp serverul rulează.

Cazuri de utilizare:

• Conectarea Claude Code, Codex, Cursor sau VS Code de pe Mac la datele de sănătate de pe iPhone
• Folosirea mcp-remote (iOS / LAN) pentru clienți care acceptă doar stdio, cum ar fi Claude Desktop
• Interogarea metricilor și antrenamentelor din scripturi din rețeaua locală (HTTP)
• Integrări TCP prin puntea Node health-auto-export-mcp-server

Cerințe preliminare

• Health Auto Export pe iPhone (aplicația trebuie să rămână în prim-plan cât timp clienții sunt conectați)
• Abonament Premium
• HTTP: token Bearer de pe ecranul Server
• Permisiunea Rețea locală pe iPhone
• Dispozitiv client: aceeași rețea Wi‑Fi sau LAN ca iPhone-ul; Node.js doar dacă folosiți mcp-remote (iOS / LAN)

Pornirea serverului

1. Pe iPhone, deschideți Server din navigarea din bara laterală
2. Alegeți HTTP (recomandat) sau TCP
3. Opțional, activați Folosește HTTPS (instrucțiuni mai jos)
4. Apăsați Pornește serverul
5. Copiați URL-ul endpoint-ului și tokenul Bearer

Serverul se oprește automat dacă Health Auto Export trece în fundal (atât pentru HTTP, cât și pentru TCP).

Autentificare (HTTP)

Toate solicitările HTTP necesită:

Authorization: Bearer <tokenul-tau>

• Regenerați tokenul din ecranul Server dacă considerați necesar
• Pe HTTP simplu, tokenul este trimis printr-o conexiune necriptată; folosiți doar în rețele de încredere sau activați HTTPS
• TCP-ul vechi nu are autentificare (nemodificat)

HTTPS (TLS)

Când Folosește HTTPS este activat, aplicația generează o Autoritate de Certificare (CA) locală privată și un certificat de server semnat de acea CA. Clienții trebuie să aibă încredere în CA-ul exportat înainte de a se putea conecta prin https://.

Activarea HTTPS

1. Deschideți vizualizarea Server din navigarea din bara laterală
2. Activați Folosește HTTPS
3. Apăsați Exportă certificatul CA și folosiți fila de partajare pentru a-l trimite prin AirDrop sau a-l salva pe fiecare dispozitiv client
4. Porniți serverul; verificați ca URL-ul endpoint-ului să treacă la https://

Acordarea încrederii în CA pe clienți

Acordați încredere CA-ului exportat pe dispozitivul pe care rulează clientul de AI (de obicei Mac-ul dvs.):

1. Exportați CA de pe ecranul Server, de pe iPhone
2. Deschideți fișierul PEM în Keychain Access pe Mac-ul client
3. Setați Trust → Always Trust

Versiunea minimă de Node pentru --use-system-ca

Punțile Node (mcp-remote) pot folosi NODE_OPTIONS=--use-system-ca doar când Node îndeplinește:

Linie Node	Versiune minimă
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	orice

Pe versiuni de Node mai vechi, setați NODE_EXTRA_CA_CERTS cu o cale către un fișier PEM pe care procesul punte îl poate citi. Folosirea --use-system-ca pe o versiune de Node neacceptată împiedică pornirea procesului.

Domeniul de încredere: --use-system-ca acordă încredere întregului Keychain de sistem, nu doar CA-ului acestei aplicații. NODE_EXTRA_CA_CERTS limitează încrederea la un singur fișier PEM (alternativă pe versiuni de Node mai vechi). Opțiunea este documentată pentru macOS/Windows.

Tip de client	Configurare
Cursor, VS Code, Claude Code, Codex	Încredere în Keychain pe Mac-ul client; folosiți endpoint-ul https:// de pe ecranul Server
mcp-remote (iOS / LAN)	Acordați încredere CA-ului în Keychain pe Mac-ul pe care rulează mcp-remote. Fragmentul folosește NODE_OPTIONS=--use-system-ca când Node îndeplinește versiunea minimă; pe versiuni mai vechi, setați NODE_EXTRA_CA_CERTS cu o cale către un PEM lizibil
curl / scripturi	Transmiteți --cacert /calea/catre/mcp-ca.pem sau setați NODE_EXTRA_CA_CERTS

Amprenta CA este afișată pe ecranul Server, pentru a putea verifica dacă ați exportat certificatul corect.

Schimbări de IP LAN pe iOS

Când IP-ul din rețeaua locală al iPhone-ului se schimbă, aplicația regenerează certificatul de server cu Subject Alternative Names actualizate și repornește listener-ul HTTPS. Copiați din nou URL-ul endpoint-ului dacă IP-ul s-a schimbat. Certificatul CA rămâne același, cu excepția cazului în care îl regenerați dezactivând și reactivând HTTPS.

Exemplu de endpoint HTTPS

https://192.168.1.42:9000/mcp

Înlocuiți host-ul cu valoarea afișată pe ecranul Server.

Versiunea contractului

Versiune	Numele instrumentelor TCP	Note
v1.1.0 (implicită)	get_*	Recomandată pentru configurații noi
v1.0.0	Veche (health_metrics, …)	Actualizare de compatibilitate v1.0.0 cu Claude Desktop
v0.0.1	Veche	Cea mai veche, pentru compatibilitate

HTTP folosește întotdeauna numele de instrumente get_*; versiunea contractului afectează doar valorile implicite ale schemei.

Configurarea clientului

Ecranul Server include fragmente de tip copiere-lipire pentru fiecare integrare. Folosiți endpoint-ul și tokenul afișate acolo. Verificați formatele în funcție de versiunea clientului dvs.

Toate exemplele de mai jos folosesc o adresă LAN de test; înlocuiți-o cu adresa iPhone-ului dvs. afișată pe ecranul Server.

Claude Code (CLI)

Executați pe Mac (necesită CLI-ul Claude Code):

HTTP:

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

HTTPS (după exportarea și acordarea încrederii CA pe Mac-ul dvs.):

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

Claude Code / fișier de proiect (.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 conectează direct prin Streamable HTTP — nu necesită o punte Node.js. Configurația se află în ~/.codex/config.toml (global) sau în .codex/config.toml dintr-un director de proiect de încredere.

CLI (recomandat):

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

config.toml manual:

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

Exportați HAE_MCP_TOKEN cu tokenul Bearer înainte de a porni Codex. După configurare, executați /mcp într-o sesiune Codex pentru a verifica dacă serverul este conectat.

Dacă regenerați tokenul Bearer în Health Auto Export, actualizați HAE_MCP_TOKEN și rulați din nou codex mcp add, sau eliminați și readăugați intrarea serverului.

mcp-remote (iOS / LAN)

Pentru clienți care acceptă doar stdio (cum ar fi Claude Desktop) și care nu se pot conecta direct prin HTTP. Necesită Node.js pe Mac-ul care execută clientul.

1. Porniți serverul pe iPhone și copiați endpoint-ul și tokenul
2. Pe Mac, selectați mcp-remote (iOS / LAN) pe ecranul Server și copiați fragmentul JSON, sau lipiți-l în configurația MCP a clientului (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>"
  ]
}

Când HTTPS este activat:

1. Exportați CA de pe iPhone și acordați-i încredere în Keychain Access (Always Trust) pe Mac-ul dvs.
2. Folosiți https://192.168.1.42:9000/mcp în args
3. Când Node îndeplinește versiunea minimă pentru --use-system-ca (22.19.0 pe 22.x, 23.8.0 pe 23.x, 24.6.0 pe 24.x, sau orice versiune 25+), adăugați:

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

Pe versiuni de Node mai vechi, setați NODE_EXTRA_CA_CERTS cu o cale către un PEM lizibil. Reporniți clientul stdio după actualizarea configurației.

Reducerea latenței de pornire: npx -y descarcă mcp-remote la prima utilizare și verifică din nou când cache-ul expiră, ceea ce poate cauza întârzieri de câteva secunde. Instalarea globală elimină acest lucru:

npm install -g mcp-remote@0.1.16

Argumentele instrumentelor

Formate de dată

Parametrii start și end acceptă două formate:

Format	Exemplu	Note
yyyy-MM-dd	2026-06-13	Data de început: miezul nopții; data de final: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Oră explicită și decalaj de fus orar

TCP

• JSON-RPC necriptat și fără autentificare, pe portul 9000
• Folosiți contractul v1.0.0 cu puntea Node health-auto-export-mcp-server pentru numele vechi ale instrumentelor
• Folosiți contractul v1.1.0 pentru numele de instrumente TCP get_* (actualizați puntea Node separat)

Sfaturi

1. Păstrați Health Auto Export în prim-plan pe iPhone cât timp clienții sunt conectați
2. Regenerați tokenul dacă suspectați că a fost expus
3. Copiați din nou URL-ul endpoint-ului după ce IP-ul LAN al iPhone-ului se schimbă

Suport prin chat

Colectați diagnostice din jurnalele de evenimente ale aplicației accesând Setări → Avansat → Exportă jurnale de evenimente. Consultați Ghidul jurnalelor de evenimente ale aplicației. Trimiteți fișierul zip generat prin Suport prin chat sau prin e-mail.