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
HTTPS (TLS)
HTTPS (TLS) Activar HTTPSConfiar en la CA en los clientesCambios de IP LAN de iOSEjemplo de endpoint HTTPSConfiguració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)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
- En iPhone, abre Servidor desde la pestaña Exportar. En iPad, usa la barra lateral.
- Elige HTTP (recomendado) o TCP
- Opcionalmente activa Usar HTTPS (instrucciones más abajo)
- Toca Iniciar servidor
- 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
- Abre la vista Servidor (iPhone: pestaña Exportar; iPad: barra lateral)
- Activa Usar HTTPS
- Toca Exportar certificado CA y usa la hoja de compartir para AirDrop o guardar el archivo CA en cada dispositivo cliente
- 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):
- Exporta la CA desde la pantalla Servidor en el iPhone
- Abre el PEM en Acceso a Llaveros en el Mac cliente
- 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-caconfía en todo el Llavero del sistema, no solo en la CA de esta app.NODE_EXTRA_CA_CERTSañ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.
- Inicia el servidor en el iPhone y copia el endpoint y el token
- 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:
- Exporta la CA desde el iPhone y confía en ella en Acceso a Llaveros (Confiar siempre) en tu Mac
- Usa
https://192.168.1.42:9000/mcpenargs - Para las versiones de Node admitidas por la configuración generada de arriba, añade este objeto
enval 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-serverpara nombres de herramientas legados - Usa el contrato v1.1.0 para nombres de herramientas TCP
get_* (actualiza el puente Node por separado)
Consejos
- Mantén Health Auto Export en primer plano en el iPhone mientras haya clientes conectados
- Regenera el token si sospechas que quedó expuesto
- 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.