HealthyApps Help Center

Hubungkan ke Server

Hubungkan ke server MCP Health Auto Export untuk klien AI dan skrip di jaringan lokal Anda.

Last updated: July 14, 2026

Di halaman ini

Panduan Koneksi Server

Server MCP di iOS memungkinkan klien AI dan skrip di jaringan lokal Anda melakukan kueri terhadap 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 endpoint yang ditampilkan di iPhone Anda.

Ringkasan

Transport Endpoint
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:

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

Persyaratan

  • Health Auto Export berjalan di iPhone (aplikasi harus tetap berada di latar depan selama klien terhubung)
  • Berlangganan Premium
  • HTTP: Token Bearer dari layar Server
  • Izin Local Network di iPhone
  • Perangkat klien: Berada di Wi‑Fi atau LAN yang sama dengan iPhone; Node.js hanya diperlukan jika Anda menggunakan mcp-remote (iOS / LAN)

Memulai server

  1. Di iPhone, buka Server menggunakan navigasi sidebar
  2. Pilih HTTP (direkomendasikan) atau TCP
  3. Secara opsional aktifkan Use HTTPS (lihat petunjuk di bawah)
  4. Ketuk Start Server
  5. Salin URL endpoint dan token Bearer

Server akan berhenti secara otomatis jika Health Auto Export dipindahkan ke latar belakang (baik HTTP maupun TCP).

Autentikasi (HTTP)

Semua permintaan HTTP memerlukan:

Authorization: Bearer <your-token>
  • Buat ulang token dari layar Server jika dianggap perlu
  • Pada HTTP biasa, token dikirim melalui koneksi yang tidak dienkripsi—gunakan hanya pada jaringan yang tepercaya, atau aktifkan HTTPS
  • TCP lama tidak memiliki autentikasi (tidak berubah)

HTTPS (TLS)

Saat Use HTTPS diaktifkan, aplikasi menghasilkan Certificate Authority (CA) lokal pribadi dan sertifikat leaf server yang ditandatangani oleh CA tersebut. Klien harus mempercayai CA yang diekspor sebelum dapat terhubung melalui https://.

Mengaktifkan HTTPS

  1. Buka tampilan Server menggunakan navigasi sidebar
  2. Aktifkan Use HTTPS
  3. Ketuk Export CA Certificate dan gunakan share sheet untuk mengirim via AirDrop atau menyimpan file CA di setiap perangkat klien
  4. Mulai server — pastikan URL endpoint berganti menjadi https://

Mempercayai CA pada klien

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

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

Versi minimum Node untuk --use-system-ca

Node bridge (mcp-remote) hanya dapat menggunakan NODE_OPTIONS=--use-system-ca jika Node memenuhi:

Rilis Node Versi minimum
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ apa pun

Pada Node yang lebih lama, atur NODE_EXTRA_CA_CERTS ke jalur PEM yang dapat dibaca oleh proses bridge. Menyertakan --use-system-ca pada Node yang tidak didukung akan mencegah proses untuk dimulai.

Ruang lingkup kepercayaan: --use-system-ca mempercayai seluruh Keychain sistem, bukan hanya CA aplikasi ini. NODE_EXTRA_CA_CERTS membatasi kepercayaan pada satu file PEM (fallback untuk Node yang lebih lama). Flag ini didokumentasikan untuk macOS/Windows.

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

Fingerprint CA ditampilkan di layar Server sehingga Anda dapat memverifikasi bahwa Anda telah mengekspor sertifikat yang benar.

Saat IP LAN iOS berubah

Ketika IP LAN iPhone Anda berubah, aplikasi akan menghasilkan ulang sertifikat leaf dengan Subject Alternative Names yang diperbarui dan memulai ulang listener HTTPS. Salin ulang URL endpoint jika IP berubah. Sertifikat CA tetap sama kecuali Anda menghasilkannya ulang dengan mengaktifkan/menonaktifkan HTTPS.

Contoh endpoint HTTPS

https://192.168.1.42:9000/mcp

Ganti host dengan nilai yang ditampilkan di layar Server.

Versi kontrak

Versi Nama tool 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 paling lawas

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

Konfigurasi klien

Layar Server menyediakan cuplikan siap-salin untuk setiap integrasi. Gunakan endpoint dan token yang ditampilkan di sana. Verifikasi format sesuai versi klien Anda.

Semua contoh di bawah menggunakan alamat LAN placeholder—gantikan 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 langsung melalui Streamable HTTP — tidak memerlukan Node.js bridge. Konfigurasi berada di ~/.codex/config.toml (global) atau .codex/config.toml dalam 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

config.toml manual:

[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 bahwa server telah terhubung.

Jika Anda membuat ulang token Bearer di Health Auto Export, perbarui HAE_MCP_TOKEN dan jalankan ulang codex mcp add, atau hapus dan tambahkan ulang entri server tersebut.

mcp-remote (iOS / LAN)

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

  1. Mulai server di iPhone dan salin endpoint serta token
  2. Di Mac Anda, pilih mcp-remote (iOS / LAN) pada layar Server dan salin cuplikan JSON, atau tempelkan 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) pada Mac Anda
  2. Gunakan https://192.168.1.42:9000/mcp pada args
  3. Saat 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 rilis 25+ mana pun), tambahkan:
"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

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

Mengurangi latensi startup: npx -y mengunduh mcp-remote saat pertama kali digunakan dan memeriksa ulang saat cache kedaluwarsa, yang dapat menyebabkan penundaan beberapa detik. Menginstal secara global sebelumnya menghilangkan hal ini:

npm install -g mcp-remote@0.1.16

Argumen tool

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 eksplisit dan offset zona waktu

TCP

  • JSON-RPC tanpa enkripsi dan tanpa autentikasi pada port 9000
  • Gunakan kontrak v1.0.0 dengan Node bridge health-auto-export-mcp-server untuk nama tool lama
  • Gunakan kontrak v1.1.0 untuk nama tool TCP get_* (perbarui Node bridge secara terpisah)

Tips

  1. Jaga Health Auto Export tetap di latar depan pada iPhone selama klien terhubung
  2. Buat ulang token jika Anda mencurigai token tersebut telah terekspos
  3. Salin ulang URL endpoint setelah IP LAN iPhone Anda berubah

Dukungan Chat

Kumpulkan diagnostik dari log peristiwa aplikasi ekspor dengan membuka Settings → Advanced → Export Event Logs. Lihat Panduan Log Peristiwa Aplikasi. Bagikan file zip yang dihasilkan melalui Dukungan Chat atau email.