HealthyApps Help Center

Sambung ke pelayan

Sambung ke pelayan MCP Health Auto Export untuk klien AI dan skrip pada rangkaian tempatan anda.

Last updated: July 14, 2026

Pada halaman ini

Panduan Sambungan Pelayan

Pelayan MCP pada iOS membolehkan klien AI dan skrip pada rangkaian tempatan anda menanya data kesihatan anda. HTTP (Streamable MCP) adalah pengangkutan yang disyorkan. iOS juga menyokong TCP untuk persediaan jambatan Node.

Klien berjalan pada Mac anda atau peranti lain pada rangkaian yang sama dan menyambung ke titik akhir yang dipaparkan pada iPhone anda.

Gambaran Keseluruhan

Pengangkutan Titik akhir
HTTP (disyorkan) http://{LAN_IP}:9000/mcp (atau https:// apabila HTTPS diaktifkan)
TCP {LAN_IP}:9000 (tanpa pengesahan)

Gantikan {LAN_IP} dengan alamat yang dipaparkan pada skrin Server semasa pelayan berjalan.

Kes penggunaan:

  • Sambungkan Claude Code, Codex, Cursor atau VS Code pada Mac anda ke data kesihatan pada iPhone anda
  • Gunakan mcp-remote (iOS / LAN) untuk klien yang hanya menyokong stdio seperti Claude Desktop
  • Tanya metrik dan senaman daripada skrip pada rangkaian tempatan anda (HTTP)
  • Integrasi TCP melalui jambatan Node health-auto-export-mcp-server

Prasyarat

  • Health Auto Export berjalan pada iPhone (aplikasi mesti kekal di latar depan semasa klien disambungkan)
  • Subskripsi Premium
  • HTTP: Token Bearer daripada skrin Server
  • Kebenaran Local Network pada iPhone
  • Peranti klien: Wi‑Fi atau LAN yang sama dengan iPhone; Node.js hanya diperlukan jika anda menggunakan mcp-remote (iOS / LAN)

Memulakan pelayan

  1. Pada iPhone, buka Server menggunakan navigasi bar sisi
  2. Pilih HTTP (disyorkan) atau TCP
  3. Secara pilihan, aktifkan Use HTTPS (lihat arahan di bawah)
  4. Ketik Start Server
  5. Salin URL titik akhir dan token Bearer

Pelayan berhenti secara automatik jika Health Auto Export dilatarbelakangkan (kedua-dua HTTP dan TCP).

Pengesahan (HTTP)

Semua permintaan HTTP memerlukan:

Authorization: Bearer <your-token>
  • Jana semula token daripada skrin Server jika dianggap perlu
  • Pada HTTP biasa, token dihantar melalui sambungan yang tidak disulitkan—gunakan hanya pada rangkaian yang dipercayai, atau aktifkan HTTPS
  • TCP legasi tiada pengesahan (tidak berubah)

HTTPS (TLS)

Apabila Use HTTPS diaktifkan, aplikasi menjana Certificate Authority (CA) tempatan persendirian dan sijil leaf pelayan yang ditandatangani oleh CA tersebut. Klien mesti mempercayai CA yang dieksport sebelum boleh menyambung melalui https://.

Mengaktifkan HTTPS

  1. Buka paparan Server menggunakan navigasi bar sisi
  2. Hidupkan Use HTTPS
  3. Ketik Export CA Certificate dan gunakan helaian kongsi untuk AirDrop atau simpan fail CA pada setiap peranti klien
  4. Mulakan pelayan — pastikan URL titik akhir bertukar kepada https://

Mempercayai CA pada klien

Percayai CA yang dieksport pada peranti yang menjalankan klien AI (biasanya Mac anda):

  1. Eksport CA daripada skrin Server pada iPhone
  2. Buka PEM dalam Keychain Access pada Mac klien
  3. Tetapkan Trust → Always Trust

Versi minimum Node untuk --use-system-ca

Jambatan Node (mcp-remote) hanya boleh menggunakan NODE_OPTIONS=--use-system-ca apabila Node memenuhi:

Siri Node Versi minimum
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ mana-mana

Pada Node yang lebih lama, tetapkan NODE_EXTRA_CA_CERTS kepada laluan PEM yang boleh dibaca oleh proses jambatan. Menggunakan --use-system-ca pada Node yang tidak disokong menghalang proses daripada bermula.

Skop kepercayaan: --use-system-ca mempercayai keseluruhan Keychain sistem, bukan hanya CA aplikasi ini. NODE_EXTRA_CA_CERTS mengehadkan kepercayaan kepada satu fail PEM (alternatif untuk Node yang lebih lama). Bendera ini didokumenkan untuk macOS/Windows.

Jenis klien Persediaan
Cursor, VS Code, Claude Code, Codex Kepercayaan Keychain pada Mac klien — gunakan titik akhir https:// daripada skrin Server
mcp-remote (iOS / LAN) Percayai CA dalam Keychain pada Mac yang menjalankan mcp-remote. Coretan menggunakan NODE_OPTIONS=--use-system-ca apabila Node memenuhi versi minimum; pada Node yang lebih lama, tetapkan NODE_EXTRA_CA_CERTS kepada laluan PEM yang boleh dibaca
curl / skrip Berikan --cacert /path/to/mcp-ca.pem, atau tetapkan NODE_EXTRA_CA_CERTS

Cap jari CA dipaparkan pada skrin Server supaya anda boleh mengesahkan bahawa anda telah mengeksport sijil yang betul.

Apabila IP LAN iOS berubah

Apabila IP LAN iPhone anda berubah, aplikasi menjana semula sijil leaf dengan Subject Alternative Names yang dikemas kini dan memulakan semula pendengar HTTPS. Salin semula URL titik akhir jika IP berubah. Sijil CA kekal sama melainkan anda menjana semulanya dengan mematikan dan menghidupkan semula HTTPS.

Contoh titik akhir HTTPS

https://192.168.1.42:9000/mcp

Gantikan hos dengan nilai yang dipaparkan pada skrin Server.

Versi kontrak

Versi Nama alat TCP Nota
v1.1.0 (lalai) get_* Disyorkan untuk persediaan baharu
v1.0.0 Legasi (health_metrics, …) Kemas kini keserasian Claude Desktop v1.0.0
v0.0.1 Legasi Keserasian paling lama

HTTP sentiasa menggunakan nama alat get_*; versi kontrak hanya menjejaskan lalai skema.

Konfigurasi klien

Skrin Server menyediakan coretan salin-tampal untuk setiap integrasi. Gunakan titik akhir dan token yang dipaparkan di sana. Sahkan format berdasarkan versi klien anda.

Semua contoh di bawah menggunakan alamat LAN pemegang tempat—gantikan dengan alamat iPhone anda daripada skrin Server.

Claude Code (CLI)

Jalankan pada Mac anda (memerlukan Claude Code CLI):

HTTP:

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

HTTPS (selepas mengeksport dan mempercayai CA pada Mac anda):

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

Claude Code / fail projek (.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 menyambung secara langsung melalui Streamable HTTP — tiada jambatan Node.js diperlukan. Konfigurasi berada dalam ~/.codex/config.toml (global) atau .codex/config.toml dalam direktori projek yang dipercayai.

CLI (disyorkan):

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 secara manual:

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

Eksport HAE_MCP_TOKEN dengan token Bearer anda sebelum memulakan Codex. Selepas persediaan, jalankan /mcp dalam sesi Codex untuk mengesahkan pelayan telah disambungkan.

Jika anda menjana semula token Bearer dalam Health Auto Export, kemas kini HAE_MCP_TOKEN dan jalankan semula codex mcp add, atau buang dan tambah semula entri pelayan tersebut.

mcp-remote (iOS / LAN)

Untuk klien yang hanya menyokong stdio (seperti Claude Desktop) yang tidak boleh menyambung melalui HTTP secara langsung. Memerlukan Node.js pada Mac yang menjalankan klien.

  1. Mulakan pelayan pada iPhone dan salin titik akhir serta token
  2. Pada Mac anda, pilih mcp-remote (iOS / LAN) pada skrin Server dan salin coretan JSON, atau tampalkan ini ke dalam konfigurasi MCP klien (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>"
  ]
}

Apabila HTTPS diaktifkan:

  1. Eksport CA daripada iPhone dan percayainya dalam Keychain Access (Always Trust) pada Mac anda
  2. Gunakan https://192.168.1.42:9000/mcp dalam args
  3. Apabila Node memenuhi versi minimum untuk --use-system-ca (22.19.0 pada 22.x, 23.8.0 pada 23.x, 24.6.0 pada 24.x, atau mana-mana keluaran 25+), tambahkan:
"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

Pada Node yang lebih lama, tetapkan NODE_EXTRA_CA_CERTS kepada laluan PEM yang boleh dibaca. Mulakan semula klien stdio selepas mengemas kini konfigurasi.

Mengurangkan kependaman permulaan: npx -y memuat turun mcp-remote semasa penggunaan pertama dan menyemak semula apabila cache tamat tempoh, yang boleh menyebabkan kelewatan beberapa saat. Memasang secara global lebih awal menghapuskan ini:

npm install -g mcp-remote@0.1.16

Argumen alat

Format tarikh

Parameter start dan end menerima dua format:

Format Contoh Nota
yyyy-MM-dd 2026-06-13 Tarikh mula: tengah malam; tarikh tamat: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Masa dan ofset zon waktu yang jelas

TCP

  • JSON-RPC tanpa penyulitan dan tanpa pengesahan pada port 9000
  • Gunakan kontrak v1.0.0 dengan jambatan Node health-auto-export-mcp-server untuk nama alat legasi
  • Gunakan kontrak v1.1.0 untuk nama alat TCP get_* (kemas kini jambatan Node secara berasingan)

Petua

  1. Kekalkan Health Auto Export di latar depan pada iPhone semasa klien disambungkan
  2. Jana semula token jika anda mengesyaki ia telah terdedah
  3. Salin semula URL titik akhir selepas IP LAN iPhone anda berubah

Sokongan Sembang

Kumpulkan diagnostik daripada log peristiwa aplikasi eksport dengan pergi ke Settings → Advanced → Export Event Logs. Lihat Panduan Log Peristiwa Aplikasi. Kongsikan fail zip yang dijana melalui Sokongan Sembang atau e-mel.