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
HTTPS (TLS)
HTTPS (TLS) Activer HTTPSFaire confiance à la CA sur les clientsChangements d’IP LAN iOSExemple de point de terminaison HTTPSConfiguration 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)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
- Sur iPhone, ouvrez Serveur depuis l’onglet Exporter. Sur iPad, utilisez la barre latérale.
- Choisissez HTTP (recommandé) ou TCP
- Activez éventuellement Utiliser HTTPS (instructions ci-dessous)
- Appuyez sur Démarrer le serveur
- 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
- Ouvrez la vue Serveur (iPhone : onglet Exporter ; iPad : barre latérale)
- Activez Utiliser HTTPS
- Appuyez sur Exporter le certificat CA et utilisez la feuille de partage pour AirDrop ou enregistrer le fichier CA sur chaque appareil client
- 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) :
- Exportez la CA depuis l’écran Serveur sur l’iPhone
- Ouvrez le PEM dans Trousseaux d’accès sur le Mac client
- 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-cafait confiance à l’ensemble du Trousseau système, pas uniquement à la CA de cette app.NODE_EXTRA_CA_CERTSajoute 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.
- Démarrez le serveur sur l’iPhone et copiez le point de terminaison et le jeton
- 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é :
- Exportez la CA depuis l’iPhone et faites-lui confiance dans Trousseaux d’accès (Toujours faire confiance) sur votre Mac
- Utilisez
https://192.168.1.42:9000/mcpdansargs - Pour les versions de Node prises en charge par la configuration générée ci-dessus, ajoutez cet objet
envau 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-serverpour 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
- Gardez Health Auto Export au premier plan sur l’iPhone tant que des clients sont connectés
- Régénérez le jeton si vous soupçonnez qu’il a été exposé
- 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.