Centro de ayuda HealthyApps
Español
Centro de ayuda
Sitio principal ↗

Buscar temas de ayuda

Conectar al servidor

Conéctate al servidor MCP de Health Auto Export para clientes de IA y scripts en tu red local.

Última actualización: 31 de octubre de 2026

En esta página
Descripción generalRequisitos previosIniciar el servidorAutenticación (HTTP)
HTTPS (TLS) HTTPS (TLS) Activar HTTPSConfiar en la CA en los clientesCambios de IP LAN de iOSEjemplo de endpoint HTTPS
Versión del contrato
Configuración del cliente Configuración del cliente Claude Code (CLI)Claude Code / archivo de proyecto (<code>.mcp.json</code>)Cursor (<code>~/.cursor/mcp.json</code>)VS Code (<code>.vscode/mcp.json</code>)Codex CLI (<code>~/.codex/config.toml</code>)mcp-remote (iOS / LAN)
Argumentos de las herramientas Argumentos de las herramientas Formatos de fecha
TCPConsejosObtener ayuda

El servidor MCP en iOS permite que clientes de IA y scripts en tu red local consulten tus datos de salud. HTTP (MCP streamable) 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.

Descripción general

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

Sustituye {LAN_IP} por la dirección que se muestra en la pantalla 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 stdio como Claude Desktop
  • Consultar métricas y entrenamientos desde scripts en 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 haya clientes conectados)
  • Suscripción Premium
  • HTTP: token Bearer de la pantalla Servidor
  • Permiso de red local en el iPhone
  • Dispositivo cliente: misma Wi‑Fi o LAN que el iPhone; Node.js solo si usas mcp-remote (iOS / LAN)

Iniciar el servidor

  1. En iPhone, abre Servidor desde la pestaña Exportar. En iPad, usa la barra lateral.
  2. Elige HTTP (recomendado) o TCP
  3. Opcionalmente activa Usar HTTPS (instrucciones más abajo)
  4. Toca Iniciar servidor
  5. Copia la URL del endpoint y el token Bearer

El servidor activo se detiene automáticamente si Health Auto Export pasa a segundo plano, tanto con HTTP como con TCP.

Autenticación (HTTP)

Todas las solicitudes HTTP requieren:

Authorization: Bearer <your-token>
  • Regenera el token desde la pantalla Servidor si lo consideras necesario
  • En HTTP sin cifrar, el token se envía por una conexión no cifrada—úsalo solo en redes de confianza, o activa HTTPS
  • El TCP legado no tiene autenticación (sin cambios)

HTTPS (TLS)

HTTPS usa una autoridad de certificación (CA) generada localmente. Exporta y confía en su certificado en cada dispositivo cliente antes de conectarte por https://.

Activar HTTPS

  1. Abre la vista Servidor (iPhone: pestaña Exportar; iPad: barra lateral)
  2. Activa Usar HTTPS
  3. Toca Exportar certificado CA y usa la hoja de compartir para AirDrop o guardar el archivo CA en cada dispositivo cliente
  4. Inicia el servidor — comprueba que la URL del endpoint pasa 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 Servidor en el iPhone
  2. Abre el PEM en Acceso a Llaveros en el Mac cliente
  3. Establece Confianza → Confiar siempre

Versiones de Node para la configuración generada

La configuración generada del puente Node de la app usa NODE_OPTIONS=--use-system-ca para estas versiones de Node:

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 Node más antiguo, establece NODE_EXTRA_CA_CERTS a una ruta PEM que el proceso del puente pueda leer. Emitir --use-system-ca en Node no compatible impide que el proceso arranque.

Alcance de la confianza: --use-system-ca confía en todo el Llavero del sistema, no solo en la CA de esta app. NODE_EXTRA_CA_CERTS añade la CA exportada a los certificados de confianza de Node. Consulta opciones de certificados de Node.

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

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

Cambios de IP LAN de iOS

Vuelve a copiar la URL del endpoint si cambia la dirección de red de tu iPhone. Si se proporciona un certificado CA de reemplazo, expórtalo y actualiza la confianza en cada dispositivo cliente.

Ejemplo de endpoint HTTPS

https://192.168.1.42:9000/mcp

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

Versión del contrato

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

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 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 marcador de posición—sustitúyela por la dirección de tu iPhone desde la pantalla Servidor.

Claude Code (CLI)

Ejecuta en tu Mac (requiere el 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 (después de 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 por HTTP streamable directamente — no hace falta puente Node.js. La configuración está en ~/.codex/config.toml (global) o .codex/config.toml en 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

Configuración manual (config.toml):

[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 la configuración, ejecuta /mcp dentro de una sesión de Codex para verificar 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 stdio (como Claude Desktop) que no pueden conectarse por HTTP directamente. Requiere Node.js en el 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 Servidor y copia el fragmento JSON, o pégalo en la configuración MCP del cliente (Claude Desktop → Ajustes → Desarrollador → Editar configuración):
{
  "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. Para las versiones de Node admitidas por la configuración generada de arriba, añade este objeto env al mismo objeto de configuración del servidor:
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

En Node más antiguo, establece NODE_EXTRA_CA_CERTS a una ruta PEM legible. Reinicia el cliente stdio después de actualizar la configuración.

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 y desplazamiento de zona horaria explícitos

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 legados
  • 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 quedó expuesto
  3. Vuelve a copiar la URL del endpoint después de que cambie la IP LAN de tu iPhone

Obtener ayuda

Consulta Obtener ayuda para envíos de soporte y Registros de eventos de la app para exportaciones de diagnóstico.