Comment j'ai intégré ClaudeCode sur mon HomeAssistant via MCP

Home Assistant est un formidable moteur domotique, mais son quotidien reste technique : fichiers YAML à éditer à la main, entités aux noms peu lisibles, automatisations qui se cassent en silence, journaux à éplucher pour comprendre pourquoi un scénario n'a pas démarré. Chaque ajustement demande de naviguer entre l'interface, l'éditeur de configuration et la documentation. Le coût n'est pas financier, il est cognitif : la friction décourage l'itération.

Je voulais réduire cette friction. L'objectif : interroger et modifier mon installation en langage naturel, faire diagnostiquer une automatisation défaillante, générer un scénario correct du premier coup, le tout dans un seul outil déjà présent dans mon flux de travail — mon terminal. La question technique était donc : comment donner à un assistant de code un accès contrôlé, structuré et sûr à l'état réel de Home Assistant ?

La réponse tient en trois mots : Model Context Protocol (MCP). MCP est le standard qui permet à un modèle comme Claude d'appeler des outils externes de façon structurée. J'ai relié Claude Code à Home Assistant via un serveur MCP, en exposant les données et actions de la domotique comme des outils invocables. Architecture, connexion, sécurité — une seule personne, du besoin à la mise en production.

Les étapes concrètes :

• Cartographie du besoin : lister ce que je voulais réellement piloter — lecture d'état des entités, appel de services, lecture des journaux, création et correction d'automatisations.

• Mise en place du serveur MCP : déploiement d'un serveur MCP Home Assistant s'appuyant sur l'API REST et WebSocket, authentifié par un jeton d'accès longue durée généré depuis mon profil.

• Enregistrement dans Claude Code : déclaration du serveur MCP dans la configuration de Claude Code, avec l'URL de l'instance et le jeton stocké hors du dépôt (variable d'environnement, jamais en clair).

• Périmètre et sécurité : accès limité à mon réseau local, jeton révocable, actions destructrices identifiées et validées manuellement avant exécution.

• Validation par cas d'usage : diagnostic d'une automatisation qui ne se déclenchait pas, génération d'un nouveau scénario en YAML, interrogation de l'état d'un capteur — chaque cas testé de bout en bout.

Le résultat : je parle à mon installation domotique comme à un collègue. Je décris un comportement souhaité, Claude Code lit l'état réel, propose le YAML correct, et je valide. Le diagnostic d'automatisation, qui demandait de croiser journaux et configuration, se fait désormais en une requête.

• Édition et diagnostic centralisés dans le terminal, sans aller-retour vers l'interface web.

• Temps moyen de correction d'une automatisation défaillante réduit de -3 minutes.

• [À COMPLÉTER] entités et [À COMPLÉTER] automatisations désormais accessibles en langage naturel.

• Zéro jeton exposé dans le dépôt : configuration reproductible et révocable.

Au-delà de mon usage personnel, ce projet valide une approche transposable en entreprise : exposer un système existant à un assistant IA via MCP, avec un périmètre maîtrisé et une sécurité pensée dès la conception.