幫助中心 HealthyApps
繁體中文(香港)
幫助中心
主網站 ↗

搜尋說明主題

連線到伺服器

連線到 Health Auto Export MCP 伺服器,供本地網絡上的 AI 用戶端和指令碼使用。

最後更新: 2026年10月31日

本頁內容
概覽先決條件啟動伺服器身份驗證(HTTP)
HTTPS (TLS) HTTPS (TLS) 啟用 HTTPS在用戶端上信任 CAiOS LAN IP 變更HTTPS 端點範例
合約版本
用戶端設定 用戶端設定 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提示取得協助

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

啟動伺服器

  1. 在 iPhone 上從 匯出 標籤開啟 伺服器。在 iPad 上使用側邊欄。
  2. 選擇 HTTP(建議)或 TCP
  3. 可選擇啟用 使用 HTTPS(下方說明)
  4. 點一下 啟動伺服器
  5. 複製端點 URL 和 Bearer 權杖

無論使用 HTTP 還是 TCP,只要 Health Auto Export 進入背景,活動伺服器都會自動停止。

身份驗證(HTTP)

所有 HTTP 請求都需要:

Authorization: Bearer <your-token>
  • 必要時從伺服器螢幕重新產生權杖
  • 在明文 HTTP 上,權杖透過未加密連線傳送——僅在受信任網絡上使用,或啟用 HTTPS
  • 舊版 TCP 沒有身份驗證(不變)

HTTPS (TLS)

HTTPS 使用本地產生的憑證授權單位(CA)。在透過 https:// 連線之前,請在每台用戶端裝置上匯出並信任其憑證。

啟用 HTTPS

  1. 開啟 伺服器 檢視(iPhone:匯出 標籤;iPad:側邊欄)
  2. 開啟 使用 HTTPS
  3. 點一下 匯出 CA 憑證,並用分享表將 CA 檔案透過 AirDrop 傳送或儲存到每台用戶端裝置
  4. 啟動伺服器 — 確認端點 URL 切換為 https://

在用戶端上信任 CA

在 執行 AI 用戶端的裝置(通常是 Mac)上信任匯出的 CA:

  1. 從 iPhone 的伺服器螢幕匯出 CA
  2. 在用戶端 Mac 的 鑰匙圈存取 中開啟 PEM
  3. 將 信任 → 永遠信任 設為永遠信任

產生設定的 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。

  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. 從 iPhone 匯出 CA,並在 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

  • 連接埠 9000 上未加密、未驗證的 JSON-RPC
  • 對舊版工具名稱,將合約 v1.0.0 與 Node health-auto-export-mcp-server 橋一起使用
  • 對 get_* TCP 工具名稱使用合約 v1.1.0(單獨更新 Node 橋)

提示

  1. 用戶端連線時讓 Health Auto Export 保持在 iPhone 前景
  2. 若懷疑權杖已洩露,請重新產生
  3. iPhone 的 LAN IP 變更後重新複製端點 URL

取得協助

支援提交請參閱取得協助,診斷匯出請參閱 App 事件記錄。