エージェントを設定

リリース済みのMacアプリには、型付きエージェントツール用のhealthmd-mcpと、明示的なCLIワークフロー用のhealthmdという、2つの署名済みローカルヘルパーが含まれています。iPhoneへの直接MCP接続に対応する別のクロスプラットフォームCLIは、明示的に未認定の公開プレビューとして配布されています。最初の安定版には実機リリースQAが引き続き必要です。

HealthKitはiPhone内にとどまります

設定により、ローカルクライアントはHealth.mdの範囲が限定されたインターフェースへアクセスできます。コンピューターやエージェントにHealthKitへの直接アクセスを許可するものではなく、ソースライブラリをHealth.mdのクラウドへアップロードするものでもありません。

インターフェースを選択

目的	最初に使用	続き
CodexまたはClaudeからMac上のヘルスデータを照会し、グラフ化する	同梱の`healthmd-mcp`をstdioで使用	MCPサーバーとツール
Macのスクリプトで正規JSONまたは生成ファイルをエクスポートする	同梱の`healthmd` CLI	CLI
Macアプリを使用せず、開いているiPhoneに直接接続する	ポータブルな直接CLI（プレビュー）	iPhoneへの直接アクセス
厳密なリクエストおよびレスポンスエンベロープを利用して開発する	ループバックAPIまたは公開コントラクト	ループバックAPI
スキーマ、レコード、エビデンス、生成済みフィクスチャを解析する	バージョン管理されたリファレンス	データコントラクト

バックエンドと転送方式は明示的に選択します。Health.mdがiPhoneへの直接アクセスからMacアプリへ暗黙にフォールバックすることはありません。

MacアプリでCodexを使用

提供中 · 署名済みMacヘルパー

Health.md for MacをインストールしてCLI画面を開き、アプリが/Applicationsにない場合は、表示された同梱MCPパスをコピーします。

独立した署名済みhealthmd-mcpヘルパーを~/.codex/config.tomlに追加します。

[mcp_servers.healthmd]
command = "/Applications/Health.md.app/Contents/Helpers/healthmd-mcp"
args = []
startup_timeout_sec = 10
tool_timeout_sec = 1200
default_tools_approval_mode = "prompt"

Codexを再起動し、healthmd_doctorを呼び出して、healthmd_metricsでIDを解決します。更新ツールで小さなスコープを明示的に取得してから、healthmd_metric_chartなどの型付きツールでそのスコープを照会します。同梱サーバーは、Macの準備状況、暗号化コンテキストの更新ジョブ、エビデンス、可視化を含む21個のツールを公開します。

MacでClaude DesktopまたはClaude Codeを使用

同梱ヘルパーをClaude DesktopのMCP設定、または信頼済みのClaude Code .mcp.jsonに追加します。

{
  "mcpServers": {
    "healthmd": {
      "command": "/Applications/Health.md.app/Contents/Helpers/healthmd-mcp",
      "args": []
    }
  }
}

設定を変更した後、クライアントを再起動します。プロジェクトスコープの設定でも、ワークスペースの信頼と明示的なサーバー承認が必要です。ツールが新しいHealthKitデータを必要とするときは、MacとiPhoneのアプリを開いたままにしてください。

Mac上の任意のstdio MCPクライアント

ローカルプロセスを1つ設定します。

command: /Applications/Health.md.app/Contents/Helpers/healthmd-mcp
arguments: none
transport: stdio

ホストがstdinとプロセスのライフサイクルを管理します。ヘルパーを通常の対話型コマンドとして起動したり、JSON-RPC出力を変更するシェルでラップしたりしないでください。MCPのtools/listを使用して、インストール済みアプリが公開する厳密なスキーマを確認します。

ポータブル直接接続のセットアップ

公開プレビュー · 安定版としては未認定

クロスプラットフォームRust CLI、healthmd setup codex、同一バイナリのhealthmd mcp serve、Linux/Windowsの直接ペアリングは、明示的に未認定の公開プレビューとして配布されています。

macOSまたはLinuxではbrew install CodyBontecou/tap/healthmdでインストールします。その後、healthmd setup codexがCodexを冪等に設定し、iPhoneへの直接ペアリングを開始します。リリース証拠に記載された正確なモバイルビルドを使用してください。パッケージ公開はモバイル互換性の証明ではありません。iPhoneへの直接アクセスCLIのページに転送方式とプロトコルの動作が記載されています。

明示的なCLIワークフロー

正規抽出またはファイル指向の自動化では、MCPホストに大きなソース本文を運ばせるのではなく、healthmdを直接呼び出します。

healthmd status
healthmd extract --category Sleep --last 7 --output sleep.json
healthmd export --last 7 --destination "$HOME/Documents/HealthVault"

利用可否と構文は、同梱のMacヘルパーとスタンドアロンのクロスプラットフォームCLIで異なります。無人の自動化にコマンドをコピーする前に、Health.md CLIを確認してください。

ポータブル版のペアリングと準備状況

プレビュー · ポータブル直接接続ワークフロー

以下は現在公開パッケージに含まれるポータブルワークフローです。同梱Mac MCPパスは引き続きMacアプリの既存のiPhone接続を使用します。

直接MCPおよびCLIワークフローでは、iPhone版Health.mdとの信頼済みペアリングを一度行う必要があります。ペアリングには認証済みの暗号化チャネルと、macOS、Linux、またはWindowsのネイティブ認証情報ストレージを使用します。

iPhone版Health.mdでDirect CLI Accessを有効にします。
healthmd setup codexまたはhealthmd direct pairからペアリングを開始します。
iPhoneで範囲が限定されたペアリングリクエストを承認します。
クエリまたはエクスポートを開始するときは、Health.mdを前面に表示したままにします。
大規模な処理の前に、MCPでhealthmd_doctor、またはポータブルCLIでhealthmd statusを呼び出します。

Manual IP、Tailscale、ポート、信頼済みデバイス、前面表示、復旧の詳細は、iPhoneへの直接アクセスを参照してください。

設定の境界

ローカルエージェントの設定によって、以下が許可されることはありません。

任意のHealthKit読み取りまたは書き込み。
任意のファイルシステムアクセス。
MCPを介した任意のURL、シェルコマンド、プロンプト、ルート、サンプリング。
欠損、カバレッジ、単位、エビデンス、制限を隠すこと。
適用される承認なしに、生成ファイルを再開、キャンセル、上書きすること。

完全な結果を得るには、プロセスの成功だけでなく、要求したスコープ、カバレッジ、ページ走査、制限事項、ソーススキーマを確認してください。