Sambung ke Pelayan

Pelayan MCP pada iOS membolehkan klien AI dan skrip pada rangkaian tempatan anda membuat pertanyaan terhadap data kesihatan anda. HTTP (Streamable MCP) ialah pengangkutan yang disyorkan. iOS juga menyokong TCP untuk persediaan Node-bridge.

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

Ikhtisar

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

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

Kes penggunaan:

• Sambungkan Claude Code, Codex, Cursor, atau VS Code pada Mac anda kepada data kesihatan pada iPhone anda
• Gunakan mcp-remote (iOS / LAN) untuk klien stdio sahaja seperti Claude Desktop
• Buat pertanyaan metrik dan senaman dari skrip pada rangkaian tempatan anda (HTTP)
• Integrasi TCP melalui Node bridge health-auto-export-mcp-server

Prasyarat

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

Memulakan pelayan

1. Pada iPhone, buka Server dari tab Eksport. Pada iPad, gunakan bar sisi.
2. Pilih HTTP (disyorkan) atau TCP
3. Secara pilihan dayakan Gunakan HTTPS (arahan di bawah)
4. Ketik Mulakan Pelayan
5. Salin URL titik akhir dan token bearer

Pelayan aktif berhenti secara automatik jika Health Auto Export dilatarbelakangkan, sama ada anda menggunakan HTTP atau TCP.

Pengesahan (HTTP)

Semua permintaan HTTP memerlukan:

Authorization: Bearer <your-token>

• Jana semula token dari skrin Server jika dianggap perlu
• Pada HTTP biasa, token dihantar melalui sambungan tidak disulitkan—gunakan hanya pada rangkaian dipercayai, atau dayakan HTTPS
• TCP legasi tiada pengesahan (tidak berubah)

HTTPS (TLS)

HTTPS menggunakan Certificate Authority (CA) yang dijana secara tempatan. Eksport dan percayai sijilnya pada setiap peranti klien sebelum menyambung melalui https://.

Mendayakan HTTPS

1. Buka paparan Server (iPhone: tab Eksport; iPad: bar sisi)
2. Hidupkan Gunakan HTTPS
3. Ketik Eksport Sijil CA 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 dari skrin Server pada iPhone
2. Buka PEM dalam Keychain Access pada Mac klien
3. Tetapkan Trust → Always Trust

Versi Node untuk persediaan yang dijana

Persediaan Node bridge yang dijana aplikasi menggunakan NODE_OPTIONS=--use-system-ca untuk versi Node ini:

Baris Node	Versi minimum
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	any

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

Skop kepercayaan: --use-system-ca mempercayai Keychain sistem penuh, bukan hanya CA aplikasi ini. NODE_EXTRA_CA_CERTS menambah CA yang dieksport kepada sijil dipercayai Node. Lihat pilihan sijil Node.

Jenis klien	Persediaan
Cursor, VS Code, Claude Code, Codex	Kepercayaan Keychain pada Mac klien — gunakan titik akhir https:// dari skrin Server
mcp-remote (iOS / LAN)	Percayai CA dalam Keychain pada Mac yang menjalankan mcp-remote. Snippet 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 ditunjukkan pada skrin Server supaya anda boleh mengesahkan bahawa anda mengeksport sijil yang betul.

Perubahan IP LAN iOS

Salin semula URL titik akhir jika alamat rangkaian iPhone anda berubah. Jika sijil CA pengganti disediakan, eksport dan kemas kini kepercayaan pada setiap peranti klien.

Contoh titik akhir HTTPS

https://192.168.1.42:9000/mcp

Gantikan hos dengan nilai yang ditunjukkan 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 tertua

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

Konfigurasi klien

Skrin Server termasuk snippet salin-tampal untuk setiap integrasi. Gunakan titik akhir dan token yang ditunjukkan di sana. Sahkan format terhadap versi klien anda.

Semua contoh di bawah menggunakan alamat LAN placeholder—gantikan dengan alamat iPhone anda dari 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 melalui Streamable HTTP secara langsung — tiada bridge Node.js diperlukan. Konfigurasi berada dalam ~/.codex/config.toml (global) atau .codex/config.toml dalam direktori projek 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

Konfigurasi 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

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

Jika anda menjana semula token bearer dalam Health Auto Export, kemas kini HAE_MCP_TOKEN dan jalankan semula codex mcp add, atau alih keluar dan tambah semula entri pelayan.

mcp-remote (iOS / LAN)

Untuk klien stdio sahaja (seperti Claude Desktop) yang tidak dapat 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 snippet JSON, atau tampal 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 didayakan:

1. Eksport CA dari iPhone dan percayai dalam Keychain Access (Always Trust) pada Mac anda
2. Gunakan https://192.168.1.42:9000/mcp dalam args
3. Untuk versi Node yang disokong persediaan yang dijana di atas, tambahkan objek env ini kepada objek konfigurasi pelayan yang sama:

{
  "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.

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 akhir: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Masa dan ofset zon waktu eksplisit

TCP

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

Tips

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

Mendapatkan Bantuan

Lihat Mendapatkan Bantuan untuk penyerahan sokongan dan Log Peristiwa Aplikasi untuk eksport diagnostik.