Conectați-vă la Server

Serverul MCP pe iOS le permite clienților AI și scripturilor de pe rețeaua locală să interogheze datele dvs. de sănătate. HTTP (Streamable MCP) este transportul recomandat. iOS acceptă și TCP pentru configurări Node-bridge.

Clienții rulează pe Mac sau pe alte dispozitive din aceeași rețea și se conectează la endpointul 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 (neautentificat)

Înlocuiți {LAN_IP} cu adresa afișată pe ecranul Server în timp ce serverul rulează.

Cazuri de utilizare:

• Conectați Claude Code, Codex, Cursor sau VS Code pe Mac la datele de sănătate de pe iPhone
• Folosiți mcp-remote (iOS / LAN) pentru clienți doar-stdio precum Claude Desktop
• Interogați metrici și antrenamente din scripturi pe rețeaua locală (HTTP)
• Integrări TCP prin Node bridge health-auto-export-mcp-server

Cerințe preliminare

• Health Auto Export pe iPhone (aplicația trebuie să rămână în prim-plan în timp ce clienții sunt conectați)
• Abonament Premium
• HTTP: Token Bearer de pe ecranul Server
• Permisiune Local Network pe iPhone
• Dispozitiv client: Același 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 fila Export. Pe iPad, folosiți bara laterală.
2. Alegeți HTTP (recomandat) sau TCP
3. Opțional activați Folosește HTTPS (instrucțiuni mai jos)
4. Atingeți Pornește serverul
5. Copiați URL-ul endpointului și tokenul bearer

Serverul activ se oprește automat dacă Health Auto Export trece în fundal, indiferent dacă folosiți HTTP sau TCP.

Autentificare (HTTP)

Toate solicitările HTTP necesită:

Authorization: Bearer <your-token>

• Regenerați tokenul de pe ecranul Server dacă este necesar
• Pe HTTP simplu, tokenul este trimis pe o conexiune necriptată—folosiți-l doar pe rețele de încredere, sau activați HTTPS
• TCP legacy nu are autentificare (neschimbat)

HTTPS (TLS)

HTTPS folosește o Certificate Authority (CA) generată local. Exportați și acordați încredere certificatului pe fiecare dispozitiv client înainte de a vă conecta prin https://.

Activarea HTTPS

1. Deschideți vizualizarea Server (iPhone: fila Export; iPad: bara laterală)
2. Activați Folosește HTTPS
3. Atingeți Exportă certificatul CA și folosiți foaia de partajare pentru AirDrop sau salvați fișierul CA pe fiecare dispozitiv client
4. Porniți serverul — asigurați-vă că URL-ul endpointului trece la https://

Acordarea încrederii CA pe clienți

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

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

Versiuni Node pentru configurarea generată

Configurarea Node bridge generată de aplicație folosește NODE_OPTIONS=--use-system-ca pentru aceste versiuni Node:

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

Pe Node mai vechi, setați NODE_EXTRA_CA_CERTS la o cale PEM pe care procesul bridge o poate citi. Emiterea --use-system-ca pe Node nesuportat împiedică pornirea procesului.

Domeniul de încredere: --use-system-ca acordă încredere Keychain-ului de sistem complet, nu doar CA-ului acestei aplicații. NODE_EXTRA_CA_CERTS adaugă CA-ul exportat la certificatele de încredere ale Node. Consultați opțiunile de certificat Node.

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

Amprenta CA este afișată pe ecranul Server, astfel încât să puteți verifica că ați exportat certificatul corect.

Schimbări IP LAN iOS

Recopiați URL-ul endpointului dacă adresa de rețea a iPhone-ului se schimbă. Dacă este furnizat un certificat CA de înlocuire, exportați-l și actualizați încrederea pe fiecare dispozitiv client.

Exemplu endpoint HTTPS

https://192.168.1.42:9000/mcp

Înlocuiți hostul cu valoarea afișată pe ecranul Server.

Versiune contract

Versiune	Nume instrumente TCP	Note
v1.1.0 (implicit)	get_*	Recomandat pentru configurări noi
v1.0.0	Legacy (health_metrics, …)	Actualizare de compatibilitate Claude Desktop v1.0.0
v0.0.1	Legacy	Compatibilitate cea mai veche

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

Configurarea clientului

Ecranul Server include snippet-uri de copiat-lipit pentru fiecare integrare. Folosiți endpointul și tokenul afișate acolo. Verificați formatele față de versiunea clientului.

Toate exemplele de mai jos folosesc o adresă LAN placeholder—înlocuiți-o cu adresa iPhone-ului de pe ecranul Server.

Claude Code (CLI)

Rulați pe Mac (necesită Claude Code CLI):

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):

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

Claude Code / fișier 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 este necesar un bridge Node.js. Configurarea se află în ~/.codex/config.toml (global) sau .codex/config.toml într-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

Configurare manuală (config.toml):

[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, rulați /mcp într-o sesiune Codex pentru a verifica că 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 adăugați din nou intrarea serverului.

mcp-remote (iOS / LAN)

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

1. Porniți serverul pe iPhone și copiați endpointul și tokenul
2. Pe Mac, selectați mcp-remote (iOS / LAN) pe ecranul Server și copiați snippet-ul JSON, sau lipiți aceasta î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
2. Folosiți https://192.168.1.42:9000/mcp în args
3. Pentru versiunile Node suportate de configurarea generată de mai sus, adăugați acest obiect env la același obiect de configurare a serverului:

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

Pe Node mai vechi, setați NODE_EXTRA_CA_CERTS la o cale PEM citibilă. Reporniți clientul stdio după actualizarea configurației.

Argumente instrument

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 sfârșit: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Oră și offset de fus orar explicite

TCP

• JSON-RPC necriptat, neautentificat pe portul 9000
• Folosiți contractul v1.0.0 cu bridge-ul Node health-auto-export-mcp-server pentru nume de instrumente legacy
• Folosiți contractul v1.1.0 pentru nume de instrumente TCP get_* (actualizați bridge-ul Node separat)

Sfaturi

1. Păstrați Health Auto Export în prim-plan pe iPhone în timp ce clienții sunt conectați
2. Regenerați tokenul dacă bănuiți că a fost expus
3. Recopiați URL-ul endpointului după ce IP-ul LAN al iPhone-ului se schimbă

Obținerea de ajutor

Consultați Obținerea de ajutor pentru trimiterea de solicitări de asistență și Jurnale evenimente aplicație pentru exporturi de diagnostic.