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

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

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

Επισκόπηση

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

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

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

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

Προϋποθέσεις

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

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

1. Στο iPhone ανοίξτε Διακομιστής από την καρτέλα Εξαγωγή. Στο iPad χρησιμοποιήστε την πλευρική γραμμή.
2. Επιλέξτε HTTP (προτεινόμενο) ή TCP
3. Προαιρετικά ενεργοποιήστε Χρήση HTTPS (οδηγίες παρακάτω)
4. Πατήστε Έναρξη διακομιστή
5. Αντιγράψτε τη URL τελικού σημείου και το bearer token

Ο ενεργός διακομιστής σταματά αυτόματα αν το Health Auto Export μεταφερθεί στο παρασκήνιο, είτε χρησιμοποιείτε HTTP είτε TCP.

Έλεγχος ταυτότητας (HTTP)

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

Authorization: Bearer <your-token>

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

HTTPS (TLS)

Το HTTPS χρησιμοποιεί τοπικά παραγόμενη αρχή πιστοποιητικών (CA). Εξάγετε και εμπιστευθείτε το πιστοποιητικό της σε κάθε συσκευή πελάτη πριν συνδεθείτε μέσω https://.

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

1. Ανοίξτε την προβολή Διακομιστής (iPhone: καρτέλα Εξαγωγή· iPad: πλευρική γραμμή)
2. Ενεργοποιήστε Χρήση HTTPS
3. Πατήστε Εξαγωγή πιστοποιητικού CA και μεταφέρετε το αρχείο CA με AirDrop ή αποθήκευση σε κάθε συσκευή πελάτη
4. Ξεκινήστε τον διακομιστή — βεβαιωθείτε ότι η URL τελικού σημείου αλλάζει σε https://

Εμπιστοσύνη του CA σε πελάτες

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

1. Εξάγετε το CA από την οθόνη Διακομιστής στο iPhone
2. Ανοίξτε το PEM στην Πρόσβαση στο μπρελόκ στο Mac πελάτη
3. Ορίστε Εμπιστοσύνη → Εμπιστοσύνη πάντα

Εκδόσεις Node για τη δημιουργημένη ρύθμιση

Η δημιουργημένη ρύθμιση γέφυρας Node της εφαρμογής χρησιμοποιεί NODE_OPTIONS=--use-system-ca για αυτές τις εκδόσεις Node:

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

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

Εύρος εμπιστοσύνης: Το --use-system-ca εμπιστεύεται ολόκληρο το μπρελόκ συστήματος, όχι μόνο το CA αυτής της εφαρμογής. Το NODE_EXTRA_CA_CERTS προσθέτει το εξαγόμενο CA στα αξιόπιστα πιστοποιητικά του Node. Δείτε Node certificate options.

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

Το αποτύπωμα CA εμφανίζεται στην οθόνη Διακομιστής ώστε να επαληθεύσετε ότι εξάγατε το σωστό πιστοποιητικό.

Αλλαγές LAN IP iOS

Αντιγράψτε ξανά τη URL τελικού σημείου αν αλλάξει η διεύθυνση δικτύου του iPhone. Αν παρέχεται αντικαταστατικό πιστοποιητικό CA, εξάγετέ το και ενημερώστε την εμπιστοσύνη σε κάθε συσκευή πελάτη.

Παράδειγμα τελικού σημείου HTTPS

https://192.168.1.42:9000/mcp

Αντικαταστήστε τον κεντρικό υπολογιστή με την τιμή που εμφανίζεται στην οθόνη Διακομιστής.

Έκδοση σύμβασης

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

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

Διαμόρφωση πελάτη

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

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

Claude Code (CLI)

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

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 — δεν απαιτείται γέφυρα 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)

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

1. Ξεκινήστε τον διακομιστή στο iPhone και αντιγράψτε το τελικό σημείο και το token
2. Στο Mac επιλέξτε mcp-remote (iOS / LAN) στην οθόνη Διακομιστής και αντιγράψτε το απόσπασμα JSON ή επικολλήστε το στη διαμόρφωση MCP του πελάτη (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:

1. Εξάγετε το CA από το iPhone και εμπιστευθείτε το στην Πρόσβαση στο μπρελόκ (Εμπιστοσύνη πάντα) στο Mac
2. Χρησιμοποιήστε https://192.168.1.42:9000/mcp στο args
3. Για εκδόσεις Node που υποστηρίζονται από τη δημιουργημένη ρύθμιση παραπάνω, προσθέστε αυτό το αντικείμενο env στο ίδιο αντικείμενο διαμόρφωσης διακομιστή:

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

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

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

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

Οι παράμετροι 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	Ρητή ώρα και μετατόπιση ζώνης ώρας

TCP

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

Συμβουλές

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

Λήψη βοήθειας

Για υποβολή υποστήριξης δείτε Λήψη βοήθειας και για διαγνωστικές εξαγωγές Αρχεία καταγραφής συμβάντων εφαρμογής.