Collega l'IA al tuo Home Assistant

Guida di avvio RepairGuyDK

Collega l'IA al tuo Home Assistant+ Zigbee2MQTT Bonus

Alla fine avrai un Home Assistant appena installato con Claude IA collegato e Zigbee2MQTT configurato correttamente, pronto per far partire la tua casa intelligente.

RICORDA! Aggiungi PRIMA i router alla tua rete mesh Zigbee (dispositivi alimentati dalla corrente, ad es. prese smart e lampadine), così la rete è solida prima di iniziare ad aggiungere i dispositivi a batteria.

SONOFF Dongle Plus MG24, chiavetta USB Zigbee con la sua scatola
✔ Testato con

SONOFF Dongle Plus MG24 (Silicon Labs EFR32MG24)

Dovrebbe funzionare anche con la maggior parte delle altre chiavette USB Zigbee.

I coordinatori LAN e PoE non sono testati!

Cosa ti serve
  • Un Home Assistant funzionante, oppure un PC e RepairGuyDK Installer for Home Assistant per installarlo (vedi il passo 0). Fuori dalla Danimarca l'installer è venduto come file ISO da scaricare, che scrivi tu stesso su una chiavetta USB con Rufus o balenaEtcher. La chiavetta USB già pronta è venduta solo ai clienti in Danimarca.
  • Un account GitHub gratuito per HACS. Crealo adesso e accedi.
  • Un account Claude (quello gratuito basta per provare). Scarica Claude Desktop e accedi con il tuo account.
  • Uno di questi due percorsi (scegli al passo 4):
    • Percorso 1: Nabu Casa (Home Assistant Cloud). Un abbonamento a pagamento con cui Claude funziona ovunque, anche sul telefono e quando sei fuori casa.
    • Percorso 2: Un PC Windows sulla stessa rete di Home Assistant. Gratis, ma funziona solo a casa in Claude Desktop.
Crea account GitHub Crea account Claude Scarica Claude Desktop

Hai già gli account e Claude Desktop? Allora salta questo punto.

Ogni pulsante blu apre Home Assistant in una nuova scheda. Chiudi la scheda quando hai finito il passo e torna a questa guida.

  1. 0

    Hai già Home Assistant in funzione?

    La guida parte da quando Home Assistant è già in funzione su un PC di casa tua.

    ✅ Sì, ce l'ho Ottimo, allora puoi saltare l'installazione. Vai al passo 2 ↓
    💿 No, non ancora Prima installalo con RepairGuyDK Installer for Home Assistant:
    1. Se hai acquistato il file ISO, scrivilo prima su una chiavetta USB vuota con Rufus (scegli DD Image quando te lo chiede) o balenaEtcher. ⚠ Tutto il contenuto della chiavetta viene cancellato. Se hai la chiavetta USB di RepairGuyDK, salta questo punto.
    2. Inserisci la chiavetta nel PC che diventerà il tuo Home Assistant. ⚠ L'intero disco del PC viene cancellato.
    3. Nel BIOS: UEFI attivo, Secure Boot disattivato, Legacy/CSM disattivato
    4. Avvia il PC dalla chiavetta USB (di solito con F9, F12, F11 o Esc all'accensione) e scegli la voce UEFI
    5. Segui le istruzioni sullo schermo e scrivi SI (in maiuscolo) quando te lo chiede
    6. Togli la chiavetta, collega un cavo di rete e riavvia. Aspetta qualche minuto, poi vai al passo 1.
  2. 1

    Apri Home Assistant e crea il tuo account

    Apri un browser sul PC o sul telefono e vai a:

    http://homeassistant.local

    Scegli la lingua, crea il tuo utente e indica dove abiti. Annota la password.

    Primo avvio: se la pagina mostra "Preparing Home Assistant", aspetta qualche minuto. Home Assistant si sta scaricando.

    L'indirizzo non funziona? Usa invece l'indirizzo IP. Lo trovi sullo schermo del PC con Home Assistant, ad es. http://192.168.1.50

  3. 2

    Installa HACS

    HACS è uno store di app aggiuntivo per Home Assistant. Ci serve per ottenere il collegamento IA.

    Hai già HACS? Se HACS compare nel menu a sinistra di Home Assistant, vai direttamente al passo 3.

    A. Aggiungi HACS a Home Assistant
    1. La prima volta che clicchi un pulsante come questo, la pagina ti chiede l'indirizzo del tuo Home Assistant. Nel campo c'è già scritto http://homeassistant.local:8123. Cancellalo, scrivi http://homeassistant.local senza :8123 e clicca Save. Se non funziona, scrivi l'indirizzo IP, ad es. http://192.168.1.50. Lo trovi sullo schermo del PC con Home Assistant. Poi clicca Open link.
    2. Il tuo Home Assistant ti chiede se vuoi aggiungere il repository. Clicca Aggiungi. Un repository è semplicemente l'indirizzo di uno store aggiuntivo.
    3. Vai su Impostazioni › App › Installa app e scrivi HACS nel campo di ricerca in alto
    4. Apri Get HACS, clicca Installa e poi Avvia. Resta in funzione solo pochi secondi. È del tutto normale che dopo risulti fermata.
    5. Riavvia Home Assistant: vai su Impostazioni, clicca i tre puntini in alto a destra e scegli Riavvia Home Assistant. Aspetta 1 o 2 minuti finché la pagina non torna.
    B. Attiva HACS
    1. Clicca il pulsante blu Aggiungi integrazione in basso a destra
    2. Scrivi HACS nel campo di ricerca e scegli HACS
    3. Spunta tutte le caselle e clicca Invia
    4. Ricevi un codice di 8 caratteri e un link a GitHub. Apri il link, accedi a GitHub, inserisci il codice e clicca Authorize HACS
    5. Torna su Home Assistant e clicca Fine. Premi F5 e HACS comparirà nel menu a sinistra.
  4. 3

    Installa il collegamento IA (HA-MCP)

    HA-MCP è ciò che permette a Claude di parlare con la tua casa. Funziona dentro Home Assistant.

    A. Scarica HA-MCP in HACS
    1. HACS apre la pagina di HA-MCP Custom Component. Se ti chiede se vuoi aggiungere il repository, clicca Aggiungi.
    2. Clicca Scarica in basso a destra e poi di nuovo Scarica
    3. Riavvia Home Assistant: vai su Impostazioni, clicca i tre puntini in alto a destra e scegli Riavvia Home Assistant. Aspetta 1 o 2 minuti finché la pagina non torna.
      NON saltare il riavvio! Senza riavvio non troverai HA-MCP nel passo successivo.
    B. Attiva HA-MCP
    1. Clicca il pulsante blu Aggiungi integrazione in basso a destra
    2. Scrivi HA-MCP nel campo di ricerca e scegli HA-MCP Custom Component
    3. Scegli HA-MCP Server e clicca Invia
    4. Ora ti chiede un Administrator access token. Lascia aperta la finestra e apri Home Assistant in una nuova scheda (Ctrl+T)
    5. Nella nuova scheda: clicca sul tuo nome in fondo al menu a sinistra, scegli Sicurezza e scorri fino a Token di accesso a lungo termine
    6. Clicca Crea token, scrivi il nome HA-MCP e clicca OK. Copia subito il codice: viene mostrato una sola volta
    7. Torna alla scheda con HA-MCP Server, incolla il codice in Administrator access token, lascia vuoti i campi nome utente e password e clicca Invia
    8. Un messaggio ti dice che il server è stato avviato e HA-MCP compare nel menu a sinistra. A questo punto funziona.

    Importante: Nel tuo Home Assistant deve esserci un solo HA-MCP. Vai su Impostazioni › App e cerca l'app Home Assistant MCP Server. Se c'è, aprila e clicca Disinstalla prima di continuare. Se non c'è, non devi fare nulla.

  5. 4

    Scegli il tuo percorso e attiva l'accesso

    HA-MCP parte completamente chiuso, quindi nessuno può collegarsi. Qui apri solo il percorso che vuoi usare.

    Apri HA-MCP Server

    Accanto a HA-MCP Server, clicca l'ingranaggio. Poi fai solo quello che è indicato nel tuo percorso:

    Percorso 1: Con Nabu Casa Funziona su claude.ai, nell'app Claude sul PC e sul telefono, anche quando sei fuori casa.
    1. ⚙️ Clicca l'ingranaggio accanto a HA-MCP Server. Si trova sul lato destro della riga.
    2. Scorri oltre Home Assistant URL (advanced) e spunta Remote access via webhook
    3. Lascia Authentication mode su Sign in with Home Assistant (OAuth)
    4. Clicca Invia e poi di nuovo l'ingranaggio
    5. Copia l'indirizzo che contiene ui.nabu.casa. Vai al passo 5.
    Percorso 2: Solo a casa, gratis Funziona in Claude Desktop su un PC Windows della tua rete di casa.
    1. ⚙️ Clicca l'ingranaggio accanto a HA-MCP Server. Si trova sul lato destro della riga.
    2. Clicca il campo Network access (c'è scritto "This machine only (loopback)") e scegli Local network
    3. Clicca Invia e poi di nuovo l'ingranaggio
    4. Copia l'indirizzo completo che contiene :9584/private_, compresi http:// e :9584, ad es. http://192.168.1.50:9584/private_XJtn3QszNpRXaYYmM6YeVA. Non deve iniziare con 127.0.0.1. Vai al passo 6.

    Non toccare gli altri campi della finestra.

    Nessun indirizzo con ui.nabu.casa dopo il Percorso 1? Allora Nabu Casa non è attivo. Segui il Percorso 2.

    L'indirizzo inizia con 127.0.0.1 dopo il Percorso 2? Allora Local network non è stato salvato e Claude non riesce a raggiungere il tuo Home Assistant. Clicca di nuovo l'ingranaggio, scegli Local network in Network access, clicca Invia e apri l'ingranaggio ancora una volta. Ora l'indirizzo inizia con l'IP del tuo Home Assistant, ad es. http://192.168.1.50:9584/private_...

    Chiudi la finestra con la X dopo aver copiato l'indirizzo.

    L'indirizzo è la chiave di casa tua. Chi ce l'ha può controllare tutto. Non condividerlo e oscuralo negli screenshot e nei video.

  6. 5
    Solo Percorso 1: Nabu Casa

    Dai l'indirizzo a Claude

    Puoi farlo nel browser su claude.ai oppure in Claude Desktop. I pulsanti sono gli stessi. Devi farlo solo in uno dei due posti.

    Il collegamento viene salvato nel tuo account Claude. Dopo funziona ovunque tu abbia effettuato l'accesso: nel browser, in Claude Desktop e sul telefono.

    Apri claude.ai
    1. Apri claude.ai nel browser oppure apri Claude Desktop. Accedi se te lo chiede.
    2. Clicca sul tuo nome in basso a sinistra e scegli Impostazioni (Settings).
    3. Nel menu a sinistra, clicca Connettori (Connectors).
    4. Clicca il pulsante per aggiungere un connettore personalizzato (custom connector).
    5. Nel campo Nome (Name) scrivi Home Assistant.
    6. Nel campo URL incolla l'indirizzo con ui.nabu.casa del passo 4 (clic destro e scegli Incolla).
    7. Lascia vuoti tutti gli altri campi e clicca Aggiungi (Add).
    8. Ora si apre il tuo Home Assistant. Accedi con il tuo utente di Home Assistant e clicca Consenti (Allow). Ora Claude è collegato.

    Hai finito il Percorso 1? Salta il passo 6 e vai al passo 7.

  7. 6
    Solo Percorso 2: In locale sul tuo PC

    Avvia il programma RepairGuyDK

    Il programma collega Claude Desktop al tuo Home Assistant. Non devi modificare nessun file. Se non hai ancora Claude Desktop, scaricalo e accedi prima di tutto.

    Scarica Claude Desktop Apri Claude Desktop

    Se hai già Claude Desktop, clicca Apri Claude Desktop. Se il browser ti chiede se può aprire Claude, clicca Apri. Se non ce l'hai, clicca prima Scarica Claude Desktop.

    📂 Trova il programma sulla chiavetta USB

    Apri l'unità REPAIRGUYDK della tua chiavetta USB in Esplora file. Entra nella cartella della tua lingua e poi nella cartella Connessione-IA:

    REPAIRGUYDK›Italiano›Connessione-IA›AVVIA-QUI

    Non hai la chiavetta a portata di mano? Scarica qui il programma come file zip. Fai clic destro sul file zip e scegli Estrai tutto prima di continuare.

    1. Fai doppio clic su AVVIA-QUI
    2. Se Windows mostra "PC protetto da Windows", clicca Ulteriori informazioni e poi Esegui comunque
    3. Incolla l'indirizzo con :9584/private_ del passo 4 (clic destro nella finestra per incollare) e premi Invio
    4. Se Claude Desktop è aperto, il programma chiede: Il programma può chiudere Claude Desktop adesso? (s/n). Scrivi la lettera s (per sì) e premi Invio. Il programma installa ciò che serve e riavvia Claude.
    5. In Claude Desktop, controlla in Impostazioni › Sviluppatore (Developer) che home-assistant risulti in esecuzione
  8. 7

    Provalo

    1. Avvia una nuova chat:
      Percorso 1: su claude.ai, in Claude Desktop o sul telefono
      Percorso 2: in Claude Desktop
      Scegli l'icona della chat (verde) in alto in Claude Desktop, non l'icona del codice (rossa).Scegli l'icona della chat (verde) in alto in Claude Desktop, non l'icona </> (rossa).
    2. Scrivi una di queste frasi e premi Invio:
    • Riesci a vedere il mio Home Assistant?
    • Fammi un controllo dello stato di salute del mio Home Assistant.

    La prima volta Claude chiede se può usare Home Assistant. Clicca Consenti.

Extra: MQTT e Zigbee2MQTT

Hai un dongle Zigbee, ad es. Home Assistant Connect ZBT o SONOFF? Allora puoi installare MQTT e Zigbee2MQTT con quattro clic. Ogni pulsante apre la pagina giusta nel tuo Home Assistant.

Il pulsante mostra la pagina My Home Assistant con http://homeassistant.local:8123 nel campo? Cancella :8123 in modo che ci sia scritto http://homeassistant.local (oppure l'indirizzo IP, ad es. http://192.168.1.50) e clicca Save. Succede quando usi un browser o un telefono diverso da quello del passo 2, e va fatto solo una volta per browser.

  1. A. Installa Mosquitto (MQTT)Clicca Installa, attiva tutti gli interruttori e clicca Avvia.
  2. B. Configura MQTTConferma che vuoi configurare MQTT, scegli "Use the official Mosquitto Mqtt Broker app" e clicca Fine quando indica che è andato a buon fine.
  3. C. Aggiungi Zigbee2MQTTClicca Aggiungi quando ti chiede se vuoi aggiungere il repository.
  4. D. Installa Zigbee2MQTTClicca Installa e attiva tutti gli interruttori. NON cliccare Avvia! Claude la avvierà per te nell'ultimo passo.

Ultimo passo: Inserisci il dongle Zigbee nel PC con Home Assistant. Avvia una nuova chat con Claude e scrivi:

Scrivi questo a Claude (copia/incolla)Configura Zigbee2MQTT con il mio dongle. Chiedimi quale dongle ho. Trova la porta (preferibilmente quella che inizia con /dev/serial/by-id/) e il tipo di adattatore corretto, e salvali sotto serial nelle impostazioni dell'app Zigbee2MQTT come port e adapter. Rileggi le impostazioni e controlla che siano salvate. Poi avvia l'app e dimmi quale porta e quale adattatore hai scelto.

Se la configurazione automatica del dongle non riesce, si risolve facilmente: Clicca Zigbee2MQTT nel menu a sinistra di Home Assistant. Probabilmente vedrai una pagina chiamata Onboarding con una casella vuota in alto. Clicca la casella e scegli il tuo adattatore nel menu (probabilmente verso il fondo). Poi scorri fino in fondo alla pagina e clicca Submit. Ora Zigbee2MQTT dovrebbe avviarsi correttamente dopo qualche secondo. Se vedi un'icona strana, premi F5 per ricaricare la pagina.

Zigbee2MQTT Onboarding: 1 adapter, 2 SONOFF, 3 Submit

🎉

Congratulazioni, la tua casa intelligente è pronta!

Home Assistant è in funzione, Claude è collegato e Zigbee2MQTT è pronto per i tuoi dispositivi. Ottimo lavoro!

Prossimo passo: Aggiungi prima i tuoi router (dispositivi alimentati dalla corrente), così la tua rete mesh Zigbee è solida prima che arrivino i dispositivi a batteria.

Prova a scrivere a Claude: "Crea un'automazione che accenda la luce del corridoio quando tramonta il sole"

Buon divertimento da RepairGuyDK 🔧

Se qualcosa va storto

Quale percorso scelgo?

Se hai Nabu Casa (Home Assistant Cloud), segui il Percorso 1. È il più semplice e Claude funziona anche sul telefono e quando sei fuori casa. Se non hai Nabu Casa, segui il Percorso 2. È gratis, ma funziona solo in Claude Desktop su un PC a casa. Puoi vedere se hai Nabu Casa in Impostazioni › Home Assistant Cloud:

Se mostra che hai effettuato l'accesso e sei connesso, hai Nabu Casa. Segui il Percorso 1.

Se ti invita a controllare la tua casa quando sei fuori, non hai Nabu Casa. Segui il Percorso 2.

I pulsanti aprono una pagina che non risponde

Allora il tuo browser ha salvato un indirizzo sbagliato per il tuo Home Assistant, di solito con :8123 alla fine. Apri my.home-assistant.io/redirect/_change, cancella quello che c'è, scrivi l'indirizzo senza :8123 (ad es. http://homeassistant.local o http://192.168.1.50) e clicca Save. Poi riprova il pulsante.

homeassistant.local non si apre

Alcuni router e telefoni non riescono a trovare il nome. Usa l'indirizzo IP che compare sullo schermo del PC con Home Assistant. Lo trovi anche nell'elenco dei dispositivi connessi del tuo router.

Non trovo Get HACS o HA-MCP
  • Get HACS: premi F5 nello store delle app. Se non basta, clicca i tre puntini in alto a destra e scegli Controlla aggiornamenti.
  • HA-MCP in Aggiungi integrazione: hai dimenticato il riavvio del passo 3. Riavvia Home Assistant e riprova.
Claude non vede il mio Home Assistant
  • Percorso 1: controlla che Remote access via webhook sia spuntato nell'ingranaggio di HA-MCP Server, di aver copiato l'indirizzo completo con ui.nabu.casa e che l'accesso remoto sia attivo in Home Assistant Cloud. Elimina il connettore su claude.ai e aggiungilo di nuovo.
  • Percorso 2: controlla che Network access sia impostato su Local network nell'ingranaggio di HA-MCP Server. Chiudi Claude completamente con File › Esci (anche dall'icona vicino all'orologio) e riaprilo. Il tuo PC deve essere sulla stessa rete di Home Assistant. Avvia di nuovo il programma RepairGuyDK con l'indirizzo che contiene :9584. Poi controlla in Claude Desktop, in Impostazioni › Sviluppatore, che home-assistant compaia nell'elenco.
  • Entrambi i percorsi: controlla che HA-MCP compaia nel menu a sinistra di Home Assistant. Se Claude vede le tue cose ma non riesce a modificarle, clicca l'ingranaggio accanto a HA-MCP Server e controlla che Read Only Mode sia disattivato (grigio).
    Read Only Mode in HA-MCP Server con l'interruttore disattivato, evidenziato in rosso
Claude dice che funziona nel cloud e non vede il mio Home Assistant

Allora hai fatto la domanda in un'attività che gira nel cloud (per esempio Cowork) e non in una chat normale. Quell'attività non vede il collegamento sul tuo PC, anche se home-assistant risulta in esecuzione in Impostazioni › Sviluppatore. Non ha niente a che fare con il tuo abbonamento.

Scegli l'icona della chat (verde) in alto in Claude Desktop, non l'icona </> (rossa).

Scegli l'icona della chat (verde) in alto in Claude Desktop, non l'icona del codice (rossa).

  • Scegli Chat in Claude Desktop e clicca Nuova chat (New chat).
  • Clicca + nella casella del messaggio e controlla che home-assistant sia attivo.
  • Chiedi di nuovo, per esempio "Riesci a vedere il mio Home Assistant?", e clicca Consenti quando Claude lo chiede.

Se funziona, la risposta mostra che Claude ha usato home-assistant. Se Claude dice ancora che funziona nel cloud, sei nel tipo di conversazione sbagliato.

Dov'è il file delle impostazioni di Claude Desktop? (Percorso 2)

Il programma RepairGuyDK trova il file da solo, quindi di solito non devi cercarlo. Se vuoi vederlo, apri Claude Desktop, vai su Impostazioni › Sviluppatore e clicca Modifica configurazione (Edit Config). Il file si chiama claude_desktop_config.json.

  • Versioni più recenti di Claude Desktop per Windows: C:\Users\TuoNome\AppData\Local\Claude-Data\claude_..., dove la cartella termina con un codice che cambia da PC a PC
  • Versioni precedenti e molte guide online: %APPDATA%\Claude
  • AppData è una cartella nascosta. Scrivi l'indirizzo direttamente nella barra degli indirizzi di Esplora file, oppure attiva gli elementi nascosti in Visualizza.

Il file appartiene al tuo utente Windows, non al tuo account Claude. Se passi da un account Claude all'altro sullo stesso utente Windows, tutti avranno lo stesso collegamento. Per tenerli separati, usa un utente Windows diverso.

È sicuro?

HA-MCP resta completamente chiuso finché non apri il tuo percorso al passo 4. L'indirizzo contiene una lunga chiave segreta creata da HA-MCP stesso. Con il Percorso 2 tutto funziona solo sulla tua rete. Con il Percorso 1 il collegamento è cifrato tramite Nabu Casa, e in più Claude deve accedere con il tuo utente di Home Assistant prima di ottenere l'accesso. Claude chiede il permesso prima di usare Home Assistant. Se hai condiviso l'indirizzo per errore, elimina HA-MCP Server in Dispositivi e servizi e aggiungilo di nuovo: così ne ottieni uno nuovo.

Posso usare ChatGPT al suo posto?

Forse, ma non è testato e richiede più lavoro che con Claude. ChatGPT può aggiungere un connettore personalizzato solo con Plus o superiore, non con il piano gratuito o Go. Devi anche attivare la Developer mode di ChatGPT nel browser. Funziona solo con il Percorso 1 (Nabu Casa), perché ChatGPT non può usare il programma RepairGuyDK del Percorso 2. Inoltre OpenAI limita ciò che ChatGPT può modificare tramite un connettore di questo tipo nei piani più economici. Questa guida è fatta e testata per Claude, che funziona già con l'account gratuito.

Basta Claude gratuito?

Per provare, sì. Claude gratuito funziona con Home Assistant, e con il Percorso 1 puoi aggiungere un connettore personalizzato. La versione gratuita ha un limite di utilizzo ogni 5 ore. Le attività di Home Assistant consumano molto, perché Claude legge i tuoi dispositivi, le automazioni e i log. "Spegni la luce del soggiorno" è un'attività piccola, mentre "crea una dashboard" può consumare quasi tutta la quota gratuita. Quando raggiungi il limite, Claude ti chiede di aspettare. Non è un errore.

Se vuoi usare Claude per creare automazioni e dashboard o per installare cose come Zigbee2MQTT, ti consigliamo Claude Pro, che offre almeno 5 volte più utilizzo. Vedi i prezzi attuali su claude.com/pricing.

Sono passato a Claude Pro. Devo cambiare qualcosa?

No. Se aggiorni lo stesso account Claude, tutto continua a funzionare subito. Con il Percorso 1 il collegamento è salvato nel tuo account Claude, e con il Percorso 2 è sul tuo PC. L'upgrade non cambia né l'uno né l'altro.

Se invece hai creato un nuovo account Claude per Pro, con il Percorso 1 devi aggiungere di nuovo il connettore come al passo 5. Il Percorso 2 continua a funzionare, perché è legato al tuo PC. Se vuoi, chiudi Claude Desktop completamente con File › Esci e riaprilo dopo l'upgrade.

Posso annullare tutto?

Sì. Elimina HA-MCP Server in Impostazioni › Dispositivi e servizi e rimuovi il connettore su claude.ai. Il programma RepairGuyDK salva un backup delle impostazioni di Claude prima di modificare qualsiasi cosa.

RepairGuyDK · Made in Spain With Danish Calmness