Collegare Home Assistant MCP a Claude

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca Connectors → Home Assistant, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

Home Assistant + Claude

Lascia che la tua AI legga il tuo Home Assistant: lo stato attuale di ogni sensore, luce, porta e termostato, la cronologia registrata, il registro di cosa è successo e quando, e i tuoi calendari. Sola lettura: non controlla mai i dispositivi. Funziona con Home Assistant self-hosted.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Passaggio 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un'istanza di Home Assistant raggiungibile da AnythingMCP e un token di accesso di lunga durata, idealmente di un utente dedicato senza privilegi di amministratore.

1. Imposta HOME_ASSISTANT_URL sull'indirizzo con cui apri Home Assistant, senza slash finale e senza /api, per esempio https://home.example.com o http://192.168.1.10:8123 (la porta predefinita è 8123).
2. Consigliato: crea un utente Home Assistant dedicato per AnythingMCP in Impostazioni → Persone → Utenti → Aggiungi utente, con Amministratore disattivato. Nessuno degli endpoint usati dal connettore richiede diritti di amministratore.
3. Accedi come quell'utente e clicca sul tuo nome in basso a sinistra per aprire il profilo. Apri la scheda Sicurezza e, sotto Token di accesso di lunga durata, clicca Crea token. Copia il token (viene mostrato una sola volta e resta valido per 10 anni) e incollalo in HOME_ASSISTANT_TOKEN, senza la parola Bearer.
4. Installa il connettore ed esegui home_assistant_get_config: restituisce la versione, il nome della posizione e il fuso orario, e conferma che indirizzo e token funzionano.

Cosa legge: lo stato attuale di ogni entità (sensori, luci, clima, porte, presenza) con i suoi attributi, la cronologia registrata dei valori in un periodo, il registro di cosa è successo e quando (per esempio quando si è aperta l'ultima volta la porta del garage), i tuoi calendari e i relativi eventi, e la configurazione dell'istanza. Gli id delle entità hanno la forma sensor.living_room_temperature o binary_sensor.garage_door.

Sola lettura: ogni tool è una richiesta GET. Il connettore non può chiamare azioni (servizi), accendere o spegnere nulla, sbloccare porte, eseguire script o modificare stati. L'endpoint delle azioni di Home Assistant non è riservato agli amministratori, quindi questa garanzia deriva dal fatto che il connettore espone solo letture, non dal token.

Dove gira Home Assistant: su un AnythingMCP self-hosted, un'istanza in una rete privata (http://192.168.x.x:8123, homeassistant.local) richiede che un amministratore consenta l'host in SSRF_ALLOWED_HOSTS o nella allowlist delle impostazioni di amministrazione. AnythingMCP Cloud può raggiungere solo un'istanza esposta su internet pubblico tramite HTTPS, per esempio dietro un reverse proxy o con l'accesso remoto di Home Assistant Cloud.

Privacy: i dati della casa mostrano chi è presente e le abitudini quotidiane della famiglia. Assegna il connettore solo a server MCP i cui utenti possono vedere questi dati.

Orari: i timestamp vanno indicati in formato ISO 8601 in UTC con suffisso Z, per esempio 2026-10-01T00:00:00Z. home_assistant_get_config restituisce il fuso orario della casa per presentare i risultati.

Errori comuni: 401 significa che il token è sbagliato o è stato eliminato. 404 su una singola entità o sui suoi eventi del calendario significa che nessuna entità ha quell'id; 404 su ogni chiamata significa che HOME_ASSISTANT_URL è sbagliato o termina già con /api. 400 sugli eventi del calendario significa che start o end manca o non è un timestamp valido. Una connessione rifiutata o bloccata significa che l'host non è consentito nella allowlist SSRF (self-hosted) o non è pubblico via HTTPS (Cloud).

Il connettore non chiama azioni o servizi, non scrive né elimina stati, non genera eventi, non renderizza template, non mostra immagini delle telecamere e non legge il flusso di eventi, il log degli errori né l'API WebSocket (aree, dispositivi, registro delle entità).

Passaggio 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Passaggio 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP, apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

Percorso consigliato — funziona su claude.ai web senza modificare alcun file di configurazione.

1. In Claude, apri Customize → Connectors.
2. Clicca +, poi Add custom connector.
3. Inserisci un nome, ad esempio Home Assistant, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool qui sotto compaiono nella tua chat — inizia a scrivere i prompt.

Tool disponibili

FAQ

Funziona con Claude Code oltre che con Claude Desktop? Sì — punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Pagina del connettore
• Collega a ChatGPT