連線到伺服器
連線到 Health Auto Export MCP 伺服器,供本地網絡上的 AI 用戶端和指令碼使用。
最後更新: 2026年10月31日
本頁內容
iOS 上的 MCP 伺服器讓本地網絡上的 AI 用戶端和指令碼可以查詢健康資料。HTTP(Streamable MCP)是建議的傳輸方式。 iOS 還支援用於 Node 橋接設定的 TCP。
用戶端在同一網絡上的 Mac 或其他裝置上執行,並連線到 iPhone 上顯示的端點。
概覽
| 傳輸 | 端點 |
|---|---|
| HTTP(建議) | http://{LAN_IP}:9000/mcp(啟用 HTTPS 時為 https://) |
| TCP | {LAN_IP}:9000(未經驗證) |
將 {LAN_IP} 替換為伺服器執行時在 伺服器 螢幕上顯示的位址。
使用情境:
- 將 Mac 上的 Claude Code、Codex、Cursor 或 VS Code 連線到 iPhone 上的健康資料
- 對 Claude Desktop 等僅支援 stdio 的用戶端使用 mcp-remote (iOS / LAN)
- 從本地網絡上的指令碼查詢指標和體能訓練(HTTP)
- 透過 health-auto-export-mcp-server Node 橋進行 TCP 整合
先決條件
- iPhone 上的 Health Auto Export(用戶端連線時 App 必須保持在 前景)
- Premium 訂閱
- HTTP: 伺服器螢幕上的 Bearer 權杖
- iPhone 上的 本地網絡 權限
- 用戶端裝置: 與 iPhone 同一 Wi‑Fi 或 LAN;僅在使用 mcp-remote (iOS / LAN) 時需要 Node.js
啟動伺服器
- 在 iPhone 上從 匯出 標籤開啟 伺服器。在 iPad 上使用側邊欄。
- 選擇 HTTP(建議)或 TCP
- 可選擇啟用 使用 HTTPS(下方說明)
- 點一下 啟動伺服器
- 複製端點 URL 和 Bearer 權杖
無論使用 HTTP 還是 TCP,只要 Health Auto Export 進入背景,活動伺服器都會自動停止。
身份驗證(HTTP)
所有 HTTP 請求都需要:
Authorization: Bearer <your-token>
- 必要時從伺服器螢幕重新產生權杖
- 在明文 HTTP 上,權杖透過未加密連線傳送——僅在受信任網絡上使用,或啟用 HTTPS
- 舊版 TCP 沒有身份驗證(不變)
HTTPS (TLS)
HTTPS 使用本地產生的憑證授權單位(CA)。在透過 https:// 連線之前,請在每台用戶端裝置上匯出並信任其憑證。
啟用 HTTPS
- 開啟 伺服器 檢視(iPhone:匯出 標籤;iPad:側邊欄)
- 開啟 使用 HTTPS
- 點一下 匯出 CA 憑證,並用分享表將 CA 檔案透過 AirDrop 傳送或儲存到每台用戶端裝置
- 啟動伺服器 — 確認端點 URL 切換為
https://
在用戶端上信任 CA
在 執行 AI 用戶端的裝置(通常是 Mac)上信任匯出的 CA:
- 從 iPhone 的伺服器螢幕匯出 CA
- 在用戶端 Mac 的 鑰匙圈存取 中開啟 PEM
- 將 信任 → 永遠信任 設為永遠信任
產生設定的 Node 版本
App 產生的 Node 橋設定對這些 Node 版本使用 NODE_OPTIONS=--use-system-ca:
| Node 系列 | 最低版本 |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | any |
在較舊的 Node 上,改為將 NODE_EXTRA_CA_CERTS 設為橋接行程可讀的 PEM 路徑。在不支援的 Node 上發出 --use-system-ca 會阻止行程啟動。
信任範圍:
--use-system-ca信任整個系統鑰匙圈,而不僅是此 App 的 CA。NODE_EXTRA_CA_CERTS將匯出的 CA 加入 Node 的受信任憑證。請參閱 Node 憑證選項。
| 用戶端類型 | 設定 |
|---|---|
| Cursor、VS Code、Claude Code、Codex | 在用戶端 Mac 上信任鑰匙圈 — 使用伺服器螢幕上的 https:// 端點 |
| mcp-remote (iOS / LAN) | 在執行 mcp-remote 的 Mac 上於鑰匙圈中信任 CA。當 Node 符合最低版本時,程式碼片段使用 NODE_OPTIONS=--use-system-ca;在較舊 Node 上將 NODE_EXTRA_CA_CERTS 設為可讀 PEM 路徑 |
| curl / 指令碼 | 傳遞 --cacert /path/to/mcp-ca.pem 或設定 NODE_EXTRA_CA_CERTS |
伺服器螢幕會顯示 CA 指紋,以便你確認匯出了正確的憑證。
iOS LAN IP 變更
若 iPhone 的網絡位址發生變化,請重新複製端點 URL。若提供了替換 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(在 Mac 上匯出並信任 CA 之後):
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 橋。設定位於 ~/.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 前用 Bearer 權杖匯出 HAE_MCP_TOKEN。設定後,在 Codex 工作階段中執行 /mcp 以驗證伺服器已連線。
若在 Health Auto Export 中重新產生 Bearer 權杖,請更新 HAE_MCP_TOKEN 並重新執行 codex mcp add,或刪除後重新新增伺服器項目。
mcp-remote (iOS / LAN)
用於無法直接透過 HTTP 連線的僅 stdio 用戶端(例如 Claude Desktop)。需要在執行用戶端的 Mac 上安裝 Node.js。
- 在 iPhone 上啟動伺服器並複製端點和權杖
- 在 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 時:
- 從 iPhone 匯出 CA,並在 Mac 的 鑰匙圈存取 中信任(永遠信任)
- 將
https://192.168.1.42:9000/mcp用於args - 對於上方產生設定支援的 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
- 連接埠 9000 上未加密、未驗證的 JSON-RPC
- 對舊版工具名稱,將合約 v1.0.0 與 Node
health-auto-export-mcp-server橋一起使用 - 對
get_* TCP 工具名稱使用合約 v1.1.0(單獨更新 Node 橋)
提示
- 用戶端連線時讓 Health Auto Export 保持在 iPhone 前景
- 若懷疑權杖已洩露,請重新產生
- iPhone 的 LAN IP 變更後重新複製端點 URL