เชื่อมต่อกับเซิร์ฟเวอร์

เซิร์ฟเวอร์ MCP บน iOS ให้ไคลเอนต์ AI และสคริปต์บนเครือข่ายท้องถิ่นของคุณสอบถามข้อมูลสุขภาพได้ HTTP (Streamable MCP) เป็นทรานสปอร์ตที่แนะนำ iOS ยังรองรับ TCP สำหรับการตั้งค่า Node bridge

ไคลเอนต์รันบน 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 bridge 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>

• สร้างโทเค็นใหม่จากหน้าจอเซิร์ฟเวอร์เมื่อจำเป็น
• บน HTTP ธรรมดา โทเค็นถูกส่งผ่านการเชื่อมต่อที่ไม่เข้ารหัส—ใช้เฉพาะบนเครือข่ายที่เชื่อถือ หรือเปิด HTTPS
• TCP แบบเดิม ไม่มีการยืนยันตัวตน (ไม่เปลี่ยนแปลง)

HTTPS (TLS)

HTTPS ใช้ Certificate Authority (CA) ที่สร้างในเครื่อง ส่งออกและเชื่อถือใบรับรองบนอุปกรณ์ไคลเอนต์แต่ละเครื่องก่อนเชื่อมต่อผ่าน https://

เปิดใช้ HTTPS

1. เปิดมุมมอง เซิร์ฟเวอร์ (iPhone: แท็บ ส่งออก; iPad: แถบด้านข้าง)
2. เปิด ใช้ HTTPS
3. แตะ ส่งออกใบรับรอง CA แล้วใช้แผ่นแชร์เพื่อ AirDrop หรือบันทึกไฟล์ CA บนอุปกรณ์ไคลเอนต์แต่ละเครื่อง
4. เริ่มเซิร์ฟเวอร์ — ให้แน่ใจว่า URL ปลายทางเปลี่ยนเป็น https://

เชื่อถือ CA บนไคลเอนต์

เชื่อถือ CA ที่ส่งออกบน อุปกรณ์ที่รันไคลเอนต์ AI (มักเป็น Mac ของคุณ):

1. ส่งออก CA จากหน้าจอเซิร์ฟเวอร์บน iPhone
2. เปิด PEM ใน การเข้าถึงพวงกุญแจ บน Mac ไคลเอนต์
3. ตั้ง ความเชื่อถือ → เชื่อถือเสมอ

เวอร์ชัน Node สำหรับการตั้งค่าที่สร้างให้

การตั้งค่า Node bridge ที่แอปสร้างใช้ NODE_OPTIONS=--use-system-ca สำหรับเวอร์ชัน Node เหล่านี้:

สาย Node	เวอร์ชันขั้นต่ำ
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	ใดก็ได้

บน Node เก่ากว่า ตั้ง NODE_EXTRA_CA_CERTS เป็นเส้นทาง PEM ที่กระบวนการ bridge อ่านได้ การส่ง --use-system-ca บน Node ที่ไม่รองรับจะทำให้กระบวนการเริ่มไม่ได้

ขอบเขตความเชื่อถือ: --use-system-ca เชื่อถือพวงกุญแจระบบทั้งหมด ไม่ใช่เฉพาะ CA ของแอปนี้ NODE_EXTRA_CA_CERTS เพิ่ม CA ที่ส่งออกไปยังใบรับรองที่ Node เชื่อถือ ดู ตัวเลือกใบรับรองของ Node

ประเภทไคลเอนต์	การตั้งค่า
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	แบบเดิม (health_metrics, …)	อัปเดตความเข้ากันได้ Claude Desktop v1.0.0
v0.0.1	แบบเดิม	ความเข้ากันได้เก่าที่สุด

HTTP ใช้ชื่อเครื่องมือ get_* เสมอ เวอร์ชันสัญญาส่งผลเฉพาะค่าเริ่มต้นของสคีมา

การกำหนดค่าไคลเอนต์

หน้าจอเซิร์ฟเวอร์มีสนิปเป็ตคัดลอกวางสำหรับแต่ละการรวม ใช้ปลายทางและโทเค็นที่แสดงที่นั่น ตรวจรูปแบบตามเวอร์ชันไคลเอนต์ของคุณ

ตัวอย่างด้านล่างทั้งหมดใช้ที่อยู่ 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 bridge การกำหนดค่าอยู่ใน ~/.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

ก่อนเริ่ม Codex ส่งออก HAE_MCP_TOKEN ด้วย bearer token ของคุณ หลังตั้งค่า รัน /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 แล้วคัดลอกปลายทางและโทเค็น
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
• ใช้สัญญา v1.0.0 กับ Node bridge health-auto-export-mcp-server สำหรับชื่อเครื่องมือแบบเดิม
• ใช้สัญญา v1.1.0 สำหรับชื่อเครื่องมือ TCP get_* (อัปเดต Node bridge แยก)

เคล็ดลับ

1. ให้ Health Auto Export อยู่ที่พื้นหน้าบน iPhone ขณะไคลเอนต์เชื่อมต่อ
2. สร้างโทเค็นใหม่หากสงสัยว่าถูกเปิดเผย
3. คัดลอก URL ปลายทางใหม่หลัง LAN IP ของ iPhone เปลี่ยน

ขอความช่วยเหลือ

ดู ขอความช่วยเหลือ สำหรับการส่งรายงานสนับสนุน และ บันทึกเหตุการณ์แอป สำหรับการส่งออกวินิจฉัย