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

เชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Health Auto Export สำหรับไคลเอนต์ AI และสคริปต์บนเครือข่ายท้องถิ่นของคุณ

Last updated: July 14, 2026

ในหน้านี้

ภาพรวม
ข้อกำหนดเบื้องต้น
การเริ่มต้นเซิร์ฟเวอร์
การยืนยันตัวตน (HTTP)
HTTPS (TLS)
การเปิดใช้งาน HTTPS
การเชื่อถือ CA บนไคลเอนต์
การเปลี่ยน LAN IP บน iOS
ตัวอย่าง endpoint แบบ HTTPS
เวอร์ชันของสัญญา (Contract)
การตั้งค่าไคลเอนต์
Claude Code (CLI)
Claude Code / ไฟล์โครงการ (<code>.mcp.json</code>)
Cursor (<code>~/.cursor/mcp.json</code>)
VS Code (<code>.vscode/mcp.json</code>)
Codex CLI (<code>~/.codex/config.toml</code>)
mcp-remote (iOS / LAN)
อาร์กิวเมนต์ของเครื่องมือ
รูปแบบวันที่
TCP
เคล็ดลับ
การสนับสนุนทางแชท

คู่มือการเชื่อมต่อเซิร์ฟเวอร์

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

ไคลเอนต์ทำงานบน Mac ของคุณหรืออุปกรณ์อื่นในเครือข่ายเดียวกัน และเชื่อมต่อกับ endpoint ที่แสดงบน iPhone ของคุณ

ภาพรวม

การส่งข้อมูล	Endpoint
HTTP (แนะนำ)	`http://{LAN_IP}:9000/mcp` (หรือ `https://` เมื่อเปิดใช้งาน HTTPS)
TCP	`{LAN_IP}:9000` (ไม่มีการยืนยันตัวตน)

แทนที่ {LAN_IP} ด้วยที่อยู่ที่แสดงบนหน้าจอ Server ขณะที่เซิร์ฟเวอร์กำลังทำงาน

กรณีการใช้งาน:

เชื่อมต่อ 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 จากหน้าจอ Server
สิทธิ์ เครือข่ายท้องถิ่น บน iPhone
อุปกรณ์ไคลเอนต์: อยู่ใน Wi-Fi หรือเครือข่ายท้องถิ่นเดียวกันกับ iPhone; ต้องใช้ Node.js เฉพาะเมื่อใช้ mcp-remote (iOS / LAN)

การเริ่มต้นเซิร์ฟเวอร์

บน iPhone เปิด Server โดยใช้การนำทางแถบด้านข้าง
เลือก HTTP (แนะนำ) หรือ TCP
เปิดใช้งาน Use HTTPS ได้ตามต้องการ (คำแนะนำด้านล่าง)
แตะ Start Server
คัดลอก URL ของ endpoint และ bearer token

เซิร์ฟเวอร์จะหยุดทำงานโดยอัตโนมัติหาก Health Auto Export ถูกส่งไปทำงานเบื้องหลัง (ทั้ง HTTP และ TCP)

การยืนยันตัวตน (HTTP)

คำขอ HTTP ทั้งหมดต้องมี:

Authorization: Bearer <your-token>

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

HTTPS (TLS)

เมื่อเปิดใช้งาน Use HTTPS แอปจะสร้างผู้ออกใบรับรอง (CA) ส่วนตัวในเครื่องและใบรับรองเซิร์ฟเวอร์ที่ลงนามโดย CA นั้น ไคลเอนต์ต้องเชื่อถือ CA ที่ส่งออกก่อนจึงจะเชื่อมต่อผ่าน https:// ได้

การเปิดใช้งาน HTTPS

เปิดหน้า Server โดยใช้การนำทางแถบด้านข้าง
เปิด Use HTTPS
แตะ Export CA Certificate และใช้เมนูแชร์เพื่อส่งไฟล์ CA ผ่าน AirDrop หรือบันทึกไว้ในอุปกรณ์ไคลเอนต์แต่ละเครื่อง
เริ่มเซิร์ฟเวอร์ — ตรวจสอบว่า URL ของ endpoint เปลี่ยนเป็น https://

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

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

ส่งออก CA จากหน้าจอ Server บน iPhone
เปิดไฟล์ PEM ใน Keychain Access บน Mac ของไคลเอนต์
ตั้งค่า Trust → Always Trust

เวอร์ชัน Node ขั้นต่ำสำหรับ `--use-system-ca`

Node bridge (mcp-remote) จะใช้ 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 เชื่อถือ Keychain ของระบบทั้งหมด ไม่ใช่แค่ CA ของแอปนี้เท่านั้น NODE_EXTRA_CA_CERTS จำกัดความเชื่อถือไว้เฉพาะไฟล์ PEM เดียว (ตัวเลือกสำรองสำหรับ Node เวอร์ชันเก่า) แฟล็กนี้มีเอกสารสำหรับ macOS/Windows

ประเภทไคลเอนต์	การตั้งค่า
Cursor, VS Code, Claude Code, Codex	ความเชื่อถือ Keychain บน Mac ของไคลเอนต์ — ใช้ endpoint `https://` จากหน้าจอ Server
mcp-remote (iOS / LAN)	เชื่อถือ CA ใน Keychain บน 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 จะแสดงบนหน้าจอ Server เพื่อให้คุณตรวจสอบได้ว่าส่งออกใบรับรองที่ถูกต้อง

การเปลี่ยน LAN IP บน iOS

เมื่อ LAN IP ของ iPhone เปลี่ยนแปลง แอปจะสร้างใบรับรองเซิร์ฟเวอร์ใหม่ที่มี Subject Alternative Names ที่อัปเดตแล้ว และรีสตาร์ท HTTPS listener คัดลอก URL ของ endpoint ใหม่หาก IP เปลี่ยนไป ใบรับรอง CA จะยังคงเหมือนเดิม เว้นแต่คุณจะสร้างใหม่โดยปิดและเปิด HTTPS อีกครั้ง

ตัวอย่าง endpoint แบบ HTTPS

https://192.168.1.42:9000/mcp

แทนที่ host ด้วยค่าที่แสดงบนหน้าจอ Server

เวอร์ชันของสัญญา (Contract)

เวอร์ชัน	ชื่อเครื่องมือ TCP	หมายเหตุ
v1.1.0 (ค่าเริ่มต้น)	`get_*`	แนะนำสำหรับการตั้งค่าใหม่
v1.0.0	แบบเดิม (`health_metrics`, …)	อัปเดตความเข้ากันได้กับ Claude Desktop v1.0.0
v0.0.1	แบบเดิม	ความเข้ากันได้รุ่นเก่าที่สุด

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

การตั้งค่าไคลเอนต์

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

ตัวอย่างทั้งหมดด้านล่างใช้ที่อยู่ LAN ตัวอย่าง — แทนที่ด้วยที่อยู่ของ iPhone จากหน้าจอ Server

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

ส่งออก HAE_MCP_TOKEN ด้วย bearer token ของคุณก่อนเริ่ม Codex หลังจากตั้งค่าแล้ว รัน /mcp ในเซสชัน Codex เพื่อยืนยันว่าเซิร์ฟเวอร์เชื่อมต่อแล้ว

หากคุณสร้าง bearer token ใหม่ใน Health Auto Export ให้อัปเดต HAE_MCP_TOKEN และรัน codex mcp add อีกครั้ง หรือลบและเพิ่มรายการเซิร์ฟเวอร์ใหม่

mcp-remote (iOS / LAN)

สำหรับไคลเอนต์ที่รองรับเฉพาะ stdio (เช่น Claude Desktop) ที่ไม่สามารถเชื่อมต่อผ่าน HTTP ได้โดยตรง ต้องใช้ Node.js บน Mac ที่รันไคลเอนต์

เริ่มเซิร์ฟเวอร์บน iPhone และคัดลอก endpoint และ token
บน Mac ของคุณ เลือก mcp-remote (iOS / LAN) บนหน้าจอ Server และคัดลอกสคริปต์ 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:

ส่งออก CA จาก iPhone และเชื่อถือใน Keychain Access (Always Trust) บน Mac ของคุณ
ใช้ https://192.168.1.42:9000/mcp ใน args
เมื่อ Node มีเวอร์ชันตรงตามขั้นต่ำสำหรับ --use-system-ca (22.19.0 บน 22.x, 23.8.0 บน 23.x, 24.6.0 บน 24.x หรือรุ่น 25+ ใดก็ได้) ให้เพิ่ม:

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

บน Node เวอร์ชันเก่ากว่า ให้ตั้งค่า NODE_EXTRA_CA_CERTS เป็นเส้นทาง PEM ที่อ่านได้แทน รีสตาร์ทไคลเอนต์ stdio หลังจากอัปเดตการกำหนดค่า

การลดความล่าช้าในการเริ่มต้น: npx -y จะดาวน์โหลด mcp-remote ในการใช้งานครั้งแรกและตรวจสอบใหม่เมื่อแคชหมดอายุ ซึ่งอาจทำให้ล่าช้าหลายวินาที การติดตั้งล่วงหน้าแบบทั่วระบบจะช่วยขจัดปัญหานี้:

npm install -g mcp-remote@0.1.16

อาร์กิวเมนต์ของเครื่องมือ

รูปแบบวันที่

พารามิเตอร์ 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 แยกต่างหาก)

เคล็ดลับ

เก็บ Health Auto Export ให้อยู่ในโฟร์กราวด์บน iPhone ตลอดเวลาที่ไคลเอนต์เชื่อมต่ออยู่
สร้าง token ใหม่หากสงสัยว่ามันถูกเปิดเผย
คัดลอก URL ของ endpoint ใหม่หลังจาก LAN IP ของ iPhone เปลี่ยนแปลง

การสนับสนุนทางแชท

รวบรวมข้อมูลการวินิจฉัยจากบันทึกเหตุการณ์ของแอปส่งออกโดยไปที่ Settings → Advanced → Export Event Logs ดู คู่มือบันทึกเหตุการณ์ของแอป แชร์ไฟล์ zip ที่สร้างขึ้นผ่านการสนับสนุนทางแชทหรืออีเมล