Guide de connexion au serveur

Le serveur TCP/MCP vous permet d'interroger vos données de santé directement depuis d'autres appareils via votre réseau local. Cela permet l'intégration avec d'autres applications, scripts ou services fonctionnant sur le même réseau.

Vue d'ensemble

Le serveur TCP/MCP crée un serveur de réseau local qui accepte les connexions d'autres appareils et applications. Vous pouvez interroger les données de santé, exécuter des automatisations et interagir avec Health Auto Export par programmation.

Cas d'utilisation :

• Interroger les données de santé depuis d'autres appareils sur votre réseau
• Intégrer avec des applications et scripts locaux
• Accéder aux données de santé depuis des outils en ligne de commande
• Créer des intégrations personnalisées en utilisant le protocole MCP

Fonctionnalités principales :

• Serveur basé sur TCP pour des connexions fiables
• Support du protocole MCP (Model Context Protocol)
• Accès au réseau local
• Requêtes de données de santé en temps réel
• Contrôle d'automatisation par programmation

Limitations :

• L'application doit être en cours d'exécution au premier plan
• Actuellement non chiffré (à utiliser uniquement sur des réseaux de confiance)
• Nécessite l'autorisation Réseau local
• Les connexions ne fonctionnent que lorsque le serveur est en cours d'exécution

Prérequis

• Health Auto Export en cours d'exécution sur votre iPhone/iPad
• Appareils sur le même réseau local
• Autorisation Réseau local accordée
• Abonnement Premium
• Réseau de confiance

Affichage de l'adresse IP/Port :

• Le serveur affiche l'adresse IP de votre appareil
• Le port par défaut est 9000

Version du serveur

• v0.0.1 : mode de compatibilité hérité (recommandé pour les configurations existantes).
• v1.0.0 : comportement mis à jour aligné avec le contrat MCP du serveur le plus récent.

La version sélectionnée affecte les valeurs par défaut des outils et la compatibilité des réponses. Si vous changez de version, redémarrez le serveur pour que le changement prenne effet.

Se connecter au serveur

Trouver votre adresse IP

L'écran du serveur affiche automatiquement l'adresse IP de votre appareil. C'est l'adresse que les autres appareils doivent utiliser pour se connecter.

Exemple : 192.168.1.100:9000

Utiliser le serveur

Protocole MCP

Le serveur utilise le Model Context Protocol (MCP) pour la communication.

Journaux de connexion

L'écran Serveur affiche les journaux de connexion montrant :

• Tentatives de connexion entrantes
• Détails des requêtes
• Informations de réponse
• Messages d'erreur

Voir les journaux :

• Les journaux apparaissent automatiquement dans la liste sur l'écran Serveur
• Faites défiler pour voir l'activité récente
• Les journaux aident à déboguer les problèmes de connexion

Pour un diagnostic approfondi, exportez les journaux complets d’événements de l’app depuis Réglages → Avancé → Exporter les journaux d’événements ou depuis Journaux d’activité → Partager sur n’importe quelle automatisation (même ZIP). Voir le Guide des journaux d’événements de l’app.

Conseils et bonnes pratiques

1. Synchronisation automatique :
   • Chargez l’appareil et utilisez la duplication iPhone
     • Pendant la charge, iOS impose moins de restrictions de performances, ce qui permet une synchronisation plus fréquente
     • Avec la duplication iPhone, l’appareil se comporte comme s’il était déverrouillé. Health Auto Export peut ainsi accéder aux données de santé pour exécuter des actions automatisées