Guide de connexion au serveur

Le serveur MCP sur iOS permet aux clients IA et aux scripts de votre réseau local d'interroger vos données de santé. HTTP (Streamable MCP) est le transport recommandé. iOS prend également en charge TCP pour les configurations avec pont Node.

Les clients s'exécutent sur votre Mac ou d'autres appareils du même réseau et se connectent au point de terminaison affiché sur votre iPhone.

Aperçu

Transport	Point de terminaison
HTTP (recommandé)	http://{LAN_IP}:9000/mcp (ou https:// lorsque HTTPS est activé)
TCP	{LAN_IP}:9000 (non authentifié)

Remplacez {LAN_IP} par l'adresse affichée sur l'écran Serveur pendant que le serveur est en cours d'exécution.

Cas d'usage :

• Connecter Claude Code, Codex, Cursor ou VS Code sur votre Mac aux données de santé de votre iPhone
• Utiliser mcp-remote (iOS / LAN) pour les clients uniquement stdio comme Claude Desktop
• Interroger les métriques et les entraînements depuis des scripts de votre réseau local (HTTP)
• Intégrations TCP via le pont Node health-auto-export-mcp-server

Prérequis

• Health Auto Export sur iPhone (l'app doit rester au premier plan pendant que des clients sont connectés)
• Abonnement Premium
• HTTP : jeton Bearer depuis l'écran Serveur
• Autorisation Réseau local sur l'iPhone
• Appareil client : même Wi-Fi ou LAN que l'iPhone ; Node.js uniquement si vous utilisez mcp-remote (iOS / LAN)

Démarrer le serveur

1. Sur l'iPhone, ouvrez Serveur via la navigation de la barre latérale
2. Choisissez HTTP (recommandé) ou TCP
3. Activez éventuellement Utiliser HTTPS (instructions ci-dessous)
4. Appuyez sur Démarrer le serveur
5. Copiez l'URL du point de terminaison et le jeton Bearer

Le serveur s'arrête automatiquement si Health Auto Export passe en arrière-plan (pour HTTP comme pour TCP).

Authentification (HTTP)

Toutes les requêtes HTTP nécessitent :

Authorization: Bearer <your-token>

• Régénérez le jeton depuis l'écran Serveur si vous le jugez nécessaire
• En HTTP simple, le jeton est envoyé sur une connexion non chiffrée — utilisez-le uniquement sur des réseaux de confiance, ou activez HTTPS
• Le TCP historique n'a aucune authentification (inchangé)

HTTPS (TLS)

Lorsque Utiliser HTTPS est activé, l'app génère une autorité de certification (CA) locale privée et un certificat de serveur signé par cette CA. Les clients doivent faire confiance à la CA exportée avant de pouvoir se connecter via https://.

Activer HTTPS

1. Ouvrez la vue Serveur via la navigation de la barre latérale
2. Activez Utiliser HTTPS
3. Appuyez sur Exporter le certificat CA et utilisez le menu de partage pour envoyer par AirDrop ou enregistrer le fichier CA sur chaque appareil client
4. Démarrez le serveur — vérifiez que l'URL du point de terminaison passe à https://

Faire confiance à la CA sur les clients

Faites confiance à la CA exportée sur l'appareil exécutant le client IA (généralement votre Mac) :

1. Exportez la CA depuis l'écran Serveur sur l'iPhone
2. Ouvrez le fichier PEM dans Keychain Access sur le Mac client
3. Réglez Trust → Always Trust

Version minimale de Node pour --use-system-ca

Les ponts Node (mcp-remote) ne peuvent utiliser NODE_OPTIONS=--use-system-ca que lorsque Node respecte au minimum :

Branche Node	Version minimale
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	n'importe laquelle

Sur une version plus ancienne de Node, définissez plutôt NODE_EXTRA_CA_CERTS avec un chemin PEM lisible par le processus du pont. Utiliser --use-system-ca sur une version de Node non prise en charge empêche le démarrage du processus.

Portée de la confiance : --use-system-ca fait confiance à l'ensemble du Keychain système, et pas uniquement à la CA de cette app. NODE_EXTRA_CA_CERTS limite la confiance à un seul fichier PEM (solution de repli sur les versions plus anciennes de Node). Cette option est documentée pour macOS/Windows.

Type de client	Configuration
Cursor, VS Code, Claude Code, Codex	Confiance Keychain sur le Mac client — utilisez le point de terminaison https:// depuis l'écran Serveur
mcp-remote (iOS / LAN)	Faites confiance à la CA dans le Keychain sur le Mac exécutant mcp-remote. Le snippet utilise NODE_OPTIONS=--use-system-ca lorsque Node respecte la version minimale ; sur une version plus ancienne, définissez NODE_EXTRA_CA_CERTS avec un chemin PEM lisible
curl / scripts	Passez --cacert /path/to/mcp-ca.pem ou définissez NODE_EXTRA_CA_CERTS

L'empreinte de la CA est affichée sur l'écran Serveur afin que vous puissiez vérifier que vous avez exporté le bon certificat.

Changements d'IP LAN sur iOS

Lorsque l'IP LAN de votre iPhone change, l'app régénère le certificat serveur avec des Subject Alternative Names mis à jour et redémarre l'écouteur HTTPS. Recopiez l'URL du point de terminaison si l'IP a changé. Le certificat CA reste identique, sauf si vous le régénérez en désactivant puis réactivant HTTPS.

Exemple de point de terminaison HTTPS

https://192.168.1.42:9000/mcp

Remplacez l'hôte par la valeur affichée sur l'écran Serveur.

Version du contrat

Version	Noms des outils TCP	Remarques
v1.1.0 (par défaut)	get_*	Recommandée pour les nouvelles configurations
v1.0.0	Héritée (health_metrics, …)	Mise à jour de compatibilité v1.0.0 pour Claude Desktop
v0.0.1	Héritée	Compatibilité la plus ancienne

HTTP utilise toujours les noms d'outils get_* ; la version du contrat n'affecte que les schémas par défaut.

Configuration du client

L'écran Serveur inclut des extraits à copier-coller pour chaque intégration. Utilisez le point de terminaison et le jeton qui y sont affichés. Vérifiez les formats selon votre version de client.

Tous les exemples ci-dessous utilisent une adresse LAN d'exemple — remplacez-la par l'adresse de votre iPhone depuis l'écran Serveur.

Claude Code (CLI)

À exécuter sur votre Mac (nécessite la CLI Claude Code) :

HTTP :

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

HTTPS (après avoir exporté et fait confiance à la CA sur votre Mac) :

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

Claude Code / fichier de projet (.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 connecte directement via Streamable HTTP — aucun pont Node.js n'est nécessaire. La configuration se trouve dans ~/.codex/config.toml (global) ou .codex/config.toml dans un répertoire de projet de confiance.

CLI (recommandé) :

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 manuel :

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

Exportez HAE_MCP_TOKEN avec votre jeton Bearer avant de démarrer Codex. Une fois la configuration effectuée, exécutez /mcp dans une session Codex pour vérifier que le serveur est connecté.

Si vous régénérez le jeton Bearer dans Health Auto Export, mettez à jour HAE_MCP_TOKEN et relancez codex mcp add, ou supprimez puis rajoutez l'entrée du serveur.

mcp-remote (iOS / LAN)

Pour les clients uniquement stdio (comme Claude Desktop) qui ne peuvent pas se connecter directement en HTTP. Nécessite Node.js sur le Mac exécutant le client.

1. Démarrez le serveur sur l'iPhone et copiez le point de terminaison et le jeton
2. Sur votre Mac, sélectionnez mcp-remote (iOS / LAN) sur l'écran Serveur et copiez l'extrait JSON, ou collez ceci dans la configuration MCP du client (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>"
  ]
}

Lorsque HTTPS est activé :

1. Exportez la CA depuis l'iPhone et faites-lui confiance dans Keychain Access (Always Trust) sur votre Mac
2. Utilisez https://192.168.1.42:9000/mcp dans args
3. Lorsque Node respecte la version minimale pour --use-system-ca (22.19.0 sur 22.x, 23.8.0 sur 23.x, 24.6.0 sur 24.x, ou n'importe quelle version 25+), ajoutez :

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

Sur une version plus ancienne de Node, définissez plutôt NODE_EXTRA_CA_CERTS avec un chemin PEM lisible. Redémarrez le client stdio après avoir mis à jour la configuration.

Réduire la latence de démarrage : npx -y télécharge mcp-remote lors de la première utilisation et revérifie à l'expiration du cache, ce qui peut provoquer des délais de plusieurs secondes. Une préinstallation globale élimine ce problème :

npm install -g mcp-remote@0.1.16

Arguments des outils

Formats de date

Les paramètres start et end acceptent deux formats :

Format	Exemple	Remarques
yyyy-MM-dd	2026-06-13	Date de début : minuit ; date de fin : 23:59:59
yyyy-MM-dd HH:mm:ss Z	2026-06-13 00:00:00 +0000	Heure explicite et décalage de fuseau horaire

TCP

• JSON-RPC non chiffré et non authentifié sur le port 9000
• Utilisez le contrat v1.0.0 avec le pont Node health-auto-export-mcp-server pour les noms d'outils historiques
• Utilisez le contrat v1.1.0 pour les noms d'outils TCP get_* (mettez à jour le pont Node séparément)

Astuces

1. Gardez Health Auto Export au premier plan sur l'iPhone pendant que des clients sont connectés
2. Régénérez le jeton si vous pensez qu'il a été exposé
3. Recopiez l'URL du point de terminaison après un changement d'IP LAN de votre iPhone

Assistance par chat

Récupérez les diagnostics depuis les journaux d'événements de l'app en allant dans Réglages → Avancé → Exporter les journaux d'événements. Consultez le Guide des journaux d'événements de l'app. Partagez le fichier zip généré via l'assistance par chat ou par e-mail.