--- title: Claude AI + Home Assistant prin MCP — setup pentru Windows și demo live description: "Cum cuplezi Claude AI direct la Home Assistant prin Model Context Protocol — setup pas cu pas pe Windows (uv, ha-mcp, token long-lived), primul test cu audit pe 1.753 de entități, refactor dashboard-uri și cazuri reale de folosire. Fără cloud inutil, totul local." url: "https://asociatiasmarthome.ro/wiki/claude-ai-home-assistant-mcp-setup-windows/" updated: "2026-05-09" category: "🤖 AI & Automatizare" --- # Claude AI + Home Assistant prin MCP — setup pentru Windows și demo live 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](https://asociatiasmarthome.ro/dictionar/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](https://asociatiasmarthome.ro/dictionar/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](https://asociatiasmarthome.ro/dictionar/protocol/)** e un [Protocol](https://asociatiasmarthome.ro/dictionar/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](https://asociatiasmarthome.ro/dictionar/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](https://asociatiasmarthome.ro/dictionar/home-assistant/)-ul tău: „dă-mi lista entităților", „pornește scriptul X", „arată-mi automatizările care eșuează" — și [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/)-ul răspunde în formă structurată. Avantajul față de integrările clasice cu LLM (gen Assist + ChatGPT prin [API](https://asociatiasmarthome.ro/dictionar/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](https://asociatiasmarthome.ro/dictionar/home-assistant/). ## Ce-ți trebuie - **Claude Desktop** instalat pe Windows (sau [MAC](https://asociatiasmarthome.ro/dictionar/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](https://docs.astral.sh/uv/) - **Token long-lived** de la [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/) (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](https://asociatiasmarthome.ro/dictionar/home-assistant/) Î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%Claudeclaude_desktop_config.json ``` Dacă 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](https://asociatiasmarthome.ro/dictionar/home-assistant/) (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](https://asociatiasmarthome.ro/dictionar/protocol/) (`http://`), fie un firewall care blochează portul 8123. ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-08-164352.png) Claude Desktop → Settings → Developer. MCP-ul [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/) rulează prin `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](https://asociatiasmarthome.ro/dictionar/home-assistant/)-ul tău e fier acolo: [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/) **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. ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-08-164539-678x800.png) Primul ping. Claude îți spune și ce versiune ai, câte automatizări sunt active, câte sunt în repair. Mai bun decât orice raport scris de tine la 11 noaptea. ## 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](https://asociatiasmarthome.ro/dictionar/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ă". ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-07-192658-1300x743.png) Înainte. 16 relee per controller, numite generic, fără idee ce controlează fiecare. La 3 controllere active, devine imposibil să le ții minte. ### 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](https://github.com/piitaya/lovelace-mushroom), [Bubble Card](https://github.com/Clooos/Bubble-Card), [card-mod](https://github.com/thomasloven/lovelace-card-mod), [mini-graph-card](https://github.com/kalkih/mini-graph-card)), iar Claude a scos [YAML](https://asociatiasmarthome.ro/dictionar/yaml/)-ul direct. ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-07-195141-1-1300x653.png) Tablou PAL. Termostat 25.2°C, interior 24.88°C, exterior 19.88°C cu mini-graph live. Ventilație, iluminat, încălzire baie + showroom, electrovană apă — toate într-un view. ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-07-201436-1-1300x675.png) Relee+. „APRINDE / STINGE / STINGE TOT" sus, chip cu „28/48 active" în timp real, apoi grupare fizică: recepție, prezentatoare, masă discuții, bucătărie+baie, tablou PAL, centrală+AC+garaj, depozit. Mai util decât lista alfabetică. ### 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](https://asociatiasmarthome.ro/dictionar/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. ![](https://asociatiasmarthome.ro/wp-content/uploads/Screenshot-2026-05-07-201949-1300x579.png) Vedere generală. Climă & Aer: AC Showroom 21°C, Temperatură 25.2°C, Umiditate 47%, CO₂ 639 ppm, Iluminare 149 lx, Zgomot 45 dBA, PM 2.5 12 µg/m³. Ce nu vezi pe față e că în spate sunt 1.753 de entități curățate — efort care a luat o seară cu MCP. ## Limite și recomandări de bun-simț - **Token-ul e cheia casei tale digitale.** Cine îl are, are [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/)-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](https://asociatiasmarthome.ro/dictionar/home-assistant/). - **MCP-ul nu face automatizări singur** — îți propune [YAML](https://asociatiasmarthome.ro/dictionar/yaml/)-ul, tu îl pui în `automations.YAML` sau 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](https://asociatiasmarthome.ro/dictionar/home-assistant/)) — soluția curată e să creezi în [HA](https://asociatiasmarthome.ro/dictionar/home-assistant/) 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](https://asociatiasmarthome.ro/dictionar/home-assistant/)-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](https://asociatiasmarthome.ro/dictionar/home-assistant/), 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](https://asociatiasmarthome.ro/dictionar/home-assistant/) 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](https://asociatiasmarthome.ro/dictionar/home-assistant/)-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.