Σύνδεση με διακομιστή

Συνδεθείτε με τον διακομιστή MCP του Health Auto Export για AI clients και scripts στο τοπικό σας δίκτυο.

Last updated: July 14, 2026

Σε αυτή τη σελίδα

Οδηγός Σύνδεσης με Διακομιστή

Ο διακομιστής MCP στο iOS επιτρέπει σε AI clients και scripts στο τοπικό σας δίκτυο να κάνουν ερωτήματα στα δεδομένα υγείας σας. Το HTTP (Streamable MCP) είναι η προτεινόμενη μεταφορά. Το iOS υποστηρίζει επίσης TCP για ρυθμίσεις με Node-bridge.

Οι clients εκτελούνται στο Mac σας ή σε άλλες συσκευές στο ίδιο δίκτυο και συνδέονται στο endpoint που εμφανίζεται στο iPhone σας.

Επισκόπηση

Μεταφορά	Endpoint
HTTP (προτείνεται)	`http://{LAN_IP}:9000/mcp` (ή `https://` όταν είναι ενεργοποιημένο το HTTPS)
TCP	`{LAN_IP}:9000` (χωρίς αυθεντικοποίηση)

Αντικαταστήστε το {LAN_IP} με τη διεύθυνση που εμφανίζεται στην οθόνη Server ενώ ο διακομιστής εκτελείται.

Περιπτώσεις χρήσης:

Συνδέστε το Claude Code, το Codex, το Cursor ή το VS Code στο Mac σας με τα δεδομένα υγείας στο iPhone σας
Χρησιμοποιήστε το mcp-remote (iOS / LAN) για clients μόνο stdio, όπως το Claude Desktop
Κάντε ερωτήματα σε μετρήσεις και προπονήσεις από scripts στο τοπικό σας δίκτυο (HTTP)
Ενσωματώσεις TCP μέσω του Node bridge health-auto-export-mcp-server

Προαπαιτούμενα

Health Auto Export στο iPhone (η εφαρμογή πρέπει να παραμένει στο προσκήνιο όσο είναι συνδεδεμένοι clients)
Συνδρομή Premium
HTTP: Bearer token από την οθόνη Server
Άδεια Τοπικού Δικτύου στο iPhone
Συσκευή client: Ίδιο Wi-Fi ή τοπικό δίκτυο με το iPhone· Node.js μόνο αν χρησιμοποιείτε το mcp-remote (iOS / LAN)

Εκκίνηση του διακομιστή

Στο iPhone, ανοίξτε το Server χρησιμοποιώντας την πλευρική πλοήγηση
Επιλέξτε HTTP (προτείνεται) ή TCP
Προαιρετικά, ενεργοποιήστε το Use HTTPS (οδηγίες παρακάτω)
Πατήστε Start Server
Αντιγράψτε το URL του endpoint και το bearer token

Ο διακομιστής διακόπτεται αυτόματα αν το Health Auto Export μεταβεί στο παρασκήνιο (τόσο για HTTP όσο και για TCP).

Αυθεντικοποίηση (HTTP)

Όλα τα αιτήματα HTTP απαιτούν:

Authorization: Bearer <your-token>

Αναδημιουργήστε το token από την οθόνη Server αν κριθεί απαραίτητο
Σε απλό HTTP, το token αποστέλλεται μέσω μη κρυπτογραφημένης σύνδεσης — χρησιμοποιήστε μόνο σε αξιόπιστα δίκτυα ή ενεργοποιήστε το HTTPS
Το παλαιό TCP δεν έχει αυθεντικοποίηση (χωρίς αλλαγή)

HTTPS (TLS)

Όταν είναι ενεργοποιημένο το Use HTTPS, η εφαρμογή δημιουργεί μια ιδιωτική τοπική Αρχή Πιστοποίησης (CA) και ένα πιστοποιητικό διακομιστή υπογεγραμμένο από αυτή την CA. Οι clients πρέπει να εμπιστεύονται την εξαγόμενη CA πριν μπορέσουν να συνδεθούν μέσω https://.

Ενεργοποίηση του HTTPS

Ανοίξτε την προβολή Server χρησιμοποιώντας την πλευρική πλοήγηση
Ενεργοποιήστε το Use HTTPS
Πατήστε Export CA Certificate και χρησιμοποιήστε το μενού κοινής χρήσης για να στείλετε το αρχείο CA μέσω AirDrop ή να το αποθηκεύσετε σε κάθε συσκευή client
Ξεκινήστε τον διακομιστή — βεβαιωθείτε ότι το URL του endpoint αλλάζει σε https://

Εμπιστοσύνη στην CA στους clients

Εμπιστευτείτε την εξαγόμενη CA στη συσκευή που εκτελεί τον AI client (συνήθως το Mac σας):

Εξαγάγετε την CA από την οθόνη Server στο iPhone
Ανοίξτε το PEM στο Keychain Access στο Mac του client
Ρυθμίστε Trust → Always Trust

Ελάχιστη έκδοση Node για `--use-system-ca`

Τα Node bridges (mcp-remote) μπορούν να χρησιμοποιήσουν NODE_OPTIONS=--use-system-ca μόνο όταν το Node πληροί:

Σειρά Node	Ελάχιστη έκδοση
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	οποιαδήποτε

Σε παλαιότερο Node, ορίστε το NODE_EXTRA_CA_CERTS σε μια διαδρομή PEM που μπορεί να διαβάσει η διαδικασία bridge. Η χρήση του --use-system-ca σε μη υποστηριζόμενο Node εμποδίζει την εκκίνηση της διαδικασίας.

Εμβέλεια εμπιστοσύνης: Το --use-system-ca εμπιστεύεται ολόκληρο το system Keychain, όχι μόνο την CA αυτής της εφαρμογής. Το NODE_EXTRA_CA_CERTS περιορίζει την εμπιστοσύνη σε ένα μόνο αρχείο PEM (εναλλακτική λύση σε παλαιότερο Node). Η επισήμανση είναι τεκμηριωμένη για macOS/Windows.

Τύπος client	Ρύθμιση
Cursor, VS Code, Claude Code, Codex	Εμπιστοσύνη Keychain στο Mac του client — χρησιμοποιήστε το endpoint `https://` από την οθόνη Server
mcp-remote (iOS / LAN)	Εμπιστευτείτε την CA στο Keychain στο Mac που εκτελεί το `mcp-remote`. Το snippet χρησιμοποιεί `NODE_OPTIONS=--use-system-ca` όταν το Node πληροί την ελάχιστη έκδοση· σε παλαιότερο Node ορίστε το `NODE_EXTRA_CA_CERTS` σε μια αναγνώσιμη διαδρομή PEM
curl / scripts	Περάστε `--cacert /path/to/mcp-ca.pem` ή ορίστε το `NODE_EXTRA_CA_CERTS`

Το δακτυλικό αποτύπωμα της CA εμφανίζεται στην οθόνη Server, ώστε να μπορείτε να επιβεβαιώσετε ότι εξαγάγατε το σωστό πιστοποιητικό.

Αλλαγές LAN IP στο iOS

Όταν αλλάζει η διεύθυνση LAN IP του iPhone σας, η εφαρμογή αναδημιουργεί το πιστοποιητικό διακομιστή με ενημερωμένα Subject Alternative Names και επανεκκινεί τον listener HTTPS. Αντιγράψτε ξανά το URL του endpoint αν άλλαξε η IP. Το πιστοποιητικό CA παραμένει το ίδιο, εκτός αν το αναδημιουργήσετε απενεργοποιώντας και ενεργοποιώντας ξανά το HTTPS.

Παράδειγμα endpoint HTTPS

https://192.168.1.42:9000/mcp

Αντικαταστήστε τον host με την τιμή που εμφανίζεται στην οθόνη Server.

Έκδοση συμβολαίου

Έκδοση	Ονόματα εργαλείων TCP	Σημειώσεις
v1.1.0 (προεπιλογή)	`get_*`	Προτείνεται για νέες ρυθμίσεις
v1.0.0	Παλαιά (`health_metrics`, …)	Ενημέρωση συμβατότητας Claude Desktop v1.0.0
v0.0.1	Παλαιά	Παλαιότερη συμβατότητα

Το HTTP χρησιμοποιεί πάντα ονόματα εργαλείων get_*· η έκδοση συμβολαίου επηρεάζει μόνο τις προεπιλογές σχήματος.

Ρύθμιση client

Η οθόνη Server περιλαμβάνει snippets αντιγραφής-επικόλλησης για κάθε ενσωμάτωση. Χρησιμοποιήστε το endpoint και το token που εμφανίζονται εκεί. Επαληθεύστε τις μορφές σε σχέση με την έκδοση του client σας.

Όλα τα παρακάτω παραδείγματα χρησιμοποιούν μια δείκτη-θέση διεύθυνση LAN — αντικαταστήστε την με τη διεύθυνση του iPhone σας από την οθόνη Server.

Claude Code (CLI)

Εκτελέστε στο Mac σας (απαιτεί το CLI του Claude Code):

HTTP:

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

HTTPS (αφού εξαγάγετε και εμπιστευτείτε την CA στο Mac σας):

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

Claude Code / αρχείο έργου (`.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 συνδέεται μέσω Streamable HTTP απευθείας — δεν απαιτείται bridge Node.js. Η διαμόρφωση βρίσκεται στο ~/.codex/config.toml (καθολικά) ή στο .codex/config.toml σε έναν αξιόπιστο κατάλογο έργου.

CLI (προτείνεται):

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:

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

Εξαγάγετε το HAE_MCP_TOKEN με το bearer token σας πριν εκκινήσετε το Codex. Μετά τη ρύθμιση, εκτελέστε /mcp μέσα σε μια συνεδρία Codex για να επιβεβαιώσετε ότι ο διακομιστής είναι συνδεδεμένος.

Αν αναδημιουργήσετε το bearer token στο Health Auto Export, ενημερώστε το HAE_MCP_TOKEN και εκτελέστε ξανά το codex mcp add, ή αφαιρέστε και προσθέστε ξανά την καταχώρηση διακομιστή.

mcp-remote (iOS / LAN)

Για clients μόνο stdio (όπως το Claude Desktop) που δεν μπορούν να συνδεθούν μέσω HTTP απευθείας. Απαιτεί Node.js στο Mac που εκτελεί τον client.

Εκκινήστε τον διακομιστή στο iPhone και αντιγράψτε το endpoint και το token
Στο Mac σας, επιλέξτε mcp-remote (iOS / LAN) στην οθόνη Server και αντιγράψτε το snippet JSON, ή επικολλήστε το στη διαμόρφωση MCP του client (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>"
  ]
}

Όταν είναι ενεργοποιημένο το HTTPS:

Εξαγάγετε την CA από το iPhone και εμπιστευτείτε την στο Keychain Access (Always Trust) στο Mac σας
Χρησιμοποιήστε https://192.168.1.42:9000/mcp στο args
Όταν το Node πληροί την ελάχιστη έκδοση για το --use-system-ca (22.19.0 στο 22.x, 23.8.0 στο 23.x, 24.6.0 στο 24.x, ή οποιαδήποτε έκδοση 25+), προσθέστε:

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

Σε παλαιότερο Node, ορίστε αντ' αυτού το NODE_EXTRA_CA_CERTS σε μια αναγνώσιμη διαδρομή PEM. Επανεκκινήστε τον client stdio μετά την ενημέρωση της διαμόρφωσης.

Μείωση της καθυστέρησης εκκίνησης: Το npx -y κατεβάζει το mcp-remote κατά την πρώτη χρήση και επανελέγχει όταν λήγει η προσωρινή μνήμη, κάτι που μπορεί να προκαλέσει καθυστερήσεις πολλών δευτερολέπτων. Η προεγκατάσταση καθολικά εξαλείφει αυτό:

npm install -g mcp-remote@0.1.16

Ορίσματα εργαλείων

Μορφές ημερομηνίας

Οι παράμετροι start και end δέχονται δύο μορφές:

Μορφή	Παράδειγμα	Σημειώσεις
`yyyy-MM-dd`	`2026-06-13`	Ημερομηνία έναρξης: μεσάνυχτα· ημερομηνία λήξης: 23:59:59
`yyyy-MM-dd HH:mm:ss Z`	`2026-06-13 00:00:00 +0000`	Ρητή ώρα και offset ζώνης ώρας

TCP

Μη κρυπτογραφημένο, χωρίς αυθεντικοποίηση JSON-RPC στη θύρα 9000
Χρησιμοποιήστε το συμβόλαιο v1.0.0 με το Node bridge health-auto-export-mcp-server για παλαιά ονόματα εργαλείων
Χρησιμοποιήστε το συμβόλαιο v1.1.0 για ονόματα εργαλείων TCP get_* (ενημερώστε το Node bridge ξεχωριστά)

Συμβουλές

Κρατήστε το Health Auto Export στο προσκήνιο στο iPhone όσο είναι συνδεδεμένοι clients
Αναδημιουργήστε το token αν υποψιάζεστε ότι έχει εκτεθεί
Αντιγράψτε ξανά το URL του endpoint μετά από αλλαγή της διεύθυνσης LAN IP του iPhone σας

Υποστήριξη μέσω Chat

Συγκεντρώστε διαγνωστικά στοιχεία από τα event logs της εφαρμογής εξαγωγής μέσω Settings → Advanced → Export Event Logs. Δείτε τον Οδηγό Event Logs Εφαρμογής. Μοιραστείτε το δημιουργημένο αρχείο zip μέσω Chat Support ή email.