サーバーに接続
ローカルネットワーク上の AI クライアントとスクリプト向けに、Health Auto Export の MCP サーバーへ接続します。
最終更新: 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(クライアント接続中はアプリを フォアグラウンド に保つ)
- 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 証明書をエクスポート をタップし、共有シートで各クライアントデバイスへ AirDrop するか、CA ファイルを保存します
- サーバーを開始し、エンドポイント URL が
https://に切り替わることを確認します
クライアントでの CA の信頼
エクスポートした CA を、AI クライアントを実行するデバイス(通常は Mac)で信頼します:
- iPhone のサーバー画面から CA をエクスポートします
- クライアント Mac の キーチェーンアクセス で PEM を開きます
- 信頼 → 常に信頼 に設定します
生成セットアップ向けの Node バージョン
アプリが生成する 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 では、代わりにブリッジプロセスが読める PEM パスを NODE_EXTRA_CA_CERTS に設定します。非対応の Node で --use-system-ca を出すと、プロセスが起動しません。
信頼の範囲:
--use-system-caは、このアプリの 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 では読める PEM パスを NODE_EXTRA_CA_CERTS に設定 |
| 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 では、代わりに読める PEM パスを NODE_EXTRA_CA_CERTS に設定します。設定更新後、stdio クライアントを再起動します。
ツール引数
日付形式
start と end パラメータは次の 2 形式を受け付けます:
| 形式 | 例 | 備考 |
|---|---|---|
yyyy-MM-dd |
2026-06-13 |
開始日: 午前 0 時、終了日: 23:59:59 |
yyyy-MM-dd HH:mm:ss Z |
2026-06-13 00:00:00 +0000 |
明示的な時刻とタイムゾーンオフセット |
TCP
- ポート 9000 の暗号化なし・認証なしの JSON-RPC
- レガシーツール名には、Node の
health-auto-export-mcp-serverブリッジとコントラクト v1.0.0 を使う get_* TCP ツール名にはコントラクト v1.1.0 を使う(Node ブリッジは別途更新)
ヒント
- クライアント接続中は iPhone で Health Auto Export をフォアグラウンドに保つ
- トークンが露出した疑いがある場合は再生成する
- iPhone の LAN IP が変わったらエンドポイント URL を再コピーする