连接到服务器
连接到 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