Lier votre instance Home Assistant à un agent IA comme Claude change la façon de gérer une maison connectée. Avec le protocole MCP (Model Context Protocol), l’IA peut analyser l’état des appareils, créer des automatisations complexes ou corriger des erreurs de configuration. Ce tutoriel vous guide pas à pas pour connecter Claude Desktop à votre serveur domotique et confier une partie de la maintenance technique sans perdre la main.
Ce dont vous avez besoin avant de commencer
Avant d’autoriser une IA à intervenir sur votre installation, mieux vaut préparer le terrain. Quelques vérifications simples évitent bien des soucis.
Une instance Home Assistant à jour et accessible
Votre serveur Home Assistant doit fonctionner correctement et être accessible à distance via une connexion chiffrée HTTPS. Si vous utilisez Nabu Casa, l’accès distant est déjà sécurisé. Sinon, configurez un nom de domaine avec certificat SSL et redirection de port sur votre box. Vérifiez que vous disposez des droits administrateur dans l’interface.
Le jeton d’accès longue durée
Claude s’authentifie grâce à un jeton d’accès longue durée. Pour le créer, allez dans votre profil utilisateur (icône en bas à gauche ou dans les paramètres), puis ouvrez l’onglet Sécurité. Descendez jusqu’à la section Jetons d’accès longue durée et cliquez sur Créer un jeton. Donnez-lui un nom parlant (par exemple “Claude Desktop”) et conservez la clé affichée. Notez-la tout de suite, car elle ne sera plus visible ensuite. Ce jeton doit rester privé, ne l’enregistrez jamais dans un dépôt public ou un fichier partagé.
Claude Desktop installé sur votre ordinateur
Rendez-vous sur le site d’Anthropic et installez l’application Claude Desktop (Windows ou macOS). L’application est gratuite et vous permet d’interagir avec l’IA au quotidien, sans passer par le navigateur. Lancez-la une première fois pour vérifier qu’elle démarre bien, puis fermez-la avant de passer à la configuration.
Sauvegarde complète de Home Assistant
Modifier sa configuration domotique avec une IA comporte toujours un risque, même minime. Créez une sauvegarde système depuis l’interface Home Assistant (Paramètres > Système > Sauvegardes) juste avant de commencer. Vous pourrez restaurer votre installation en quelques clics en cas de problème.
Astuce : si vos entités (lampes, capteurs, scénarios) portent des noms clairs et cohérents – “lumière_salon”, “détecteur_cuisine” – Claude les comprendra plus facilement. Évitez les identifiants techniques sans signification.
Étape 1 : configurer le serveur MCP dans Claude Desktop
Le Model Context Protocol s’active en ajoutant un serveur local qui fait le pont entre l’application et Home Assistant. Vous allez éditer un simple fichier JSON, puis l’enregistrer avant de relancer Claude.
Localiser et éditer le fichier de configuration
Le fichier qui contrôle les serveurs MCP s’appelle claude_desktop_config.json, côté Claude Desktop. Son emplacement varie selon le système :
- Sur Windows :
%APPDATA%\Claude\ - Sur macOS :
~/Library/Application Support/Claude/
Ouvrez cet emplacement dans l’explorateur de fichiers. Si le fichier n’existe pas encore, créez un document texte vide et nommez-le exactement claude_desktop_config.json. Ouvrez-le avec un éditeur de texte comme Visual Studio Code ou le Bloc-notes.
Saisir les paramètres de connexion
Copiez et adaptez le bloc suivant à l’intérieur du fichier :
{
"mcpServers": {
"home-assistant": {
"command": "uv",
"args": [
"run",
"--with",
"ha-mcp",
"ha-mcp"
],
"env": {
"HA_URL": "https://votre-instance.duckdns.org",
"HA_TOKEN": "votre-jeton-longue-duree"
}
}
}
}Remplacez HA_URL par l’adresse externe de votre instance, celle utilisée pour accéder à distance, avec le https://. Indiquez le jeton copié plus tôt dans HA_TOKEN. Si vous préférez utiliser Docker plutôt que l’outil uv, la commande et les arguments doivent pointer vers l’image voska/hass-mcp:latest. L’exemple ci-dessus avec uv convient dans la plupart des cas sur un poste de bureau.
Attention : respectez scrupuleusement la syntaxe JSON. Une virgule en trop ou un guillemet manquant empêchera Claude Desktop de démarrer. Si vous débutez, utilisez un validateur JSON en ligne pour contrôler votre code.
Redémarrer Claude Desktop et vérifier la connexion
Après avoir enregistré le fichier, fermez complètement Claude Desktop s’il était ouvert, puis relancez-le. Dans la fenêtre de discussion, une icône de marteau (ou de prise électrique) apparaît près du champ de saisie. Elle indique que des outils MCP sont disponibles. Si vous ne la voyez pas, consultez les journaux de débogage de l’application ou revérifiez l’URL et le jeton.
Pour tester, tapez une requête simple comme « Quel est l’état des lumières du salon ? ». Claude vous répondra en interrogeant directement vos entités domotiques. La réponse peut prendre quelques secondes la première fois.
Étape 2 : piloter et administrer votre domicile avec Claude
Une fois le pont établi, Claude devient un assistant technique capable d’interpréter le langage naturel pour interagir avec votre maison.
Obtenir un rapport d’état complet
Posez des questions simples pour surveiller votre habitation : « Toutes les fenêtres sont-elles fermées ? », « Quelle est la température dans la chambre ? », « Affiche la consommation électrique depuis minuit ». Claude lit les états des entités en temps réel et peut résumer des informations complexes. Vous pouvez aussi lui demander de lister les appareils allumés dans une pièce ou ceux qui n’ont pas été mis à jour récemment, ce qui permet de détecter des capteurs défaillants.
Créer une automatisation en langage naturel
Décrivez le comportement souhaité comme vous le feriez à un intégrateur. Par exemple : « Quand le détecteur de mouvement du couloir s’active la nuit, allume la lumière du couloir à 30 % pendant deux minutes, puis éteins-la. ». Claude génère le code YAML correspondant, prêt à être copié dans vos automations. Il peut même l’enregistrer directement dans Home Assistant si les permissions le permettent.
Astuce : demandez à Claude d’expliquer chaque bloc du code qu’il propose. Vous verrez plus vite ce qu’il fait et pourrez ajuster vous-même les automatisations.
Analyser et corriger les erreurs
Quand une automatisation ne se comporte pas comme prévu, Claude peut examiner les traces d’exécution (l’outil de débogage de Home Assistant). Dites « Analyse pourquoi la lumière de l’entrée ne s’est pas éteinte ce matin » et l’IA identifiera, par exemple, un déclencheur incorrect ou une transition d’état redondante qui bloque l’action. Cela fait gagner beaucoup de temps de diagnostic, surtout dans les installations de plus de 50 automations.
Gérer les tableaux de bord Lovelace et les helpers
Claude peut créer ou modifier des cartes pour vos tableaux de bord. Décrivez l’apparence désirée : « Ajoute une carte avec les températures de toutes les pièces sous forme de jauges ». Il peut aussi ajouter des helpers (input_boolean, input_number) pour stocker des états temporaires, ce qui aide pour des scénarios plus avancés.
🔒 Sécurité : avant de laisser l’IA modifier votre configuration en masse, faites un test sur une automatisation peu critique. Validez le résultat, puis confiez-lui seulement ensuite des modifications plus sensibles. Vérifiez aussi que votre pare-feu autorise les communications sortantes nécessaires si vous utilisez des connecteurs cloud.
Avec ces deux étapes, Home Assistant peut déjà répondre à des requêtes simples et proposer des changements concrets. Vous gagnez du temps sur la maintenance répétitive, tout en gardant la main sur votre installation.
