帮助中心 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 事件日志。