HealthyApps Help Center

連接到伺服器

連接到 Health Auto Export 的 MCP 伺服器，供本地網絡上的 AI 用戶端和腳本使用。

Last updated: July 14, 2026

本頁內容

伺服器連線指南

iOS 上的 MCP 伺服器可讓本地網絡上的 AI 用戶端和腳本查詢您的健康資料。HTTP（Streamable MCP）是建議的傳輸方式。 iOS 亦支援 TCP，用於 Node 橋接方案。

用戶端在您的 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 必須保持在前景）
  • 進階訂閱
  • HTTP： 來自伺服器畫面的 Bearer 權杖
  • iPhone 的本地網絡權限
  • 用戶端裝置： 與 iPhone 處於同一 Wi‑Fi 或本地網絡；僅在使用 mcp-remote（iOS / LAN） 時才需要 Node.js

啟動伺服器

  1. 在 iPhone 上，使用側邊欄導覽開啟伺服器
  2. 選擇 HTTP（建議）或 TCP
  3. 可選擇啟用使用 HTTPS（見下方說明）
  4. 點按啟動伺服器
  5. 複製端點 URL 和 Bearer 權杖

若 Health Auto Export 進入背景，伺服器會自動停止（HTTP 和 TCP 皆如此）。

驗證（HTTP）

所有 HTTP 請求都需要：

Authorization: Bearer <your-token>
  • 如認為有需要，可在伺服器畫面上重新產生權杖
  • 在一般 HTTP 下，權杖會透過未加密的連線傳送——請只在受信任的網絡上使用，或啟用 HTTPS
  • 舊版 TCP 沒有驗證機制（維持不變）

HTTPS (TLS)

啟用使用 HTTPS 後，App 會產生一個私有的本地證書授權機構（CA），以及由該 CA 簽發的伺服器葉證書。用戶端必須先信任已匯出的 CA，才能透過 https:// 連線。

啟用 HTTPS

  1. 使用側邊欄導覽開啟伺服器畫面
  2. 開啟使用 HTTPS
  3. 點按匯出 CA 證書，並使用分享工作表將 CA 檔案以 AirDrop 傳送或儲存到每部用戶端裝置
  4. 啟動伺服器——確認端點 URL 已切換為 https://

在用戶端上信任 CA

在運行 AI 用戶端的裝置（通常是您的 Mac）上信任已匯出的 CA：

  1. 在 iPhone 的伺服器畫面上匯出 CA
  2. 在用戶端 Mac 的鑰匙串存取中開啟 PEM 檔案
  3. 將信任 → 永遠信任設為對應選項

--use-system-ca 所需的 Node 最低版本

Node 橋接程式（mcp-remote）只有在 Node 符合以下條件時，才可以使用 NODE_OPTIONS=--use-system-ca：

Node 系列 最低版本
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ 任何版本

在較舊版本的 Node 上，請改為將 NODE_EXTRA_CA_CERTS 設為橋接程式可讀取的 PEM 路徑。在不受支援的 Node 上使用 --use-system-ca 會令程序無法啟動。

信任範圍： --use-system-ca 會信任整個系統鑰匙串，而不只是這個 App 的 CA。NODE_EXTRA_CA_CERTS 則將信任範圍限定在單一 PEM 檔案（供較舊版 Node 使用的替代方案）。此旗標已在 macOS/Windows 上有文件說明。

用戶端類型 設定方式
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 本地網絡 IP 變更時

當您的 iPhone 本地網絡 IP 變更時，App 會使用更新後的 Subject Alternative Names 重新產生葉證書，並重新啟動 HTTPS 監聽器。若 IP 已變更，請重新複製端點 URL。除非您透過關閉再開啟 HTTPS 來重新產生 CA，否則 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_* 工具名稱；合約版本只影響架構預設值。

用戶端設定

伺服器畫面為每種整合提供了可直接複製貼上的程式碼片段。請使用其中顯示的端點和權杖。請對照您的用戶端版本核對格式。

以下範例皆使用預留位置的本地網絡位址——請替換為伺服器畫面上顯示的 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 → 設定 → 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. 在 args 中使用 https://192.168.1.42:9000/mcp
  3. 當 Node 符合 --use-system-ca 的最低版本要求時（22.x 為 22.19.0，23.x 為 23.8.0，24.x 為 24.6.0，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

  • 連接埠 9000 上未加密、未經驗證的 JSON-RPC
  • 使用合約 v1.0.0 配合 Node 的 health-auto-export-mcp-server 橋接程式以取得舊版工具名稱
  • 使用合約 v1.1.0 以取得 get_* TCP 工具名稱（Node 橋接程式需另行更新）

提示

  1. 用戶端連線期間，請將 Health Auto Export 保持在 iPhone 前景
  2. 若懷疑權杖已外洩，請重新產生
  3. 在 iPhone 本地網絡 IP 變更後，請重新複製端點 URL

聊天支援

透過設定 → 進階 → 匯出事件記錄匯出的 App 事件記錄收集診斷資訊。請參閱App 事件記錄指南。透過聊天支援或電郵分享產生的 zip 檔案。