ヘルプセンター HealthyApps
日本語
ヘルプセンター
メインサイト ↗

ヘルプを検索

サーバーに接続

ローカルネットワーク上の AI クライアントとスクリプト向けに、Health Auto Export の MCP サーバーへ接続します。

最終更新: 2026年10月31日

このページの内容
概要前提条件サーバーの起動認証(HTTP)
HTTPS (TLS) HTTPS (TLS) HTTPS の有効化クライアントでの CA の信頼iOS の 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(クライアント接続中はアプリを フォアグラウンド に保つ)
  • 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 証明書をエクスポート をタップし、共有シートで各クライアントデバイスへ AirDrop するか、CA ファイルを保存します
  4. サーバーを開始し、エンドポイント URL が https:// に切り替わることを確認します

クライアントでの CA の信頼

エクスポートした CA を、AI クライアントを実行するデバイス(通常は Mac)で信頼します:

  1. iPhone のサーバー画面から CA をエクスポートします
  2. クライアント Mac の キーチェーンアクセス で PEM を開きます
  3. 信頼 → 常に信頼 に設定します

生成セットアップ向けの 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 が必要です。

  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 では、代わりに読める 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 ブリッジは別途更新)

ヒント

  1. クライアント接続中は iPhone で Health Auto Export をフォアグラウンドに保つ
  2. トークンが露出した疑いがある場合は再生成する
  3. iPhone の LAN IP が変わったらエンドポイント URL を再コピーする

ヘルプを得る

サポートの送信は ヘルプを得る、診断エクスポートは アプリイベントログ を参照してください。