Centre d'aide HealthyApps
Français
Centre d'aide
Site principal ↗

Rechercher dans l’aide

Connexion au serveur

Connectez-vous au serveur MCP de Health Auto Export pour les clients d’IA et les scripts sur votre réseau local.

Dernière mise à jour: 31 octobre 2026

Sur cette page
Vue d’ensemblePrérequisDémarrer le serveurAuthentification (HTTP)
HTTPS (TLS) HTTPS (TLS) Activer HTTPSFaire confiance à la CA sur les clientsChangements d’IP LAN iOSExemple de point de terminaison HTTPS
Version du contrat
Configuration du client Configuration du client Claude Code (CLI)Claude Code / fichier de projet (<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)
Arguments des outils Arguments des outils Formats de date
TCPConseilsObtenir de l’aide

Le serveur MCP sur iOS permet aux clients d’IA et aux scripts de votre réseau local d’interroger vos données de santé. HTTP (MCP streamable) 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.

Vue d’ensemble

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

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 stdio uniquement tels que Claude Desktop
  • Interroger les indicateurs et les entraînements depuis des scripts sur 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 tant 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 iPhone, ouvrez Serveur depuis l’onglet Exporter. Sur iPad, utilisez 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 actif s’arrête automatiquement si Health Auto Export passe en arrière-plan, que vous utilisiez HTTP ou TCP.

Authentification (HTTP)

Toutes les requêtes HTTP exigent :

Authorization: Bearer <your-token>
  • Régénérez le jeton depuis l’écran Serveur si vous le jugez nécessaire
  • En HTTP en clair, le jeton est envoyé sur une connexion non chiffrée—utilisez-le uniquement sur des réseaux de confiance, ou activez HTTPS
  • Le TCP hérité n’a pas d’authentification (inchangé)

HTTPS (TLS)

HTTPS utilise une autorité de certification (CA) générée localement. Exportez et faites confiance à son certificat sur chaque appareil client avant de vous connecter via https://.

Activer HTTPS

  1. Ouvrez la vue Serveur (iPhone : onglet Exporter ; iPad : barre latérale)
  2. Activez Utiliser HTTPS
  3. Appuyez sur Exporter le certificat CA et utilisez la feuille de partage pour 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 qui exécute le client d’IA (généralement votre Mac) :

  1. Exportez la CA depuis l’écran Serveur sur l’iPhone
  2. Ouvrez le PEM dans Trousseaux d’accès sur le Mac client
  3. Définissez Confiance → Toujours faire confiance

Versions de Node pour la configuration générée

La configuration générée du pont Node de l’app utilise NODE_OPTIONS=--use-system-ca pour ces versions de Node :

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

Sur Node plus ancien, définissez NODE_EXTRA_CA_CERTS sur un chemin PEM que le processus du pont peut lire. Émettre --use-system-ca sur Node non pris en charge empêche le processus de démarrer.

Portée de la confiance : --use-system-ca fait confiance à l’ensemble du Trousseau système, pas uniquement à la CA de cette app. NODE_EXTRA_CA_CERTS ajoute la CA exportée aux certificats de confiance de Node. Voir options de certificats Node.

Type de client Configuration
Cursor, VS Code, Claude Code, Codex Confiance Trousseaux sur le Mac client — utilisez le point de terminaison https:// de l’écran Serveur
mcp-remote (iOS / LAN) Faites confiance à la CA dans Trousseaux sur le Mac qui exécute mcp-remote. Le fragment utilise NODE_OPTIONS=--use-system-ca lorsque Node atteint la version minimale ; sur Node plus ancien, définissez NODE_EXTRA_CA_CERTS sur 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 s’affiche sur l’écran Serveur pour que vous puissiez vérifier avoir exporté le bon certificat.

Changements d’IP LAN iOS

Recopiez l’URL du point de terminaison si l’adresse réseau de votre iPhone change. Si un certificat CA de remplacement est fourni, exportez-le et mettez à jour la confiance sur chaque appareil client.

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 d’outils TCP Notes
v1.1.0 (par défaut) get_* Recommandée pour les nouvelles configurations
v1.0.0 Hérité (health_metrics, …) Mise à jour de compatibilité Claude Desktop v1.0.0
v0.0.1 Hérité Compatibilité la plus ancienne

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

Configuration du client

L’écran Serveur inclut des fragments à coller pour chaque intégration. Utilisez le point de terminaison et le jeton affichés là. Vérifiez les formats par rapport à la version de votre client.

Tous les exemples ci-dessous utilisent une adresse LAN fictive—substituez l’adresse de votre iPhone depuis l’écran Serveur.

Claude Code (CLI)

Exécutez sur votre Mac (nécessite le 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 en HTTP streamable directement — aucun pont Node.js n’est requis. 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

Configuration manuelle (config.toml) :

[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. Après la configuration, 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 réexécutez codex mcp add, ou supprimez et rajoutez l’entrée du serveur.

mcp-remote (iOS / LAN)

Pour les clients stdio uniquement (tels que Claude Desktop) qui ne peuvent pas se connecter en HTTP directement. Nécessite Node.js sur le Mac qui exécute 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 le fragment JSON, ou collez ceci dans la configuration MCP du client (Claude Desktop → Réglages → Développeur → Modifier la configuration) :
{
  "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 Trousseaux d’accès (Toujours faire confiance) sur votre Mac
  2. Utilisez https://192.168.1.42:9000/mcp dans args
  3. Pour les versions de Node prises en charge par la configuration générée ci-dessus, ajoutez cet objet env au même objet de configuration du serveur :
{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

Sur Node plus ancien, définissez NODE_EXTRA_CA_CERTS sur un chemin PEM lisible. Redémarrez le client stdio après avoir mis à jour la configuration.

Arguments des outils

Formats de date

Les paramètres start et end acceptent deux formats :

Format Exemple Notes
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 et décalage de fuseau horaire explicites

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 hérités
  • Utilisez le contrat v1.1.0 pour les noms d’outils TCP get_* (mettez à jour le pont Node séparément)

Conseils

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

Obtenir de l’aide

Voir Obtenir de l’aide pour les envois au support et Journaux d’événements de l’app pour les exportations de diagnostic.