Configura tu agente

La aplicación publicada para Mac incluye dos herramientas auxiliares locales firmadas: healthmd-mcp para las herramientas tipadas del agente y healthmd para flujos de trabajo explícitos de la CLI. La CLI multiplataforma independiente con MCP directo para iPhone está empaquetada públicamente como vista previa explícitamente no cualificada; las pruebas de lanzamiento en dispositivos físicos siguen siendo obligatorias para la primera versión estable.

HealthKit permanece en el iPhone.

La configuración permite que un cliente local acceda a las interfaces acotadas de Health.md. No concede al dispositivo local ni al agente acceso directo a HealthKit, ni sube tus datos de salud originales a una nube de Health.md.

Elige una interfaz

Objetivo	Empieza con	Continúa con
Permitir que Codex o Claude consulten y representen gráficamente datos de salud en el Mac	`healthmd-mcp` incluido mediante stdio	Servidor MCP y herramientas
Exportar JSON canónico o archivos generados desde un script en el Mac	CLI `healthmd` incluida	CLI
Conectarse directamente a un iPhone abierto sin la aplicación para Mac	CLI directa y portátil (vista previa)	Acceso directo al iPhone
Desarrollar con las estructuras exactas de solicitud y respuesta	API de loopback o contratos públicos	API de loopback
Analizar esquemas, registros, evidencias o fixtures generados	Referencia versionada	Contratos de datos (en inglés)

Las opciones de transporte son explícitas; la CLI independiente nunca cambia de forma silenciosa al acceso a través de la aplicación para Mac.

Codex con la aplicación para Mac

Ya disponible · herramienta auxiliar firmada para Mac

Instala Health.md for Mac, abre su pantalla CLI y, si la aplicación no está en /Applications, copia la ruta que se muestra para el servidor MCP incluido.

Añade la herramienta auxiliar firmada healthmd-mcp, incluida en la aplicación, a ~/.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"

Reinicia Codex, llama a healthmd_doctor, resuelve los ID con healthmd_metrics, adquiere explícitamente un alcance pequeño con la herramienta de actualización y luego consulta ese alcance con una herramienta tipada como healthmd_metric_chart. El servidor incluido ofrece 21 herramientas, entre ellas la comprobación de la aplicación para Mac, los trabajos de actualización del contexto cifrado, la evidencia y las visualizaciones.

Claude Desktop o Claude Code en el Mac

Añade la herramienta auxiliar incluida a la configuración MCP de Claude Desktop o a un archivo .mcp.json de confianza para Claude Code:

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

Reinicia el cliente después de modificar la configuración. Las configuraciones limitadas al proyecto también exigen confiar en el espacio de trabajo y aprobar el servidor de forma explícita. Mantén abiertas las aplicaciones del Mac y del iPhone cuando una herramienta necesite datos recientes de HealthKit.

Cualquier cliente MCP stdio en el Mac

Configura un único proceso local:

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

El host controla stdin y el ciclo de vida del proceso. No inicies la herramienta auxiliar como si fuera un comando interactivo normal ni lo envuelvas en un shell que modifique la salida JSON-RPC. Usa tools/list de MCP para descubrir los esquemas exactos que ofrece la aplicación instalada.

Configuración directa y portátil

Vista previa pública · aún no cualificada como estable

La CLI multiplataforma en Rust, healthmd setup codex, el servidor healthmd mcp serve incluido en el mismo binario y el emparejamiento directo en Linux/Windows están empaquetados públicamente como una vista previa explícitamente no cualificada.

En macOS o Linux, instala con brew install CodyBontecou/tap/healthmd. Después, healthmd setup codex configura Codex de forma idempotente e inicia el emparejamiento directo con el iPhone. Usa la compilación móvil exacta indicada por la evidencia de la versión; publicar el paquete no demuestra compatibilidad móvil. La página CLI directa para iPhone documenta el transporte y el protocolo.

Flujos de trabajo explícitos de la CLI

Para realizar una extracción canónica o una automatización orientada a archivos, ejecuta healthmd directamente en lugar de pedirle a un host MCP que transporte un cuerpo de datos de origen grande:

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

La disponibilidad y la gramática no son iguales en la herramienta auxiliar incluida para Mac y en la CLI multiplataforma independiente. Consulta Health.md CLI antes de copiar comandos en una automatización desatendida.

Emparejamiento portátil y comprobación de disponibilidad

Vista previa · flujos de trabajo directos y portátiles

Estos son los flujos portátiles incluidos actualmente en el paquete público. La ruta MCP incluida para Mac sigue usando la conexión existente entre la aplicación para Mac y el iPhone.

Los flujos de trabajo directos de MCP y la CLI requieren emparejar una sola vez un dispositivo de confianza con Health.md en el iPhone. El emparejamiento usa un canal cifrado y autenticado, además del almacenamiento nativo de credenciales en macOS, Linux o Windows.

Activa Acceso directo por CLI en Health.md en el iPhone.
Inicia el emparejamiento desde healthmd setup codex o healthmd direct pair.
Aprueba en el iPhone la solicitud de emparejamiento de alcance acotado.
Mantén Health.md en primer plano al iniciar una consulta o exportación.
Llama a healthmd_doctor en MCP o a healthmd status en la CLI portátil antes de ejecutar tareas más grandes.

Consulta Acceso directo al iPhone para conocer Manual IP, Tailscale, el puerto, los dispositivos de confianza, el uso en primer plano y las opciones de recuperación.

Límites de la configuración

La configuración de un agente local no concede:

lecturas o escrituras arbitrarias en HealthKit;
acceso arbitrario al sistema de archivos;
URLs, comandos de shell, prompts, raíces o muestreos arbitrarios mediante MCP;
permiso para ocultar datos ausentes, cobertura, unidades, evidencia o limitaciones;
permiso para reanudar, cancelar o sobrescribir archivos generados sin la aprobación correspondiente.

Para obtener un resultado completo, revisa el alcance solicitado, la cobertura, el recorrido, las limitaciones y el esquema de origen, no solo si el proceso terminó correctamente.