Verbind AI met je Home Assistant

Als je klaar bent, heb je een vers geïnstalleerde Home Assistant met Claude AI gekoppeld en Zigbee2MQTT goed ingesteld, klaar om je smart home op gang te brengen.

ONTHOUD! Voeg routers EERST toe aan je Zigbee-mesh (apparaten op netstroom, bijv. slimme stekkers en lampen), zodat je mesh sterk is voordat je batterijapparaten gaat toevoegen.

Dit heb je nodig
  • Een draaiende Home Assistant, of een pc en RepairGuyDK Installer for Home Assistant om het te installeren (zie stap 0). Buiten Denemarken wordt de installer verkocht als ISO-bestand om te downloaden, dat je zelf met Rufus of balenaEtcher op een USB-stick zet. De kant-en-klare USB-stick wordt alleen verkocht aan klanten in Denemarken.
  • Een gratis GitHub-account voor HACS. Maak het nu aan en log in.
  • Een Claude-account (gratis is genoeg om te proberen). Download Claude Desktop en log in met je account.
  • Een van deze twee routes (je kiest in stap 4):
    • Route 1: Nabu Casa (Home Assistant Cloud). Een betaald abonnement waarmee Claude overal werkt, ook op je telefoon en als je weg bent.
    • Route 2: Een Windows-pc in hetzelfde netwerk als Home Assistant. Gratis, maar werkt alleen thuis in Claude Desktop.
GitHub-account maken Claude-account maken Claude Desktop downloaden

Heb je de accounts en Claude Desktop al? Sla dit dan over.

Elke blauwe knop opent Home Assistant in een nieuw tabblad. Sluit het tabblad als je klaar bent met de stap, en ga terug naar deze gids.

  1. 0

    Draait Home Assistant al bij je?

    De gids begint wanneer Home Assistant al op een pc bij je thuis draait.

    Ja, dat heb ik Ga direct naar stap 2.
    Nee, nog niet Installeer het eerst met RepairGuyDK Installer for Home Assistant:
    1. Heb je het ISO-bestand gekocht, zet het dan eerst op een lege USB-stick met Rufus (kies DD Image als erom gevraagd wordt) of balenaEtcher. Alles op de stick wordt gewist. Heb je de USB-stick van RepairGuyDK, sla dit punt dan over.
    2. Steek de stick in de pc die je Home Assistant wordt. De hele schijf van de pc wordt gewist.
    3. In het BIOS: UEFI aan, Secure Boot uit, Legacy/CSM uit
    4. Start de pc vanaf USB (meestal F9, F12, F11 of Esc bij het opstarten) en kies de optie met UEFI
    5. Volg de instructies op het scherm en typ JA (in hoofdletters) als erom gevraagd wordt
    6. Haal de stick eruit, sluit een netwerkkabel aan en herstart. Wacht 10 tot 20 minuten en ga dan naar stap 1.
  2. 1

    Open Home Assistant en maak je account aan

    Open een browser op je pc of telefoon en ga naar:

    http://homeassistant.local

    Klik op Creëer mijn smart home, maak je gebruiker aan en geef aan waar je woont. Klik op de volgende pagina's op Volgende en sluit af met Voltooien. Schrijf het wachtwoord op.

    Eerste start: toont de pagina "Preparing Home Assistant", wacht dan 10 tot 20 minuten. Home Assistant downloadt zichzelf.

    Werkt het adres niet? Gebruik dan het IP-adres. Dat staat op het scherm van je Home Assistant-pc, bijv. http://192.168.1.50

  3. 2

    HACS installeren

    HACS is een extra app-store voor Home Assistant. We hebben hem nodig om de AI-verbinding op te halen.

    Heb je HACS al? Staat HACS in het menu links in Home Assistant, ga dan direct naar stap 3.

    A. HACS toevoegen aan Home Assistant
    1. De eerste keer dat je op zo'n knop klikt, vraagt de pagina om het adres van je Home Assistant. In het veld staat al http://homeassistant.local:8123. Wis dat, typ http://homeassistant.local zonder :8123 en klik op Save. Werkt dat niet, typ dan het IP-adres, bijv. http://192.168.1.50. Dat staat op het scherm van je Home Assistant-pc. Klik daarna op Open link.
    2. Je Home Assistant vraagt of je de app-repository wilt toevoegen. Klik op Voeg toe. Een repository is gewoon het adres van een extra winkel.
    3. Ga naar Instellingen › Apps › Installeer een app en typ HACS in het zoekveld bovenaan
    4. Open Get HACS, klik op Installeren en daarna op Starten. Het draait maar een paar seconden. Dat het daarna als gestopt staat, is heel normaal.
    5. Herstart Home Assistant: ga naar Instellingen, klik rechtsboven op de drie puntjes en kies Herstart Home Assistant. Wacht 1 tot 2 minuten tot de pagina terug is.
    B. HACS aanzetten
    1. Klik rechtsonder op de blauwe knop Voeg integratie toe
    2. Typ HACS in het zoekveld en kies HACS
    3. Vink alle vakjes aan en klik op Verzenden
    4. Je krijgt een code van 8 tekens en een link naar GitHub. Open de link, log in bij GitHub, typ de code en klik op Authorize HACS
    5. Ga terug naar Home Assistant en klik op Voltooi. Druk op F5, dan staat HACS in het menu links.
  4. 3

    De AI-verbinding installeren (HA-MCP)

    HA-MCP zorgt ervoor dat Claude met je huis kan praten. Het draait binnen Home Assistant.

    A. HA-MCP ophalen in HACS
    1. HACS opent de pagina van HA-MCP Custom Component. Vraagt het of je de repository wilt toevoegen, klik dan op Voeg toe.
    2. Klik rechtsonder op Download en daarna nog een keer op Download
    3. Herstart Home Assistant: ga naar Instellingen, klik rechtsboven op de drie puntjes en kies Herstart Home Assistant. Wacht 1 tot 2 minuten tot de pagina terug is.
      Sla de herstart NIET over! Zonder herstart vind je HA-MCP niet in de volgende stap.
    B. HA-MCP aanzetten
    1. Klik rechtsonder op de blauwe knop Voeg integratie toe
    2. Typ HA-MCP in het zoekveld en kies HA-MCP Custom Component
    3. Kies HA-MCP Server en klik op Verzenden
    4. Nu wordt gevraagd om een Administrator access token. Laat het venster open en open Home Assistant in een nieuw tabblad (Ctrl+T)
    5. In het nieuwe tabblad: klik op je naam onderaan het linkermenu, kies Beveiliging en scrol naar Toegangstokens met lange levensduur
    6. Klik op Maak token aan, typ de naam HA-MCP en klik op OK. Kopieer de code meteen; hij wordt maar één keer getoond
    7. Ga terug naar het tabblad met HA-MCP Server, plak de code in Administrator access token, laat gebruikersnaam en wachtwoord leeg en klik op Verzenden
    8. Een melding zegt dat de server is gestart, en HA-MCP verschijnt in het menu links. Dan werkt het.

    Belangrijk: Er mag maar één HA-MCP in je Home Assistant zijn. Ga naar Instellingen › Apps en zoek naar de app Home Assistant MCP Server. Staat die er, open hem dan en klik op Verwijder voordat je verdergaat. Staat hij er niet, dan hoef je niets te doen.

  5. 4

    Kies je route en zet de toegang aan

    HA-MCP start helemaal dicht, zodat niemand kan verbinden. Hier open je alleen de route die je wilt gebruiken.

    HA-MCP Server openen

    Klik naast HA-MCP Server op het tandwiel. Doe dan alleen wat onder jouw route staat:

    Route 1: Met Nabu Casa Werkt in claude.ai, in de Claude-app op de pc en op je telefoon, ook als je weg bent.
    1. Scrol voorbij Home Assistant URL (advanced) en zet een vinkje bij Remote access via webhook
    2. Laat Authentication mode op Sign in with Home Assistant (OAuth) staan
    3. Klik op Verzenden en klik opnieuw op het tandwiel
    4. Kopieer het adres met ui.nabu.casa. Ga naar stap 5.
    Route 2: Alleen thuis, gratis Werkt in Claude Desktop op een Windows-pc in je thuisnetwerk.
    1. Klik op het veld Network access (daar staat "This machine only (loopback)") en kies Local network
    2. Klik op Verzenden en klik opnieuw op het tandwiel
    3. Kopieer het hele adres met :9584/private_, inclusief http:// en :9584, bijv. http://192.168.1.50:9584/private_XJtn3QszNpRXaYYmM6YeVA. Het mag niet met 127.0.0.1 beginnen. Ga naar stap 6.

    Laat de andere velden in het venster met rust.

    Geen adres met ui.nabu.casa na Route 1? Dan staat Nabu Casa niet aan. Neem Route 2.

    Begint het adres na Route 2 met 127.0.0.1? Dan is Local network niet opgeslagen, en kan Claude je Home Assistant niet bereiken. Klik opnieuw op het tandwiel, kies Local network onder Network access, klik op Verzenden en open het tandwiel nog een keer. Nu begint het adres met het IP van je Home Assistant, bijv. http://192.168.1.50:9584/private_...

    Sluit het venster met X als je het adres hebt gekopieerd.

    Het adres is de sleutel van je huis. Wie het heeft, kan alles bedienen. Deel het niet, en maak het onleesbaar in screenshots en video's.

  6. 5
    Alleen Route 1: Nabu Casa

    Geef Claude het adres

    Je kunt het in de browser op claude.ai doen of in Claude Desktop. De knoppen zijn hetzelfde. Je hoeft het maar op één plek te doen.

    De verbinding wordt opgeslagen in je Claude-account. Daarna werkt hij overal waar je bent ingelogd: in de browser, in Claude Desktop en op je telefoon.

    claude.ai openen
    1. Open claude.ai in de browser of open Claude Desktop. Log in als daarom wordt gevraagd.
    2. Klik linksonder op je naam en kies Instellingen (Settings).
    3. Klik in het menu links op Connectors.
    4. Klik op de knop om een aangepaste connector (custom connector) toe te voegen.
    5. Typ in het veld Naam Home Assistant.
    6. Plak in het veld URL het adres met ui.nabu.casa uit stap 4 (rechtsklik en Plakken).
    7. Laat alle andere velden leeg en klik op Toevoegen (Add).
    8. Nu opent je Home Assistant. Log in met je eigen Home Assistant-gebruiker en klik op Toestaan (Allow). Nu is Claude verbonden.

    Klaar met Route 1? Sla stap 6 over en ga naar stap 7.

  7. 6
    Alleen Route 2: Lokaal op je pc

    Het RepairGuyDK-programma uitvoeren

    Het programma verbindt Claude Desktop met je Home Assistant. Je hoeft geen bestanden te bewerken. Heb je Claude Desktop nog niet, download het dan en log eerst in.

    Claude Desktop downloaden Claude Desktop openen

    Heb je Claude Desktop al, klik dan op Claude Desktop openen. Vraagt de browser of Claude geopend mag worden, klik dan op Openen. Heb je het niet, klik dan eerst op Claude Desktop downloaden.

    RepairGuyDK HA AI-verbinding downloaden

    Heb je de USB-stick van RepairGuyDK? Dan staat het programma daar ook op, in de map AI-verbinding op de schijf REPAIRGUYDK.

    1. Klik met de rechtermuisknop op het gedownloade zip-bestand en kies Alles uitpakken
    2. Dubbelklik op START-HIER
    3. Toont Windows "Windows heeft uw pc beveiligd", klik dan op Meer informatie en daarna op Toch uitvoeren
    4. Plak het adres met :9584/private_ uit stap 4 (rechtsklik in het venster om te plakken) en druk op Enter
    5. Draait Claude Desktop, dan vraagt het programma: Mag het programma Claude Desktop nu sluiten? (j/n). Typ de letter j (voor ja) en druk op Enter. Het programma installeert wat nodig is en start Claude opnieuw.
    6. Controleer in Claude Desktop onder Instellingen › Ontwikkelaar (Developer) dat home-assistant als actief wordt getoond
  8. 7

    Probeer het

    1. Start een nieuwe chat:
      Route 1: op claude.ai, in Claude Desktop of op je telefoon
      Route 2: in Claude Desktop
    2. Typ een van deze en druk op Enter:
    • Kun je mijn Home Assistant zien?
    • Geef me een gezondheidscheck van mijn Home Assistant.

    De eerste keer vraagt Claude of hij Home Assistant mag gebruiken. Klik op Toestaan.

Extra: MQTT en Zigbee2MQTT

Heb je een Zigbee-dongle, bijv. Home Assistant Connect ZBT of SONOFF? Dan installeer je MQTT en Zigbee2MQTT met vier klikken. Elke knop opent de juiste pagina in je eigen Home Assistant.

Toont de knop de pagina My Home Assistant met http://homeassistant.local:8123 in het veld? Wis :8123 zodat er http://homeassistant.local staat (of het IP-adres, bijv. http://192.168.1.50), en klik op Save. Dat gebeurt als je een andere browser of telefoon gebruikt dan in stap 2, en hoeft maar één keer per browser.

  1. A. Mosquitto (MQTT) installerenKlik op Installeren, zet alle schakelaars aan en klik op Starten.
  2. B. MQTT instellenBevestig dat je MQTT wilt instellen, kies "Use the official Mosquitto Mqtt Broker app" en klik op Voltooi als het gelukt is.
  3. C. Zigbee2MQTT toevoegenKlik op Voeg toe als gevraagd wordt of je de app-repository wilt toevoegen.
  4. D. Zigbee2MQTT installerenKlik op Installeren en zet alle schakelaars aan. Klik NIET op Starten! Claude start hem in de laatste stap voor je.

Laatste stap: Steek de Zigbee-dongle in je Home Assistant-pc. Start een nieuwe chat met Claude en schrijf:

Schrijf dit aan Claude (kopiëren/plakken)Stel Zigbee2MQTT in met mijn dongle en start hem. Vraag me welke dongle ik heb. Sla de poort en het adaptertype op in de instellingen van de app, en voeg onder env_vars name Z2M_ONBOARD_NO_SERVER toe met value "1", zodat de onboarding-pagina wordt overgeslagen. Lees de instellingen terug en controleer of ze zijn opgeslagen voordat je de app start. Controleer daarna in het logboek dat hij met de dongle en MQTT is verbonden, en dat er niet "Onboarding page is available" staat.

Claude vindt zelf de poort en het adaptertype en start Zigbee2MQTT voor je. Je hoeft daarna geen instelpagina in Zigbee2MQTT door te lopen.

🎉

Gefeliciteerd, je smart home is klaar!

Home Assistant draait, Claude is verbonden en Zigbee2MQTT staat klaar voor je apparaten. Goed gedaan!

Volgende stap: Voeg eerst je routers toe (apparaten op netstroom), zodat je Zigbee-mesh sterk is voordat de batterijapparaten erbij komen.

Schrijf eens aan Claude: "Maak een automatisering die het licht in de gang aandoet als de zon ondergaat"

Veel plezier van RepairGuyDK 🔧

Als iets niet lukt

Welke route moet ik kiezen?

Heb je Nabu Casa (Home Assistant Cloud), neem dan Route 1. Dat is het makkelijkst, en Claude werkt ook op je telefoon en als je weg bent. Heb je geen Nabu Casa, neem dan Route 2. Die is gratis, maar werkt alleen in Claude Desktop op een pc thuis. Of je Nabu Casa hebt, zie je onder Instellingen › Home Assistant Cloud:

Zie je dat je bent ingelogd en verbonden, dan heb je Nabu Casa. Neem Route 1.

Word je uitgenodigd om je huis op afstand te bedienen, dan heb je geen Nabu Casa. Neem Route 2.

De knoppen openen een pagina die niet reageert

Dan heeft je browser een verkeerd adres voor je Home Assistant opgeslagen, meestal met :8123 aan het eind. Open my.home-assistant.io/redirect/_change, wis wat er staat, typ het adres zonder :8123 (bijv. http://homeassistant.local of http://192.168.1.50) en klik op Save. Probeer de knop daarna opnieuw.

homeassistant.local opent niet

Sommige routers en telefoons kunnen de naam niet vinden. Gebruik het IP-adres dat op het scherm van je Home Assistant-pc staat. Je vindt het ook in de lijst met verbonden apparaten van je router.

Ik kan Get HACS of HA-MCP niet vinden
  • Get HACS: druk op F5 in de App-store. Helpt dat niet, klik dan rechtsboven op de drie puntjes en kies Op updates controleren.
  • HA-MCP onder Voeg integratie toe: je bent de herstart in stap 3 vergeten. Herstart Home Assistant en probeer het opnieuw.
Claude kan mijn Home Assistant niet zien
  • Route 1: controleer of Remote access via webhook is aangevinkt onder het tandwiel van HA-MCP Server, of je het hele adres met ui.nabu.casa hebt gekopieerd, en of externe toegang aanstaat onder Home Assistant Cloud. Verwijder de connector in claude.ai en voeg hem opnieuw toe.
  • Route 2: controleer of Network access op Local network staat onder het tandwiel van HA-MCP Server. Sluit Claude helemaal af via Bestand › Afsluiten (ook via het pictogram bij de klok) en open het opnieuw. Je pc moet in hetzelfde netwerk zitten als Home Assistant. Voer het RepairGuyDK-programma opnieuw uit met het adres met :9584. Controleer daarna in Claude Desktop onder Instellingen › Ontwikkelaar of home-assistant er staat.
  • Beide routes: controleer of HA-MCP in het menu links in Home Assistant staat. Kan Claude je spullen zien maar niet wijzigen, klik dan op het tandwiel naast HA-MCP Server en controleer of Read Only Mode uit (grijs) staat.
    Read Only Mode in HA-MCP Server met de schakelaar uit, rood gemarkeerd
Waar staat het instellingenbestand van Claude Desktop? (Route 2)

Het RepairGuyDK-programma vindt het bestand zelf, dus normaal hoef je het niet te zoeken. Wil je het zien, open dan Claude Desktop, ga naar Instellingen › Ontwikkelaar en klik op Configuratie bewerken (Edit Config). Het bestand heet claude_desktop_config.json.

  • Nieuwere versies van Claude Desktop voor Windows: C:\Users\JouwNaam\AppData\Local\Claude-Data\claude_..., waarbij de map eindigt op een code die per pc verschilt
  • Oudere versies en veel handleidingen online: %APPDATA%\Claude
  • AppData is een verborgen map. Typ het adres direct in de adresbalk van Verkenner, of zet verborgen items aan onder Beeld.

Het bestand hoort bij je Windows-gebruiker, niet bij je Claude-account. Wissel je tussen meerdere Claude-accounts op dezelfde Windows-gebruiker, dan krijgen ze allemaal dezelfde verbinding. Wil je ze gescheiden houden, gebruik dan een aparte Windows-gebruiker.

Is het veilig?

HA-MCP start helemaal dicht tot je zelf je route opent in stap 4. Het adres bevat een lange geheime sleutel die HA-MCP zelf heeft gemaakt. Bij Route 2 draait alles alleen in je eigen netwerk. Bij Route 1 loopt de verbinding versleuteld via Nabu Casa, en moet Claude bovendien inloggen met je Home Assistant-gebruiker voordat hij toegang krijgt. Claude vraagt toestemming voordat hij Home Assistant gebruikt. Heb je het adres per ongeluk gedeeld, verwijder dan HA-MCP Server onder Apparaten en diensten en voeg hem opnieuw toe; dan krijg je een nieuw adres.

Kan ik ChatGPT gebruiken in plaats daarvan?

Misschien, maar dat is niet getest en vraagt meer dan met Claude. ChatGPT kan alleen een eigen connector toevoegen met Plus of duurder, niet met gratis of Go. Je moet ook Developer mode in ChatGPT in de browser aanzetten. Het werkt alleen met Route 1 (Nabu Casa), omdat ChatGPT het RepairGuyDK-programma uit Route 2 niet kan gebruiken. OpenAI beperkt ook wat ChatGPT via zo'n connector mag wijzigen bij de goedkopere abonnementen. Deze gids is gemaakt en getest voor Claude, dat al werkt met het gratis account.

Is gratis Claude genoeg?

Om te proberen wel. Gratis Claude werkt met Home Assistant, en bij Route 1 mag je één aangepaste connector toevoegen. Gratis heeft een limiet op hoeveel je per 5 uur kunt gebruiken. Home Assistant-taken verbruiken veel, omdat Claude je apparaten, automatiseringen en logboeken leest. "Doe het licht in de woonkamer uit" is een kleine taak, terwijl "maak een dashboard" het grootste deel van een gratis tegoed kan gebruiken. Als de limiet bereikt is, vraagt Claude je te wachten. Dat is geen fout.

Wil je Claude gebruiken om automatiseringen of dashboards te bouwen of dingen als Zigbee2MQTT te installeren, dan raden we Claude Pro aan, dat minstens 5 keer zoveel gebruik geeft. Zie de actuele prijzen op claude.com/pricing.

Ik ben overgestapt op Claude Pro. Moet ik iets veranderen?

Nee. Upgrade je hetzelfde Claude-account, dan werkt alles meteen door. Bij Route 1 is de verbinding opgeslagen in je Claude-account, en bij Route 2 staat hij op je pc. Een upgrade verandert geen van beide.

Heb je in plaats daarvan een nieuw Claude-account voor Pro gemaakt, dan moet je bij Route 1 de connector opnieuw toevoegen zoals in stap 5. Route 2 blijft werken, omdat die bij je pc hoort. Sluit Claude Desktop na de upgrade gerust helemaal af via Bestand › Afsluiten en open het opnieuw.

Kan ik het ongedaan maken?

Ja. Verwijder HA-MCP Server onder Instellingen › Apparaten en diensten, en verwijder de connector in claude.ai. Het RepairGuyDK-programma maakt een back-up van de instellingen van Claude voordat het iets wijzigt.

Script en gids gemaakt door RepairGuyDK · Home Assistant, smart home en AI