Postul meu de pe Facebook din ultimele zile a stârnit ceva valuri: am cuplat Claude AI direct la Home Assistant prin MCP (Model Context Protocol) și de atunci pot să discut cu casa în limbaj natural — îi cer audit pe entități, redenumiri, dashboards, automatizări — totul fără să mă bag manual prin meniuri sau YAML.
Mulți m-au întrebat cum se face. Mai jos e ghidul complet pe Windows, cu setup pas cu pas, primul test live (audit pe 1.753 de entități în mai puțin de 30 de secunde) și exemple concrete de cazuri unde merită folosit. Fără bullshit, fără cloud inutil, fără „magie”.
Ce e MCP, pe scurt #
Model Context Protocol e un protocol deschis (lansat de Anthropic la finalul lui 2024) prin care un model AI — Claude, în cazul nostru — poate apela direct unelte (tools) expuse de un server local. Nu e un alt cloud, nu e un agregator. E pur și simplu o cale prin care Claude Desktop poate să întrebe HA-ul tău: „dă-mi lista entităților”, „pornește scriptul X”, „arată-mi automatizările care eșuează” — și HA-ul răspunde în formă structurată.
Avantajul față de integrările clasice cu LLM (gen Assist + ChatGPT prin API) e că totul se întâmplă local, pe mașina ta, prin token-ul tău. Nu trimiți toată casa în cloud. Datele rămân între laptop și HA.
Ce-ți trebuie #
- Claude Desktop instalat pe Windows (sau Mac, dar aici scriu pentru Windows că pe asta lucrez)
- Home Assistant accesibil în rețea (eu l-am pe local IP, merge și prin Nabu Casa)
- Python 3.13 (sau pus prin
uvx, care îl gestionează singur — recomand) - uv — un package manager Python rapid (echivalent npm pentru Python). Site oficial: docs.astral.sh/uv
- Token long-lived de la HA (Profile → Security → Long-Lived Access Tokens → Create)
Pas 1 — Instalează uv pe Windows #
În PowerShell, comanda oficială e:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Atenție: antivirușii agresivi (Bitdefender, Avast etc.) pot să marcheze installer-ul ca Heur.BZC.ZFV.Boxter sau ceva similar. E fals pozitiv. Dacă nu vrei să dezactivezi protecția, descarcă manual MSI-ul de pe pagina de release-uri Astral pe GitHub și instalează-l de acolo. Eu așa am făcut.
După instalare, deschizi un nou terminal și verifici: uv --version.
Pas 2 — Generează token-ul HA #
În Home Assistant, click pe profilul tău (jos stânga) → tab Security → scroll jos până la Long-Lived Access Tokens → Create token. Îi dai un nume gen claude-mcp, copiezi imediat token-ul (nu mai e arătat după ce închizi dialogul) și îl pui într-un loc sigur.
Important: token-ul ăla are aceleași drepturi ca user-ul tău. Nu-l urca pe GitHub, nu-l da pe Discord, nu-l pune în screenshot-uri. Dacă a scăpat, îl revoci de pe aceeași pagină.
Pas 3 — Configurează Claude Desktop #
Fișierul de config Claude Desktop pe Windows e:
%APPDATA%\Claude\claude_desktop_config.jsonDacă nu există, îl creezi. Conținutul minim:
{
"mcpServers": {
"Home Assistant": {
"command": "uvx",
"args": ["--python", "3.13", "--refresh", "ha-mcp@latest"],
"env": {
"HA_URL": "http://192.168.1.50:8123",
"HA_TOKEN": "TOKEN_TAU_AICI"
}
}
}
}Înlocuiești HA_URL cu IP-ul tău local de HA (sau URL-ul Nabu Casa) și HA_TOKEN cu token-ul de la pasul 2. Salvezi, închizi complet Claude Desktop (din tray, nu doar fereastra) și-l redeschizi.
Greșeala clasică: dacă mai ai și alte secțiuni în config (preferences, theme etc.), nu pune mcpServers ca obiect separat la rădăcină. Tot JSON-ul trebuie să fie un singur obiect cu toate cheile înăuntru. Dacă apare obiect duplicat, parser-ul cade silent și MCP-ul pur și simplu nu se conectează.
Pas 4 — Verifică în Claude Desktop #
Mergi la Settings → Developer → Local MCP servers. Ar trebui să apară „Home Assistant” cu status running. Dacă apare error, click pe el și citește log-ul — de obicei e fie token greșit, fie HA_URL fără protocol (http://), fie un firewall care blochează portul 8123.
uvx cu ha-mcp@latest — refresh la fiecare pornire pentru ultima versiune.Primul test — „vezi entitățile mele?” #
Deschizi un chat nou cu Claude și-l întrebi simplu: „vezi entitățile din Home Assistant?”. Dacă MCP-ul e bine conectat, primești în câteva secunde un răspuns gen ăsta:
🎉 Conectat. HA-ul tău e fier acolo: HA 2026.4.4 la Showroom SmartHome360 — RUNNING; 1.753 entități în 36 domenii, 22 areas, 436 servicii, 42 automatizări (30 active); 4 repairs minore.
În spate, Claude a apelat tool-uri MCP gen list_entities, list_areas, list_automations și a tras concluziile. Dacă-i ceri Top areas după număr de entități, ți le dă tabel:
| Area | Entități |
|---|---|
| depozit | 103 |
| showroom_2 | 52 |
| outdoor_warehouse | 37 |
| vitrina | 34 |
| masa_studio | 30 |
Asta în 30 de secunde. Manual ți-ar fi luat o jumătate de oră să umbli prin Settings → Devices & Services → Areas.
Cazuri reale unde merită să-l folosești #
1. Audit + curățare entități fără să strici automatizările #
Cel mai mare avantaj. Eu aveam pe Kincony KC868-E16S vreo 32 de relee numite haotic — switch.1x01, switch.1x02 … și unul super sugestiv: switch.nu_mai_controleaza_nimic. I-am cerut lui Claude să facă audit, să-mi spună care relee sunt referite în automatizări și care sunt orfane, apoi să-mi propună o redenumire coerentă pe zone fizice. A scos lista, mi-a dat propunerea, eu am bifat și am zis „aplică”.
2. Refactor dashboard-uri #
Tot pe MCP am construit două dashboard-uri noi cyberpunky pentru showroom — Tablou PAL (climatizare, ventilație, iluminat) și Relee+ (toate releele grupate pe zone fizice cu acțiuni rapide la îndemână). I-am descris stilul vrut („dark, futuristic, mai puțin spațiu liber, glow ușor pe carduri”), i-am dat HACS-urile pe care le am instalate (Mushroom, Bubble Card, card-mod, mini-graph-card), iar Claude a scos YAML-ul direct.
3. Întrebări naturale despre starea casei #
„Care AC-uri sunt pornite acum?”. „Câte ore a stat pompa de căldură pe încălzire săptămâna trecută?”. „Care senzori de temperatură au valori mai mari decât setpoint-ul cu peste 2 grade?”. Sunt întrebări la care, fără MCP, ar trebui să-ți deschizi History + Statistics și să te uiți manual. Cu MCP, le pui într-o frază și primești răspuns numeric, cu sursa entităților.
4. Detectarea problemelor pe care nu le vezi #
Eu aveam câteva entități în dashboard care apăreau ca „Entity not found” pentru că le redenumisem din ESPHome. Le văzusem de luni de zile și uitasem să le scot. La un audit Claude mi-a zis direct: „ai 7 referințe orfane în Lumini Recepție” și mi le-a listat. 5 minute de rezolvat.
Limite și recomandări de bun-simț #
- Token-ul e cheia casei tale digitale. Cine îl are, are HA-ul tău complet. Nu-l reutiliza între mașini, generează unul per device. Dacă bănuiești o scurgere, revoci imediat din profilul HA.
- MCP-ul nu face automatizări singur — îți propune YAML-ul, tu îl pui în
automations.yamlsau prin UI. Bun lucru, sincer. Mai ales că Claude poate să greșească (deși rar pe ceva simplu). - Pentru comenzi distructive (ștersul de entități, schimbat scenarii live, restart la HA) — soluția curată e să creezi în HA un user secundar cu drepturi limitate (Administrator: No) și să generezi token-ul de la el. Atunci MCP-ul nu poate face acțiuni administrative chiar dacă-i ceri. Alternativ, oprești MCP-ul de tot din Settings → Developer cât timp lucrezi și nu vrei să-l lași să atingă nimic — nu există mod „read-only” nativ, ori e activ cu drepturile token-ului, ori e oprit complet.
- Costul — Claude Desktop pe planul Pro intră în limitele incluse. Pe Free poți să-l rulezi, dar dacă faci audit pe 1.500+ entități în fiecare zi, vei lovi limitele rapid.
- Nu e un substitut pentru documentare. Dacă HA-ul tău nu are areas setate, dispozitivele nu sunt botezate cum trebuie, automatizările sunt scrise prost — Claude îți va da răspunsuri dezordonate. Garbage in, garbage out. Începe cu igienă în HA, apoi pornește MCP-ul.
Ce urmează #
Următorii pași la mine în showroom: (1) automatizări legate de prezență cu detecția pe LiDAR, (2) integrare BYD ATTO3 prin MCP ca să-mi pot întreba mașina cât % am la baterie fără să deschid aplicația, (3) un dashboard separat pentru cursanții ANC unde vor putea exersa exerciții de configurare HA cu Claude ca tutor.
Dacă vrei să încerci tu și te blochezi la setup, scrie-mi pe pagina de Facebook a asociației. Sunt curios cum se descurcă HA-uri mai mici (zeci de entități) vs. cazuri mari ca al meu — feedback-ul e binevenit. Și dacă ai propus deja MCP la clienții tăi ca integrator, dă-mi un semn — mi-ar plăcea un studiu de caz comparativ pe wiki.
Răspunsuri