Connectez l'IA à votre Home Assistant

À la fin, vous aurez un Home Assistant fraîchement installé avec Claude IA connecté et Zigbee2MQTT bien configuré, prêt à lancer votre maison connectée.

À RETENIR ! Ajoutez les routeurs à votre maillage Zigbee EN PREMIER (appareils branchés sur le secteur, par ex. prises et ampoules connectées), pour que le maillage soit solide avant d'ajouter les appareils sur pile.

Ce qu'il vous faut
  • Un Home Assistant en marche, ou un PC et RepairGuyDK Installer for Home Assistant pour l'installer (voir l'étape 0). En dehors du Danemark, l'installateur est vendu sous forme de fichier ISO à télécharger, que vous écrivez vous-même sur une clé USB avec Rufus ou balenaEtcher. La clé USB prête à l'emploi est vendue uniquement aux clients au Danemark.
  • Un compte GitHub gratuit pour HACS. Créez-le maintenant et connectez-vous.
  • Un compte Claude (le gratuit suffit pour essayer). Téléchargez Claude Desktop et connectez-vous avec votre compte.
  • L'une de ces deux voies (vous choisissez à l'étape 4) :
    • Voie 1 : Nabu Casa (Home Assistant Cloud). Un abonnement payant qui permet à Claude de fonctionner partout, aussi sur le téléphone et hors de chez vous.
    • Voie 2 : Un PC Windows sur le même réseau que Home Assistant. Gratuit, mais fonctionne uniquement à la maison dans Claude Desktop.
Créer un compte GitHub Créer un compte Claude Télécharger Claude Desktop

Vous avez déjà les comptes et Claude Desktop ? Passez cette partie.

Chaque bouton bleu ouvre Home Assistant dans un nouvel onglet. Fermez l'onglet quand l'étape est terminée et revenez à ce guide.

  1. 0

    Home Assistant tourne-t-il déjà chez vous ?

    Le guide commence quand Home Assistant tourne déjà sur un PC chez vous.

    Oui, je l'ai Passez directement à l'étape 2.
    Non, pas encore Installez-le d'abord avec RepairGuyDK Installer for Home Assistant :
    1. Si vous avez acheté le fichier ISO, écrivez-le d'abord sur une clé USB vide avec Rufus (choisissez DD Image quand il le demande) ou balenaEtcher. Tout le contenu de la clé est effacé. Si vous avez la clé USB de RepairGuyDK, passez ce point.
    2. Branchez la clé sur le PC qui deviendra votre Home Assistant. Tout le disque du PC est effacé.
    3. Dans le BIOS : UEFI activé, Secure Boot désactivé, Legacy/CSM désactivé
    4. Démarrez le PC depuis l'USB (souvent F9, F12, F11 ou Échap au démarrage) et choisissez l'option avec UEFI
    5. Suivez les instructions à l'écran et tapez OUI (en majuscules) quand il le demande
    6. Retirez la clé, branchez un câble réseau et redémarrez. Attendez 10 à 20 minutes, puis passez à l'étape 1.
  2. 1

    Ouvrez Home Assistant et créez votre compte

    Ouvrez un navigateur sur votre PC ou votre téléphone et allez sur :

    http://homeassistant.local

    Cliquez sur Créer ma maison connectée, créez votre utilisateur et indiquez où vous habitez. Cliquez sur Suivant dans les pages suivantes et terminez par Terminer. Notez le mot de passe.

    Premier démarrage : si la page affiche "Preparing Home Assistant", attendez 10 à 20 minutes. Home Assistant se télécharge.

    L'adresse ne fonctionne pas ? Utilisez l'adresse IP. Elle s'affiche sur l'écran de votre PC Home Assistant, par ex. http://192.168.1.50

  3. 2

    Installer HACS

    HACS est un magasin d'applications supplémentaire pour Home Assistant. Nous en avons besoin pour récupérer la connexion IA.

    Vous avez déjà HACS ? Si HACS apparaît dans le menu de gauche de Home Assistant, passez directement à l'étape 3.

    A. Ajouter HACS à Home Assistant
    1. La première fois que vous cliquez sur un tel bouton, la page demande l'adresse de votre Home Assistant. Le champ contient déjà http://homeassistant.local:8123. Effacez-le, tapez http://homeassistant.local sans :8123 et cliquez sur Save. Si cela ne fonctionne pas, tapez l'adresse IP, par ex. http://192.168.1.50. Elle s'affiche sur l'écran de votre PC Home Assistant. Cliquez ensuite sur Open link.
    2. Votre Home Assistant demande si vous voulez ajouter le dépôt d'applications. Cliquez sur Ajouter. Un dépôt est simplement l'adresse d'un magasin supplémentaire.
    3. Allez dans Paramètres › Applications › Installer une application et tapez HACS dans la recherche en haut
    4. Ouvrez Get HACS, cliquez sur Installer puis sur Démarrer. Il ne tourne que quelques secondes. Qu'il apparaisse ensuite comme arrêté est tout à fait normal.
    5. Redémarrez Home Assistant : allez dans Paramètres, cliquez sur les trois points en haut à droite et choisissez Redémarrer Home Assistant. Attendez 1 à 2 minutes que la page revienne.
    B. Activer HACS
    1. Cliquez sur le bouton bleu Ajouter une intégration en bas à droite
    2. Tapez HACS dans la recherche et choisissez HACS
    3. Cochez toutes les cases et cliquez sur Valider
    4. Vous recevez un code de 8 caractères et un lien vers GitHub. Ouvrez le lien, connectez-vous à GitHub, tapez le code et cliquez sur Authorize HACS
    5. Revenez dans Home Assistant et cliquez sur Terminer. Appuyez sur F5, et HACS apparaît dans le menu de gauche.
  4. 3

    Installer la connexion IA (HA-MCP)

    HA-MCP est ce qui permet à Claude de parler avec votre maison. Il tourne à l'intérieur de Home Assistant.

    A. Récupérer HA-MCP dans HACS
    1. HACS ouvre la page de HA-MCP Custom Component. S'il demande si vous voulez ajouter le dépôt, cliquez sur Ajouter.
    2. Cliquez sur Télécharger en bas à droite, puis encore sur Télécharger
    3. Redémarrez Home Assistant : allez dans Paramètres, cliquez sur les trois points en haut à droite et choisissez Redémarrer Home Assistant. Attendez 1 à 2 minutes que la page revienne.
      NE sautez PAS le redémarrage ! Sans redémarrage, vous ne trouverez pas HA-MCP à l'étape suivante.
    B. Activer HA-MCP
    1. Cliquez sur le bouton bleu Ajouter une intégration en bas à droite
    2. Tapez HA-MCP dans la recherche et choisissez HA-MCP Custom Component
    3. Choisissez HA-MCP Server et cliquez sur Valider
    4. Un Administrator access token est maintenant demandé. Laissez la fenêtre ouverte et ouvrez Home Assistant dans un nouvel onglet (Ctrl+T)
    5. Dans le nouvel onglet : cliquez sur votre nom en bas du menu de gauche, choisissez Sécurité et descendez jusqu'à Jetons d'accès longue durée
    6. Cliquez sur Créer un jeton, tapez le nom HA-MCP et cliquez sur OK. Copiez le code tout de suite ; il ne s'affiche qu'une fois
    7. Revenez à l'onglet de HA-MCP Server, collez le code dans Administrator access token, laissez vides l'utilisateur et le mot de passe et cliquez sur Valider
    8. Un message indique que le serveur a démarré, et HA-MCP apparaît dans le menu de gauche. Cela fonctionne.

    Important : Il ne doit y avoir qu'un seul HA-MCP dans votre Home Assistant. Allez dans Paramètres › Applications et cherchez l'application Home Assistant MCP Server. Si elle y est, ouvrez-la et cliquez sur Désinstaller avant de continuer. Si elle n'y est pas, vous n'avez rien à faire.

  5. 4

    Choisissez votre voie et activez l'accès

    HA-MCP démarre entièrement fermé, pour que personne ne puisse se connecter. Ici, vous ouvrez uniquement la voie que vous voulez utiliser.

    Ouvrir HA-MCP Server

    À côté de HA-MCP Server, cliquez sur la roue dentée. Faites ensuite uniquement ce qui est indiqué pour votre voie :

    Voie 1 : Avec Nabu Casa Fonctionne dans claude.ai, dans l'application Claude sur PC et sur votre téléphone, même hors de chez vous.
    1. Descendez au-delà de Home Assistant URL (advanced) et cochez Remote access via webhook
    2. Laissez Authentication mode sur Sign in with Home Assistant (OAuth)
    3. Cliquez sur Valider puis à nouveau sur la roue dentée
    4. Copiez l'adresse qui contient ui.nabu.casa. Passez à l'étape 5.
    Voie 2 : À la maison uniquement, gratuit Fonctionne dans Claude Desktop sur un PC Windows de votre réseau domestique.
    1. Cliquez sur le champ Network access (il indique "This machine only (loopback)") et choisissez Local network
    2. Cliquez sur Valider puis à nouveau sur la roue dentée
    3. Copiez l'adresse complète qui contient :9584/private_, avec http:// et :9584, par ex. http://192.168.1.50:9584/private_XJtn3QszNpRXaYYmM6YeVA. Elle ne doit pas commencer par 127.0.0.1. Passez à l'étape 6.

    Ne touchez pas aux autres champs de la fenêtre.

    Pas d'adresse avec ui.nabu.casa après la voie 1 ? Nabu Casa n'est alors pas activé. Prenez la voie 2.

    L'adresse commence par 127.0.0.1 après la voie 2 ? Local network n'a pas été enregistré, et Claude ne peut pas joindre votre Home Assistant. Cliquez à nouveau sur la roue dentée, choisissez Local network dans Network access, cliquez sur Valider et rouvrez la roue dentée. L'adresse commence maintenant par l'IP de votre Home Assistant, par ex. http://192.168.1.50:9584/private_...

    Fermez la fenêtre avec le X une fois l'adresse copiée.

    L'adresse est la clé de votre maison. Qui la possède peut tout contrôler. Ne la partagez pas, et masquez-la dans les captures d'écran et les vidéos.

  6. 5
    Voie 1 uniquement : Nabu Casa

    Donnez l'adresse à Claude

    Vous pouvez le faire dans le navigateur sur claude.ai ou dans Claude Desktop. Les boutons sont les mêmes. Il suffit de le faire à un seul endroit.

    La connexion est enregistrée dans votre compte Claude. Ensuite, elle fonctionne partout où vous êtes connecté : dans le navigateur, dans Claude Desktop et sur votre téléphone.

    Ouvrir claude.ai
    1. Ouvrez claude.ai dans le navigateur ou ouvrez Claude Desktop. Connectez-vous si on vous le demande.
    2. Cliquez sur votre nom en bas à gauche et choisissez Paramètres (Settings).
    3. Dans le menu de gauche, cliquez sur Connecteurs (Connectors).
    4. Cliquez sur le bouton pour ajouter un connecteur personnalisé (custom connector).
    5. Dans le champ Nom, tapez Home Assistant.
    6. Dans le champ URL, collez l'adresse avec ui.nabu.casa de l'étape 4 (clic droit et Coller).
    7. Laissez les autres champs vides et cliquez sur Ajouter (Add).
    8. Votre Home Assistant s'ouvre alors. Connectez-vous avec votre propre utilisateur Home Assistant et cliquez sur Autoriser (Allow). Claude est maintenant connecté.

    Vous avez terminé la voie 1 ? Sautez l'étape 6 et passez à l'étape 7.

  7. 6
    Voie 2 uniquement : En local sur votre PC

    Lancez le programme RepairGuyDK

    Le programme connecte Claude Desktop à votre Home Assistant. Vous n'avez aucun fichier à modifier. Si vous n'avez pas encore Claude Desktop, téléchargez-le et connectez-vous d'abord.

    Télécharger Claude Desktop Ouvrir Claude Desktop

    Si vous avez déjà Claude Desktop, cliquez sur Ouvrir Claude Desktop. Si le navigateur demande s'il peut ouvrir Claude, cliquez sur Ouvrir. Sinon, cliquez d'abord sur Télécharger Claude Desktop.

    Télécharger la connexion IA RepairGuyDK HA

    Vous avez la clé USB de RepairGuyDK ? Le programme s'y trouve aussi, dans le dossier Connexion-IA du lecteur REPAIRGUYDK.

    1. Faites un clic droit sur le fichier zip téléchargé et choisissez Extraire tout
    2. Double-cliquez sur DEMARRER-ICI
    3. Si Windows affiche "Windows a protégé votre ordinateur", cliquez sur Informations complémentaires puis sur Exécuter quand même
    4. Collez l'adresse avec :9584/private_ de l'étape 4 (clic droit dans la fenêtre pour coller) et appuyez sur Entrée
    5. Si Claude Desktop est ouvert, le programme demande : Le programme peut-il fermer Claude Desktop maintenant ? (o/n). Tapez la lettre o (pour oui) et appuyez sur Entrée. Le programme installe ce qu'il faut et rouvre Claude.
    6. Vérifiez dans Claude Desktop, sous Paramètres › Développeur (Developer), que home-assistant apparaît comme actif
  8. 7

    Essayez

    1. Commencez une nouvelle conversation :
      Voie 1 : sur claude.ai, dans Claude Desktop ou sur votre téléphone
      Voie 2 : dans Claude Desktop
    2. Tapez l'une de ces phrases et appuyez sur Entrée :
    • Peux-tu voir mon Home Assistant ?
    • Fais-moi un bilan de santé de mon Home Assistant.

    La première fois, Claude demande s'il peut utiliser Home Assistant. Cliquez sur Autoriser.

Extra : MQTT et Zigbee2MQTT

Vous avez un dongle Zigbee, par ex. Home Assistant Connect ZBT ou SONOFF ? Vous pouvez alors installer MQTT et Zigbee2MQTT en quatre clics. Chaque bouton ouvre la bonne page dans votre propre Home Assistant.

Le bouton affiche la page My Home Assistant avec http://homeassistant.local:8123 dans le champ ? Effacez :8123 pour obtenir http://homeassistant.local (ou l'adresse IP, par ex. http://192.168.1.50) et cliquez sur Save. Cela arrive si vous utilisez un autre navigateur ou un autre téléphone qu'à l'étape 2, et ne se fait qu'une fois par navigateur.

  1. A. Installer Mosquitto (MQTT)Cliquez sur Installer, activez tous les interrupteurs et cliquez sur Démarrer.
  2. B. Configurer MQTTConfirmez que vous voulez configurer MQTT, choisissez "Use the official Mosquitto Mqtt Broker app" et cliquez sur Terminer quand c'est réussi.
  3. C. Ajouter Zigbee2MQTTCliquez sur Ajouter quand il demande si vous voulez ajouter le dépôt d'applications.
  4. D. Installer Zigbee2MQTTCliquez sur Installer et activez tous les interrupteurs. NE cliquez PAS sur Démarrer ! Claude le démarre pour vous à la dernière étape.

Dernière étape : Branchez le dongle Zigbee sur votre PC Home Assistant. Commencez une nouvelle conversation avec Claude et écrivez :

Écrivez ceci à Claude (copier/coller)Configure Zigbee2MQTT avec mon dongle et démarre-le. Demande-moi quel dongle j'ai. Enregistre le port et le type d'adaptateur dans les réglages de l'application, et dans env_vars ajoute name Z2M_ONBOARD_NO_SERVER avec value "1", pour sauter la page de configuration initiale. Relis les réglages et vérifie qu'ils sont enregistrés avant de démarrer l'application. Vérifie ensuite dans le journal qu'il est connecté au dongle et à MQTT, et que "Onboarding page is available" n'apparaît pas.

Claude trouve lui-même le port et le type d'adaptateur et démarre Zigbee2MQTT pour vous. Vous n'avez ensuite aucune page de configuration à parcourir dans Zigbee2MQTT.

🎉

Félicitations, votre maison connectée est prête !

Home Assistant tourne, Claude est connecté et Zigbee2MQTT est prêt pour vos appareils. Bravo !

Étape suivante : Ajoutez d'abord vos routeurs (appareils branchés sur le secteur), pour que votre maillage Zigbee soit solide avant l'arrivée des appareils sur pile.

Essayez d'écrire à Claude : "Crée une automatisation qui allume la lumière du couloir au coucher du soleil"

Amusez-vous bien, de la part de RepairGuyDK 🔧

En cas de problème

Quelle voie choisir ?

Si vous avez Nabu Casa (Home Assistant Cloud), prenez la voie 1. C'est le plus simple, et Claude fonctionne aussi sur le téléphone et hors de chez vous. Si vous n'avez pas Nabu Casa, prenez la voie 2. Elle est gratuite, mais fonctionne uniquement dans Claude Desktop sur un PC à la maison. Vous voyez si vous avez Nabu Casa dans Paramètres › Home Assistant Cloud :

S'il indique que vous êtes connecté, vous avez Nabu Casa. Prenez la voie 1.

S'il vous invite à contrôler votre maison à distance, vous n'avez pas Nabu Casa. Prenez la voie 2.

Les boutons ouvrent une page qui ne répond pas

Votre navigateur a alors enregistré une mauvaise adresse pour votre Home Assistant, en général avec :8123 à la fin. Ouvrez my.home-assistant.io/redirect/_change, effacez ce qui s'y trouve, tapez l'adresse sans :8123 (par ex. http://homeassistant.local ou http://192.168.1.50) et cliquez sur Save. Réessayez ensuite le bouton.

homeassistant.local ne s'ouvre pas

Certaines box et certains téléphones ne trouvent pas le nom. Utilisez l'adresse IP qui s'affiche sur l'écran de votre PC Home Assistant. Vous la trouvez aussi dans la liste des appareils connectés de votre box.

Je ne trouve pas Get HACS ou HA-MCP
  • Get HACS : appuyez sur F5 dans le Magasin d'applications. Si cela ne suffit pas, cliquez sur les trois points en haut à droite et choisissez Rechercher des mises à jour.
  • HA-MCP dans Ajouter une intégration : vous avez oublié le redémarrage de l'étape 3. Redémarrez Home Assistant et réessayez.
Claude ne voit pas mon Home Assistant
  • Voie 1 : vérifiez que Remote access via webhook est coché sous la roue dentée de HA-MCP Server, que vous avez copié l'adresse complète avec ui.nabu.casa, et que l'accès à distance est activé dans Home Assistant Cloud. Supprimez le connecteur dans claude.ai et ajoutez-le à nouveau.
  • Voie 2 : vérifiez que Network access est sur Local network sous la roue dentée de HA-MCP Server. Fermez complètement Claude avec Fichier › Quitter (aussi via l'icône près de l'horloge) et rouvrez-le. Votre PC doit être sur le même réseau que Home Assistant. Relancez le programme RepairGuyDK avec l'adresse contenant :9584. Vérifiez ensuite dans Claude Desktop, sous Paramètres › Développeur, que home-assistant y figure.
  • Les deux voies : vérifiez que HA-MCP apparaît dans le menu de gauche de Home Assistant. Si Claude voit vos appareils mais ne peut pas les modifier, cliquez sur la roue dentée à côté de HA-MCP Server et vérifiez que Read Only Mode est désactivé (gris).
    Read Only Mode dans HA-MCP Server avec l'interrupteur désactivé, entouré en rouge
Où se trouve le fichier de réglages de Claude Desktop ? (Voie 2)

Le programme RepairGuyDK trouve le fichier tout seul, vous n'avez donc normalement pas à le chercher. Si vous voulez le voir, ouvrez Claude Desktop, allez dans Paramètres › Développeur et cliquez sur Modifier la configuration (Edit Config). Le fichier s'appelle claude_desktop_config.json.

  • Versions récentes de Claude Desktop pour Windows : C:\Users\VotreNom\AppData\Local\Claude-Data\claude_..., où le dossier se termine par un code qui varie d'un PC à l'autre
  • Anciennes versions et beaucoup de guides en ligne : %APPDATA%\Claude
  • AppData est un dossier caché. Tapez l'adresse directement dans la barre d'adresse de l'Explorateur de fichiers, ou affichez les éléments masqués dans Affichage.

Le fichier appartient à votre utilisateur Windows, pas à votre compte Claude. Si vous passez d'un compte Claude à l'autre sur le même utilisateur Windows, ils auront tous la même connexion. Pour les garder séparés, utilisez un autre utilisateur Windows.

Est-ce sûr ?

HA-MCP démarre entièrement fermé jusqu'à ce que vous ouvriez votre voie à l'étape 4. L'adresse contient une longue clé secrète que HA-MCP a créée lui-même. Avec la voie 2, tout fonctionne uniquement sur votre propre réseau. Avec la voie 1, la connexion passe chiffrée par Nabu Casa, et Claude doit en plus se connecter avec votre utilisateur Home Assistant avant d'avoir accès. Claude demande l'autorisation avant d'utiliser Home Assistant. Si vous avez partagé l'adresse par erreur, supprimez HA-MCP Server dans Appareils et services et ajoutez-le à nouveau ; vous obtenez alors une nouvelle adresse.

Puis-je utiliser ChatGPT à la place ?

Peut-être, mais ce n'est pas testé et cela demande plus qu'avec Claude. ChatGPT ne peut ajouter un connecteur personnalisé qu'avec Plus ou plus cher, pas avec l'offre gratuite ni Go. Il faut aussi activer le Developer mode de ChatGPT dans le navigateur. Cela ne fonctionne qu'avec la voie 1 (Nabu Casa), car ChatGPT ne peut pas utiliser le programme RepairGuyDK de la voie 2. OpenAI limite aussi ce que ChatGPT peut modifier via un tel connecteur dans les offres les moins chères. Ce guide est conçu et testé pour Claude, qui fonctionne déjà avec le compte gratuit.

Claude gratuit suffit-il ?

Pour essayer, oui. Claude gratuit fonctionne avec Home Assistant, et avec la voie 1 vous pouvez ajouter un connecteur personnalisé. La version gratuite a une limite d'utilisation toutes les 5 heures. Les tâches Home Assistant consomment beaucoup, car Claude lit vos appareils, automatisations et journaux. "Éteins la lumière du salon" est une petite tâche, alors que "crée un tableau de bord" peut utiliser la majeure partie de la limite gratuite. Quand la limite est atteinte, Claude vous demande d'attendre. Ce n'est pas une erreur.

Si vous voulez utiliser Claude pour créer des automatisations ou des tableaux de bord, ou installer des choses comme Zigbee2MQTT, nous recommandons Claude Pro, qui offre au moins 5 fois plus d'utilisation. Consultez les prix actuels sur claude.com/pricing.

Je suis passé à Claude Pro. Dois-je changer quelque chose ?

Non. Si vous passez le même compte Claude à Pro, tout continue de fonctionner immédiatement. Avec la voie 1, la connexion est enregistrée dans votre compte Claude, et avec la voie 2 elle est sur votre PC. Un changement d'offre ne modifie ni l'une ni l'autre.

Si vous avez plutôt créé un nouveau compte Claude pour Pro, vous devez avec la voie 1 ajouter à nouveau le connecteur comme à l'étape 5. La voie 2 continue de fonctionner, car elle est liée à votre PC. Vous pouvez fermer complètement Claude Desktop avec Fichier › Quitter et le rouvrir après le changement.

Puis-je tout annuler ?

Oui. Supprimez HA-MCP Server dans Paramètres › Appareils et services, et retirez le connecteur dans claude.ai. Le programme RepairGuyDK fait une sauvegarde des réglages de Claude avant de modifier quoi que ce soit.

Script et guide créés par RepairGuyDK · Home Assistant, maison connectée et IA