Collegare Home Assistant MCP a ChatGPT

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

Home Assistant + ChatGPT

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 complete di configurazione 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

Passo 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 a lungo termine, idealmente di un utente dedicato senza privilegi di amministratore.

1. Imposta HOME_ASSISTANT_URL sull'indirizzo con cui apri Home Assistant, senza barra finale e senza /api, ad esempio https://home.example.com oppure http://192.168.1.10:8123 (la porta predefinita è 8123).
2. Consigliato: crea un utente Home Assistant dedicato per AnythingMCP da Impostazioni → Persone → Utenti → Aggiungi utente, con Amministratore disattivato. Nessuno degli endpoint usati dal connettore richiede diritti di amministratore.
3. Accedi con quell'utente e clicca sul tuo nome in basso a sinistra per aprire il tuo profilo. Apri la scheda Sicurezza e, sotto Token di accesso a lungo termine, clicca su 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 relativi attributi, la cronologia registrata dei valori in un periodo, il registro di cosa è successo e quando (ad esempio quando si è aperta l'ultima volta la porta del garage), i tuoi calendari e i loro eventi, e la configurazione dell'istanza. Gli id delle entità hanno un aspetto come sensor.living_room_temperature o binary_sensor.garage_door.

Sola lettura: ogni tool è una richiesta GET. Il connettore non può richiamare 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: con AnythingMCP self-hosted, un'istanza su una rete privata (http://192.168.x.x:8123, homeassistant.local) richiede che un amministratore autorizzi l'host in SSRF_ALLOWED_HOSTS o nella allowlist nelle impostazioni di amministrazione. AnythingMCP Cloud può raggiungere solo un'istanza esposta su Internet pubblico tramite HTTPS, ad 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, ad 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 è errato 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 è errato 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 è autorizzato nella allowlist SSRF (self-hosted) o non è pubblico via HTTPS (Cloud).

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

Passo 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

Passo 3 — Aggiungi il connettore in ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin nella pagina Plugins, sul web e con i piani a pagamento. La modalità sviluppatore non è più necessaria. In un workspace Business solo amministratori e proprietari possono aggiungerne uno; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca su Add, poi su Add custom MCP server.
2. Inserisci un nome, ad es. Name: Home Assistant.
3. Sotto Connection, inserisci il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT te lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Strumenti disponibili

FAQ

Il piano gratuito di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Passi successivi

• Pagina del connettore
• Collegare a Claude