Hubungkan ke Server

Server MCP di iOS memungkinkan klien AI dan skrip di jaringan lokal Anda mengkueri data kesehatan Anda. HTTP (Streamable MCP) adalah transport yang direkomendasikan. iOS juga mendukung TCP untuk penyiapan Node-bridge.

Klien berjalan di Mac Anda atau perangkat lain di jaringan yang sama dan terhubung ke titik akhir yang ditampilkan di iPhone Anda.

Ikhtisar

Transport	Titik akhir
HTTP (direkomendasikan)	http://{LAN_IP}:9000/mcp (atau https:// saat HTTPS diaktifkan)
TCP	{LAN_IP}:9000 (tanpa autentikasi)

Ganti {LAN_IP} dengan alamat yang ditampilkan di layar Server saat server berjalan.

Kasus penggunaan:

• Hubungkan Claude Code, Codex, Cursor, atau VS Code di Mac Anda ke data kesehatan di iPhone Anda
• Gunakan mcp-remote (iOS / LAN) untuk klien hanya-stdio seperti Claude Desktop
• Kueri metrik dan latihan dari skrip di jaringan lokal Anda (HTTP)
• Integrasi TCP melalui Node bridge health-auto-export-mcp-server

Prasyarat

• Health Auto Export di iPhone (aplikasi harus tetap di latar depan saat klien terhubung)
• Langganan Premium
• HTTP: Token Bearer dari layar Server
• Izin Jaringan Lokal di iPhone
• Perangkat klien: Wi‑Fi atau LAN yang sama dengan iPhone; Node.js hanya jika Anda menggunakan mcp-remote (iOS / LAN)

Memulai server

1. Di iPhone, buka Server dari tab Ekspor. Di iPad, gunakan bilah sisi.
2. Pilih HTTP (direkomendasikan) atau TCP
3. Secara opsional aktifkan Gunakan HTTPS (instruksi di bawah)
4. Ketuk Mulai Server
5. Salin URL titik akhir dan token bearer

Server aktif berhenti secara otomatis jika Health Auto Export masuk latar belakang, baik Anda menggunakan HTTP maupun TCP.

Autentikasi (HTTP)

Semua permintaan HTTP memerlukan:

Authorization: Bearer <your-token>

• Regenerasi token dari layar Server jika dianggap perlu
• Di HTTP biasa, token dikirim melalui koneksi yang tidak dienkripsi—gunakan hanya di jaringan tepercaya, atau aktifkan HTTPS
• TCP lama tidak memiliki autentikasi (tidak berubah)

HTTPS (TLS)

HTTPS menggunakan Certificate Authority (CA) yang dihasilkan secara lokal. Ekspor dan percayai sertifikatnya di setiap perangkat klien sebelum terhubung melalui https://.

Mengaktifkan HTTPS

1. Buka tampilan Server (iPhone: tab Ekspor; iPad: bilah sisi)
2. Aktifkan Gunakan HTTPS
3. Ketuk Ekspor Sertifikat CA dan gunakan lembar berbagi untuk AirDrop atau menyimpan file CA di setiap perangkat klien
4. Mulai server — pastikan URL titik akhir beralih ke https://

Mempercayai CA di klien

Percayai CA yang diekspor di perangkat yang menjalankan klien AI (biasanya Mac Anda):

1. Ekspor CA dari layar Server di iPhone
2. Buka PEM di Keychain Access di Mac klien
3. Atur Trust → Always Trust

Versi Node untuk penyiapan yang dihasilkan

Penyiapan Node bridge yang dihasilkan aplikasi menggunakan NODE_OPTIONS=--use-system-ca untuk versi Node berikut:

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

Di Node yang lebih lama, atur NODE_EXTRA_CA_CERTS ke jalur PEM yang dapat dibaca proses bridge. Mengeluarkan --use-system-ca di Node yang tidak didukung mencegah proses dimulai.

Cakupan kepercayaan: --use-system-ca mempercayai Keychain sistem penuh, bukan hanya CA aplikasi ini. NODE_EXTRA_CA_CERTS menambahkan CA yang diekspor ke sertifikat tepercaya Node. Lihat opsi sertifikat Node.

Jenis klien	Penyiapan
Cursor, VS Code, Claude Code, Codex	Kepercayaan Keychain di Mac klien — gunakan titik akhir https:// dari layar Server
mcp-remote (iOS / LAN)	Percayai CA di Keychain di Mac yang menjalankan mcp-remote. Snippet menggunakan NODE_OPTIONS=--use-system-ca saat Node memenuhi versi minimum; di Node yang lebih lama atur NODE_EXTRA_CA_CERTS ke jalur PEM yang dapat dibaca
curl / skrip	Berikan --cacert /path/to/mcp-ca.pem atau atur NODE_EXTRA_CA_CERTS

Sidik jari CA ditampilkan di layar Server sehingga Anda dapat memverifikasi bahwa Anda mengekspor sertifikat yang benar.

Perubahan IP LAN iOS

Salin ulang URL titik akhir jika alamat jaringan iPhone Anda berubah. Jika sertifikat CA pengganti disediakan, ekspor dan perbarui kepercayaan di setiap perangkat klien.

Contoh titik akhir HTTPS

https://192.168.1.42:9000/mcp

Ganti host dengan nilai yang ditampilkan di layar Server.

Versi kontrak

Versi	Nama alat TCP	Catatan
v1.1.0 (default)	get_*	Direkomendasikan untuk penyiapan baru
v1.0.0	Lama (health_metrics, …)	Pembaruan kompatibilitas Claude Desktop v1.0.0
v0.0.1	Lama	Kompatibilitas tertua

HTTP selalu menggunakan nama alat get_*; versi kontrak hanya memengaruhi default skema.

Konfigurasi klien

Layar Server mencakup snippet salin-tempel untuk setiap integrasi. Gunakan titik akhir dan token yang ditampilkan di sana. Verifikasi format terhadap versi klien Anda.

Semua contoh di bawah menggunakan alamat LAN placeholder—ganti dengan alamat iPhone Anda dari layar Server.

Claude Code (CLI)

Jalankan di 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 (setelah mengekspor dan mempercayai CA di Mac Anda):

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

Claude Code / file proyek (.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 terhubung melalui Streamable HTTP secara langsung — tidak diperlukan bridge Node.js. Konfigurasi berada di ~/.codex/config.toml (global) atau .codex/config.toml di direktori proyek tepercaya.

CLI (direkomendasikan):

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

Ekspor HAE_MCP_TOKEN dengan token bearer Anda sebelum memulai Codex. Setelah penyiapan, jalankan /mcp di dalam sesi Codex untuk memverifikasi server terhubung.

Jika Anda meregenerasi token bearer di Health Auto Export, perbarui HAE_MCP_TOKEN dan jalankan ulang codex mcp add, atau hapus dan tambahkan kembali entri server.

mcp-remote (iOS / LAN)

Untuk klien hanya-stdio (seperti Claude Desktop) yang tidak dapat terhubung melalui HTTP secara langsung. Memerlukan Node.js di Mac yang menjalankan klien.

1. Mulai server di iPhone dan salin titik akhir serta token
2. Di Mac Anda, pilih mcp-remote (iOS / LAN) di layar Server dan salin snippet JSON, atau tempel ini ke 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>"
  ]
}

Saat HTTPS diaktifkan:

1. Ekspor CA dari iPhone dan percayai di Keychain Access (Always Trust) di Mac Anda
2. Gunakan https://192.168.1.42:9000/mcp di args
3. Untuk versi Node yang didukung penyiapan yang dihasilkan di atas, tambahkan objek env ini ke objek konfigurasi server yang sama:

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

Di Node yang lebih lama, atur NODE_EXTRA_CA_CERTS ke jalur PEM yang dapat dibaca. Mulai ulang klien stdio setelah memperbarui konfigurasi.

Argumen alat

Format tanggal

Parameter start dan end menerima dua format:

Format	Contoh	Catatan
yyyy-MM-dd	2026-06-13	Tanggal mulai: tengah malam; tanggal akhir: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Waktu dan offset zona waktu eksplisit

TCP

• JSON-RPC tidak terenkripsi, tanpa autentikasi di port 9000
• Gunakan kontrak v1.0.0 dengan bridge Node health-auto-export-mcp-server untuk nama alat lama
• Gunakan kontrak v1.1.0 untuk nama alat TCP get_* (perbarui bridge Node secara terpisah)

Tips

1. Biarkan Health Auto Export di latar depan di iPhone saat klien terhubung
2. Regenerasi token jika Anda mencurigainya terekspos
3. Salin ulang URL titik akhir setelah IP LAN iPhone Anda berubah

Mendapatkan Bantuan

Lihat Mendapatkan Bantuan untuk pengiriman dukungan dan Log Peristiwa Aplikasi untuk ekspor diagnostik.