Agenten konfigurieren

Die veröffentlichte Mac-App enthält zwei signierte lokale Helfer: healthmd-mcp für typisierte Agententools und healthmd für explizite CLI-Workflows. Die separate plattformübergreifende CLI mit direktem iPhone-MCP ist als ausdrücklich unqualifizierte öffentliche Vorschau paketiert; für die erste stabile Version bleibt die Release-QA auf physischen Geräten erforderlich.

HealthKit bleibt auf dem iPhone.

Durch die Konfiguration erhält ein lokaler Client Zugriff auf die begrenzten Schnittstellen von Health.md. Sie gewährt dem Computer oder Agenten keinen direkten HealthKit-Zugriff und lädt Ihren Quelldatenbestand nicht in eine Health.md-Cloud hoch.

Schnittstelle auswählen

Ziel	Einstieg	Weiterführend
Codex oder Claude auf dem Mac Gesundheitsdaten abfragen und visualisieren lassen	Mitgeliefertes `healthmd-mcp` über stdio	MCP-Server & Tools
Kanonisches JSON oder generierte Dateien in einem Mac-Skript exportieren	Mitgelieferte `healthmd` CLI	CLI
Ohne Mac-App direkt eine Verbindung zu einem geöffneten iPhone herstellen	Portable direkte CLI (Vorschau)	Direkter iPhone-Zugriff
Auf Grundlage exakter Anfrage- und Antwort-API-Envelopes entwickeln	Loopback-API oder öffentliche Verträge	Loopback-API
Schemas, Datensätze, Nachweise oder generierte Fixtures verarbeiten	Versionierte Referenz	Datenverträge

Backend und Übertragungsweg wählen Sie ausdrücklich aus; Health.md wechselt nicht unbemerkt vom direkten iPhone-Zugriff zur Mac-App.

Codex mit der Mac-App

Jetzt verfügbar · signierter Mac-Helfer

Installieren Sie Health.md für Mac, öffnen Sie den Bildschirm CLI und kopieren Sie den angezeigten Pfad des mitgelieferten MCP-Helfers, wenn sich die App nicht unter /Applications befindet.

Fügen Sie den separaten signierten healthmd-mcp-Helfer zu ~/.codex/config.toml hinzu:

[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"

Starten Sie Codex neu, rufen Sie healthmd_doctor auf, ermitteln Sie IDs mit healthmd_metrics, erfassen Sie mit dem Aktualisierungstool ausdrücklich einen kleinen Umfang und fragen Sie diesen dann mit einem typisierten Tool wie healthmd_metric_chart ab. Der mitgelieferte Server stellt 21 Tools bereit, darunter Mac-Bereitschaft, Aktualisierungsaufträge für verschlüsselten Kontext, Nachweise und Visualisierungen.

Claude Desktop oder Claude Code auf dem Mac

Fügen Sie den mitgelieferten Helfer zur MCP-Konfiguration von Claude Desktop oder zu einer vertrauenswürdigen .mcp.json von Claude Code hinzu:

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

Starten Sie den Client neu, nachdem Sie seine Konfiguration geändert haben. Projektbezogene Konfigurationen erfordern weiterhin Vertrauen in den Workspace und eine ausdrückliche Serverfreigabe. Lassen Sie die Mac- und iPhone-Apps geöffnet, wenn ein Tool aktuelle HealthKit-Daten benötigt.

Beliebiger stdio-MCP-Client auf dem Mac

Konfigurieren Sie einen lokalen Prozess:

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

Der Host verwaltet stdin und den Prozesslebenszyklus. Starten Sie den Helfer nicht als normalen interaktiven Befehl und umschließen Sie ihn nicht mit einer Shell, die die JSON-RPC-Ausgabe verändert. Verwenden Sie MCP tools/list, um die exakten Schemas zu ermitteln, die von der installierten App bereitgestellt werden.

Portable direkte Einrichtung

Öffentliche Vorschau · noch nicht als stabil qualifiziert

Die plattformübergreifende Rust-CLI, healthmd setup codex, healthmd mcp serve aus derselben Binärdatei sowie die direkte Kopplung unter Linux/Windows sind als ausdrücklich unqualifizierte Vorschau öffentlich paketiert.

Installieren Sie unter macOS oder Linux mit brew install CodyBontecou/tap/healthmd. Danach konfiguriert healthmd setup codex Codex idempotent und startet die direkte iPhone-Kopplung. Verwenden Sie den exakten mobilen Build aus den Release-Nachweisen; die Paketveröffentlichung beweist keine mobile Kompatibilität. Die Seite Direkte iPhone-CLI beschreibt das Übertragungs- und Protokollverhalten.

Explizite CLI-Workflows

Rufen Sie für die kanonische Extraktion oder dateiorientierte Automatisierung healthmd direkt auf, statt einen MCP-Host einen großen Quellinhalt übertragen zu lassen:

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

Verfügbarkeit und Befehlssyntax unterscheiden sich zwischen dem mitgelieferten Mac-Helfer und der eigenständigen plattformübergreifenden CLI. Lesen Sie Health.md CLI, bevor Sie Befehle in unbeaufsichtigte Automatisierungen übernehmen.

Portable Kopplung und Bereitschaft

Vorschau · portable direkte Workflows

Dies sind die aktuell öffentlich paketierten portablen Abläufe. Der mitgelieferte Mac-MCP-Pfad verwendet weiterhin die bestehende iPhone-Verbindung der Mac-App.

Direkte MCP- und CLI-Workflows erfordern eine einmalige vertrauenswürdige Kopplung mit Health.md auf dem iPhone. Die Kopplung verwendet einen authentifizierten, verschlüsselten Kanal und die native Anmeldedatenspeicherung unter macOS, Linux oder Windows.

Aktivieren Sie Direct CLI-Zugriff in Health.md auf dem iPhone.
Starten Sie die Kopplung über healthmd setup codex oder healthmd direct pair.
Genehmigen Sie die begrenzte Kopplungsanfrage auf dem iPhone.
Lassen Sie Health.md im Vordergrund geöffnet, wenn Sie eine Abfrage oder einen Export starten.
Rufen Sie vor umfangreicheren Aufgaben healthmd_doctor in MCP oder healthmd status in der portablen CLI auf.

Unter Direkter iPhone-Zugriff finden Sie Einzelheiten zu Manual IP, Tailscale, Port, vertrauenswürdigen Geräten, Vordergrundbetrieb und Wiederherstellung.

Konfigurationsgrenzen

Eine lokale Agentenkonfiguration gewährt nicht:

beliebige HealthKit-Lese- oder Schreibzugriffe;
beliebigen Dateisystemzugriff;
beliebige URLs, Shell-Befehle, Prompts, Roots oder Sampling über MCP;
die Berechtigung, fehlende Daten, Abdeckung, Einheiten, Nachweise oder Einschränkungen zu verbergen;
die Berechtigung, generierte Dateien ohne die erforderliche Genehmigung fortzusetzen, abzubrechen oder zu überschreiben.

Prüfen Sie für ein vollständiges Ergebnis den angeforderten Umfang, die Abdeckung, die Paginierung, die Einschränkungen und das Quellschema — nicht nur den erfolgreichen Prozessabschluss.