Configureer je agent

De uitgebrachte Mac-app bevat twee ondertekende lokale hulpprogramma’s: healthmd-mcp voor getypeerde agenttools en healthmd voor expliciete CLI-workflows. De afzonderlijke platformonafhankelijke CLI met rechtstreekse MCP-toegang tot de iPhone is openbaar verpakt als expliciet ongekwalificeerde preview; release-QA op fysieke apparaten blijft vereist voor de eerste stabiele versie.

HealthKit blijft op de iPhone.

Met de configuratie krijgt een lokale client toegang tot de afgebakende interfaces van Health.md. De computer of agent krijgt geen rechtstreekse toegang tot HealthKit en je bronbibliotheek wordt niet naar een Health.md-cloud geüpload.

Kies een interface

Doel	Begin met	Lees verder
Laat Codex of Claude gezondheidsgegevens op de Mac opvragen en visualiseren	Gebundelde `healthmd-mcp` via stdio	MCP-server en -tools
Exporteer canonieke JSON of gegenereerde bestanden vanuit een Mac-script	Gebundelde `healthmd`-CLI	CLI
Maak rechtstreeks verbinding met een geopende iPhone zonder de Mac-app	Platformonafhankelijke directe CLI (preview)	Rechtstreekse iPhone-toegang
Ontwikkel met exacte API-enveloppen voor verzoeken en antwoorden	Loopback-API of openbare contracten	Loopback-API
Verwerk schema’s, records, bewijs of gegenereerde fixtures	Referentie met versiebeheer	Datacontracten

Je kiest het transport expliciet. De zelfstandige CLI schakelt nooit ongemerkt over op toegang via de Mac-app.

Codex met de Mac-app

Nu beschikbaar · ondertekend Mac-hulpprogramma

Installeer Health.md voor Mac, open het scherm CLI en kopieer het weergegeven pad van de gebundelde MCP-server als de app niet in /Applications staat.

Voeg het afzonderlijk ondertekende hulpprogramma healthmd-mcp toe aan ~/.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"

Start Codex opnieuw, roep healthmd_doctor aan, zoek ID’s op met healthmd_metrics, haal met de vernieuwingstool expliciet een klein bereik op en vraag dat daarna op met een getypeerde tool, bijvoorbeeld healthmd_metric_chart. De gebundelde server biedt 21 tools, waaronder gereedheidscontrole voor de Mac, verversingstaken voor versleutelde context, bewijs en visualisaties.

Claude Desktop of Claude Code op de Mac

Voeg het gebundelde hulpprogramma toe aan de MCP-configuratie van Claude Desktop of aan een vertrouwd Claude Code-bestand .mcp.json:

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

Start de client opnieuw nadat je de configuratie hebt gewijzigd. Voor configuraties op projectniveau moet je de werkruimte nog steeds vertrouwen en de server expliciet goedkeuren. Houd de Mac- en iPhone-app geopend als een tool actuele HealthKit-gegevens nodig heeft.

Andere stdio-MCP-clients op de Mac

Configureer één lokaal proces:

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

De host beheert stdin en de levenscyclus van het proces. Start het hulpprogramma niet als een gewone interactieve opdracht en plaats er geen shell omheen die de JSON-RPC-uitvoer wijzigt. Gebruik MCP tools/list om de exacte schema’s op te vragen die de geïnstalleerde app aanbiedt.

Platformonafhankelijke directe configuratie

Openbare preview · nog niet als stabiel gekwalificeerd

De platformonafhankelijke Rust-CLI, healthmd setup codex, de MCP-server healthmd mcp serve in hetzelfde uitvoerbare bestand en rechtstreekse koppeling op Linux en Windows zijn openbaar verpakt als expliciet ongekwalificeerde preview.

Installeer op macOS of Linux met brew install CodyBontecou/tap/healthmd. Daarna configureert healthmd setup codex Codex idempotent en start de opdracht de rechtstreekse koppeling met de iPhone. Gebruik de exacte mobiele build uit het releasebewijs; pakketpublicatie bewijst geen mobiele compatibiliteit. De pagina Rechtstreekse iPhone-toegang beschrijft het transport- en protocolgedrag.

Expliciete CLI-workflows

Roep voor canonieke extractie of bestandsgerichte automatisering rechtstreeks healthmd aan. Laat een MCP-host geen omvangrijke brontekst vervoeren:

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

De gebundelde Mac-helper en de zelfstandige platformonafhankelijke CLI verschillen in beschikbaarheid en syntaxis. Lees Health.md-CLI voordat je opdrachten in onbeheerde automatisering overneemt.

Koppeling en gereedheid voor de directe CLI

Preview · platformonafhankelijke directe workflows

Dit zijn de huidige openbaar verpakte platformonafhankelijke workflows. De gebundelde MCP-server voor de Mac blijft de bestaande iPhone-verbinding van de Mac-app gebruiken.

Voor rechtstreekse MCP- en CLI-workflows moet je Health.md op de iPhone eenmalig als vertrouwd apparaat koppelen. De koppeling gebruikt een geverifieerd, versleuteld kanaal en de ingebouwde opslag voor inloggegevens van macOS, Linux of Windows.

Schakel Direct CLI-toegang in Health.md op de iPhone in.
Start de koppeling met healthmd setup codex of healthmd direct pair.
Keur het afgebakende koppelingsverzoek op de iPhone goed.
Houd Health.md op de voorgrond wanneer je een query of export start.
Roep vóór grotere taken healthmd_doctor aan via MCP of healthmd status via de platformonafhankelijke CLI.

Lees Rechtstreekse iPhone-toegang voor informatie over Manual IP, Tailscale, de poort, vertrouwde apparaten, gebruik op de voorgrond en herstel.

Grenzen van de configuratie

Een lokale agentconfiguratie geeft geen toestemming voor:

willekeurige lees- of schrijfbewerkingen in HealthKit;
willekeurige toegang tot het bestandssysteem;
willekeurige URL’s, shell-opdrachten, prompts, rootmappen of sampling via MCP;
het verbergen van ontbrekende gegevens, dekking, eenheden, bewijs of beperkingen;
het zonder de vereiste goedkeuring hervatten, annuleren of overschrijven van gegenereerde bestanden.

Controleer voor een volledig resultaat niet alleen of het proces is geslaagd, maar ook het gevraagde bereik, de dekking, de doorloopstatus, de beperkingen en het bronschema.