Apple Health AI Bridge

Empieza con la App Store.

La ruta predeterminada instala el complemento para iPhone sin Xcode y luego lo empareja con la máquina que ejecuta tu receptor y el cliente MCP.

1. Instala el complemento para iPhone

Descarga la aplicación para iPhone desde la App Store. TestFlight sigue disponible para versiones beta y pruebas previas al lanzamiento.

Descargar en la App Store Unirse a la beta de TestFlight

2. Elige una ruta antes de la configuración

La URL del receptor no la proporciona Apple Health AI Bridge. Es la ruta HTTPS privada que el iPhone físico usa para llegar a la computadora receptora, incluso cuando el teléfono está fuera de casa.

¿Ya usas Tailscale?

Usa la ruta documentada de Tailscale Serve cuando tanto el receptor como el iPhone ya estén en la misma tailnet. Tailscale es opcional, no un requisito del producto.

Entrada HTTPS privada asistida por agente

Usa la ruta asistida por agente de la guía de configuración. El agente de configuración debe inspeccionar primero, previsualizar cada cambio de DNS, túnel, proxy, firewall y servicio, y esperar la aprobación.

No es un valor predeterminado de sincronización continua: una ruta solo de red local deja de sincronizar cuando el iPhone sale de esa red. No copies un nombre de host de ejemplo ni expongas el puerto 8765 del receptor directamente a Internet público.

Opcional en Mac: iCloud Mailbox cifrado (Beta) envía archivos de sincronización cifrados a través de tu propia cuenta de iCloud. Direct sigue siendo el valor predeterminado, y Apple Health AI Bridge nunca cambia automáticamente entre los dos métodos. Los receptores Linux usan Direct.

3. Instala y ejecuta la configuración

BASE="https://github.com"
OWNER="roian6"
REPO="apple-health-ai-bridge"
TAG="@receiver-v1.1.2"
URL="git+$BASE/$OWNER/"
URL="${URL}${REPO}.git${TAG}"
uv tool install "$URL"

# Routes A/B: run only after
# the guide sets the HTTPS URL.
health-bridge setup \
 --receiver-url \
 "$HEALTH_BRIDGE_RECEIVER_URL"

Esto instala Receiver/CLI 1.1.2, compatible con iPhone Companion 1.1.1 (50) y Batch Protocol 1.0.0.

El receptor puede permanecer en ejecución mientras tu IA lee los datos sincronizados a través de la CLI o MCP.

Para la ruta alternativa deliberada de solo red local (Route C), usa la URL LAN real y su enlace obligatorio sin loopback:

health-bridge setup \
 --receiver-url \
 "$HEALTH_BRIDGE_RECEIVER_URL" \
 --receiver-host 0.0.0.0 \
 --receiver-port 8765

La guía de rutas con versión fija explica cómo configurar la URL real para cada ruta. La configuración principal crea la base de datos privada del receptor y la página de emparejamiento de un solo uso, emite un descriptor MCP stdio en el mismo host y verifica el proceso MCP local. No demuestra la preparación del receptor ni la accesibilidad del iPhone. La configuración no modifica la configuración del cliente a menos que elijas explícitamente un cliente.

4. Supervisa, verifica, empareja y habilita la sincronización

1. Coloca el comando impreso por la configuración bajo el administrador de servicios aprobado del host y luego inicia el receptor.
2. Exige {"status":"ok"} desde la URL local impresa /health en el host del receptor.
3. Abre la URL exacta orientada al teléfono /health en el iPhone físico y exige la misma respuesta. Las rutas A y B usan HTTPS; la ruta C usa HTTP solo en la misma LAN de confianza.
4. Abre la página de emparejamiento privada en la computadora receptora y escanea su código QR con la cámara del iPhone.
5. Conecta la aplicación del iPhone y revisa la hoja de permisos nativa de Apple.
6. Habilita la sincronización automática y espera la primera carga exitosa al receptor.

El acceso a la salud permanece de solo lectura, y puedes cambiar los permisos de Apple Health en cualquier momento en los Ajustes de iOS.

Compilar desde el código fuente

Los colaboradores y usuarios avanzados pueden seguir la guía de compilación propia con versión fija.

Leer la guía de configuración Ver el código fuente