Installez « MCP Server for Xiaozhi » dans Home Assistant (HA) avec HACS, puis ajoutez l’intégration du même nom. Selon l’article d’origine, cette étape est déjà configurée sur les hôtes HAIOTS expédiés après avril 2026.
Étape 1 : obtenir l’adresse du point d’accès MCP de Xiaozhi
L’appareil Xiaozhi a besoin d’une adresse pour communiquer avec HA. Connectez-vous à la console officielle Xiaozhi (généralement xiaozhi.me ; si vous hébergez le service vous-même, utilisez votre propre console). Dans la liste des appareils, trouvez votre appareil ESP Xiaozhi et ouvrez « Configurer ».
Dans la section « MCP Setting », cliquez sur « Get MCP Endpoint ». Copiez l’adresse générée, qui commence généralement par wss://.
Étape 2 : configurer l’intégration MCP de Xiaozhi dans HA
Dans Home Assistant, ouvrez « Paramètres » → « Appareils et services » → « Ajouter une intégration ». Recherchez « MCP » ou « Xiaozhi », puis sélectionnez « MCP Server for Xiaozhi ». Collez l’adresse du point d’accès MCP obtenue à l’étape précédente.
Si l’option « llm_hass_api » apparaît, activez-la. Cette fonction de HA permet à Xiaozhi de contrôler les appareils que vous avez autorisés. Vous pouvez également sélectionner d’autres MCP si nécessaire. Validez avec « Soumettre » ou « Terminer ».
Attendez environ une minute, puis retournez dans « MCP Setting » sur la console Xiaozhi. Actualisez la page et vérifiez que l’état indique « Connected ».
Étape 3 : autoriser Xiaozhi à accéder aux appareils HA
Pour des raisons de sécurité, HA n’expose pas automatiquement tous les appareils aux assistants vocaux. Ouvrez « Paramètres » → « Assistants vocaux » → « Exposer ». Sélectionnez les appareils que Xiaozhi pourra piloter : lampes, interrupteurs, climatiseurs, ventilateurs ou capteurs, par exemple. Commencez par une ou deux lampes pour le test, puis ajoutez les autres appareils une fois le test réussi.
Étape 4 : tester la voix et résoudre les problèmes
Essayez une commande comme « Xiaozhi, allume la lumière du bureau » et une question comme « Xiaozhi, quelle est la température du salon ? ».
Si Xiaozhi ne répond pas ou répond de façon inattendue, consultez l’historique des conversations dans sa console : a-t-il compris la demande et appelé l’outil Home Assistant (Function Call) ? En cas de conflit avec les fonctions musicales ou d’écran, formulez une commande plus précise, par exemple « Allume le plafonnier du salon via la maison connectée ».
Si la commande est bien envoyée à HA mais que l’appareil ne réagit pas, ouvrez « Paramètres » → « Système » → « Journaux » et recherchez les erreurs de l’intégration MCP.
