Guía de conexión al servidor

El servidor MCP en iOS permite que clientes de IA y scripts de tu red local consulten tus datos de salud. HTTP (Streamable MCP) es el transporte recomendado. iOS también admite TCP para configuraciones con puente Node.

Los clientes se ejecutan en tu Mac u otros dispositivos de la misma red y se conectan al endpoint que se muestra en tu iPhone.

Resumen

Transporte	Endpoint
HTTP (recomendado)	http://{LAN_IP}:9000/mcp (o https:// cuando HTTPS está habilitado)
TCP	{LAN_IP}:9000 (sin autenticación)

Sustituye {LAN_IP} por la dirección que se muestra en la pantalla del Servidor mientras el servidor está en ejecución.

Casos de uso:

• Conectar Claude Code, Codex, Cursor o VS Code en tu Mac a los datos de salud de tu iPhone
• Usar mcp-remote (iOS / LAN) para clientes solo de stdio como Claude Desktop
• Consultar métricas y entrenamientos desde scripts de tu red local (HTTP)
• Integraciones TCP mediante el puente Node health-auto-export-mcp-server

Requisitos previos

• Health Auto Export en iPhone (la app debe permanecer en primer plano mientras los clientes están conectados)
• Suscripción Premium
• HTTP: token Bearer desde la pantalla del Servidor
• Permiso de Red Local en el iPhone
• Dispositivo cliente: misma Wi‑Fi o red local que el iPhone; Node.js solo si usas mcp-remote (iOS / LAN)

Iniciar el servidor

1. En el iPhone, abre el Servidor desde la navegación de la barra lateral
2. Elige HTTP (recomendado) o TCP
3. Opcionalmente, activa Usar HTTPS (instrucciones más abajo)
4. Pulsa Iniciar servidor
5. Copia la URL del endpoint y el token Bearer

El servidor se detiene automáticamente si Health Auto Export pasa a segundo plano (tanto en HTTP como en TCP).

Autenticación (HTTP)

Todas las solicitudes HTTP requieren:

Authorization: Bearer <tu-token>

• Regenera el token desde la pantalla del Servidor si lo consideras necesario
• En HTTP simple, el token se envía por una conexión sin cifrar: úsalo solo en redes de confianza, o activa HTTPS
• El TCP heredado no tiene autenticación (sin cambios)

HTTPS (TLS)

Cuando Usar HTTPS está activado, la app genera una Autoridad de Certificación (CA) local privada y un certificado de servidor firmado por esa CA. Los clientes deben confiar en la CA exportada antes de poder conectarse por https://.

Activar HTTPS

1. Abre la vista del Servidor desde la navegación de la barra lateral
2. Activa Usar HTTPS
3. Pulsa Exportar certificado CA y usa la hoja de compartir para enviarlo por AirDrop o guardarlo en cada dispositivo cliente
4. Inicia el servidor; comprueba que la URL del endpoint cambia a https://

Confiar en la CA en los clientes

Confía en la CA exportada en el dispositivo que ejecuta el cliente de IA (normalmente tu Mac):

1. Exporta la CA desde la pantalla del Servidor en el iPhone
2. Abre el PEM en Acceso a Llaveros en la Mac cliente
3. Configura Confiar → Confiar siempre

Versión mínima de Node para --use-system-ca

Los puentes Node (mcp-remote) solo pueden usar NODE_OPTIONS=--use-system-ca cuando Node cumple:

Línea de Node	Versión mínima
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	cualquiera

En versiones de Node más antiguas, configura NODE_EXTRA_CA_CERTS con una ruta a un PEM que el proceso del puente pueda leer. Si emites --use-system-ca en una versión de Node no compatible, el proceso no podrá iniciarse.

Alcance de confianza: --use-system-ca confía en todo el Llavero del sistema, no solo en la CA de esta app. NODE_EXTRA_CA_CERTS limita la confianza a un único archivo PEM (alternativa en versiones de Node antiguas). El flag está documentado para macOS/Windows.

Tipo de cliente	Configuración
Cursor, VS Code, Claude Code, Codex	Confianza en el Llavero de la Mac cliente; usa el endpoint https:// de la pantalla del Servidor
mcp-remote (iOS / LAN)	Confía en la CA en el Llavero de la Mac que ejecuta mcp-remote. El fragmento usa NODE_OPTIONS=--use-system-ca cuando Node cumple la versión mínima; en versiones más antiguas, configura NODE_EXTRA_CA_CERTS con una ruta a un PEM legible
curl / scripts	Pasa --cacert /ruta/a/mcp-ca.pem o configura NODE_EXTRA_CA_CERTS

La huella digital de la CA se muestra en la pantalla del Servidor para que puedas verificar que exportaste el certificado correcto.

Cambios de IP LAN en iOS

Cuando la IP de la red local de tu iPhone cambia, la app regenera el certificado del servidor con los Subject Alternative Names actualizados y reinicia el listener HTTPS. Vuelve a copiar la URL del endpoint si la IP cambió. El certificado de la CA se mantiene igual salvo que lo regeneres desactivando y activando HTTPS de nuevo.

Ejemplo de endpoint HTTPS

https://192.168.1.42:9000/mcp

Sustituye el host por el valor que se muestra en la pantalla del Servidor.

Versión del contrato

Versión	Nombres de herramientas TCP	Notas
v1.1.0 (predeterminada)	get_*	Recomendada para configuraciones nuevas
v1.0.0	Heredada (health_metrics, …)	Actualización de compatibilidad v1.0.0 con Claude Desktop
v0.0.1	Heredada	La más antigua para compatibilidad

HTTP siempre usa nombres de herramientas get_*; la versión del contrato solo afecta a los valores predeterminados del esquema.

Configuración del cliente

La pantalla del Servidor incluye fragmentos para copiar y pegar de cada integración. Usa el endpoint y el token que se muestran allí. Verifica los formatos con la versión de tu cliente.

Todos los ejemplos siguientes usan una dirección LAN de ejemplo; sustitúyela por la de tu iPhone en la pantalla del Servidor.

Claude Code (CLI)

Ejecuta en tu Mac (requiere la CLI de Claude Code):

HTTP:

claude mcp add --transport http health-auto-export \
  http://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

HTTPS (tras exportar y confiar en la CA en tu Mac):

claude mcp add --transport http health-auto-export \
  https://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

Claude Code / archivo de proyecto (.mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Codex CLI (~/.codex/config.toml)

Codex se conecta directamente por Streamable HTTP, sin necesidad de un puente Node.js. La configuración vive en ~/.codex/config.toml (global) o en .codex/config.toml dentro de un directorio de proyecto de confianza.

CLI (recomendado):

export HAE_MCP_TOKEN="<token>"
codex mcp add health-auto-export \
  --url http://192.168.1.42:9000/mcp \
  --bearer-token-env-var HAE_MCP_TOKEN

config.toml manual:

[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true

Exporta HAE_MCP_TOKEN con tu token Bearer antes de iniciar Codex. Tras configurarlo, ejecuta /mcp dentro de una sesión de Codex para comprobar que el servidor está conectado.

Si regeneras el token Bearer en Health Auto Export, actualiza HAE_MCP_TOKEN y vuelve a ejecutar codex mcp add, o elimina y vuelve a añadir la entrada del servidor.

mcp-remote (iOS / LAN)

Para clientes solo de stdio (como Claude Desktop) que no pueden conectarse directamente por HTTP. Requiere Node.js en la Mac que ejecuta el cliente.

1. Inicia el servidor en el iPhone y copia el endpoint y el token
2. En tu Mac, selecciona mcp-remote (iOS / LAN) en la pantalla del Servidor y copia el fragmento JSON, o pégalo en la configuración MCP del cliente (Claude Desktop → Settings → Developer → Edit Config):

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

Cuando HTTPS está activado:

1. Exporta la CA desde el iPhone y confía en ella en Acceso a Llaveros (Confiar siempre) en tu Mac
2. Usa https://192.168.1.42:9000/mcp en args
3. Cuando Node cumpla la versión mínima para --use-system-ca (22.19.0 en 22.x, 23.8.0 en 23.x, 24.6.0 en 24.x, o cualquier versión 25+), añade:

"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

En versiones de Node más antiguas, configura NODE_EXTRA_CA_CERTS con una ruta a un PEM legible. Reinicia el cliente stdio después de actualizar la configuración.

Reducir la latencia de inicio: npx -y descarga mcp-remote la primera vez y vuelve a comprobarlo cuando caduca la caché, lo que puede causar retrasos de varios segundos. Instalarlo globalmente elimina este retraso:

npm install -g mcp-remote@0.1.16

Argumentos de las herramientas

Formatos de fecha

Los parámetros start y end aceptan dos formatos:

Formato	Ejemplo	Notas
yyyy-MM-dd	2026-06-13	Fecha de inicio: medianoche; fecha de fin: 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Hora explícita y desfase de zona horaria

TCP

• JSON-RPC sin cifrar y sin autenticación en el puerto 9000
• Usa el contrato v1.0.0 con el puente Node health-auto-export-mcp-server para nombres de herramientas heredados
• Usa el contrato v1.1.0 para nombres de herramientas TCP get_* (actualiza el puente Node por separado)

Consejos

1. Mantén Health Auto Export en primer plano en el iPhone mientras haya clientes conectados
2. Regenera el token si sospechas que se ha expuesto
3. Vuelve a copiar la URL del endpoint después de que cambie la IP LAN de tu iPhone

Soporte por chat

Reúne diagnósticos desde los registros de eventos de la app en Ajustes → Avanzado → Exportar registros de eventos. Consulta la Guía de registros de eventos de la app. Comparte el archivo zip generado a través del soporte por chat o por correo electrónico.