O que é HA-MCP?
O HA-MCP conecta assistentes de IA ao Home Assistant para que façam mais do que acender luzes: eles podem gerenciar e montar a configuração, como automações, pelo Model Context Protocol. A instalação recomendada é a integração HA-MCP, adicionada pelo HACS ou, a partir do Home Assistant 2026.11, pelo Marketplace embutido; depois ela roda o servidor inteiro dentro do Home Assistant em qualquer tipo de instalação.
A configuração pede um token de acesso de administrador e como os clientes podem se conectar: por uma URL de webhook para clientes remotos, via Nabu Casa ou proxy reverso, ou direto na rede local. É um projeto da comunidade, separado da integração MCP do próprio Home Assistant, com licença MIT e cerca de 7.900 estrelas no GitHub.
Como instalar HA-MCP
HACS or Home Assistant Marketplace: HA-MCP integrationHA-MCP vale a pena?
A integração MCP do próprio Home Assistant expõe os aparelhos a um assistente. O HA-MCP vai além: foi feito para configurar e automatizar o Home Assistant, então o Claude ou o ChatGPT podem criar automações e mudar a configuração, em vez de só apertar interruptores. Esse é o motivo para escolhê-lo, e também para ter cuidado.
A instalação ficou simples. A integração HA-MCP é instalada pelo HACS ou, desde o Home Assistant 2026.11, pelo Marketplace, e roda o servidor completo dentro do Home Assistant em instalações OS, Supervised, Container e Core igualmente. Ela substitui os antigos métodos por complemento, Docker e PyPI, e o projeto pede para rodar só um. Clientes remotos se conectam por uma URL de webhook via Nabu Casa ou o seu próprio proxy reverso; clientes locais podem se conectar direto.
O modelo de segurança exige reflexão. O servidor age como uma conta de administrador, e o README recomenda criar uma conta de administrador separada, só local, para o HA-MCP, em vez de usar o seu próprio token, porque tudo o que o assistente faz acontece com as permissões dessa conta. Abrir o webhook para a internet coloca um acesso de administração controlado por IA na frente da sua casa, então deixe o acesso remoto desligado se não precisar dele. Há mudanças incompatíveis, como a ida do ha_config_set_yaml para beta na v7.3.0, e só a versão estável atual do Home Assistant tem suporte oficial.
Onde ele se destaca
Um morador com 60 aparelhos e uma lista de automações bagunçada
Fazer o Claude arrumar e reescrever automações a partir de descrições simples
Instale o HA-MCP pelo Marketplace, crie para ele uma conta de administrador separada e só local, e conecte o Claude Desktop pela rede local; confira cada mudança no histórico do Home Assistant.
Um instalador de automação residencial
Configurar os sistemas dos clientes mais rápido
Use o HA-MCP na implantação com o acesso remoto desligado e remova ou restrinja antes de entregar o sistema.
Antes de decidir
- Configuração
- Instale a integração HA-MCP pelo HACS ou em Configurações → Marketplace (Home Assistant 2026.8 ou mais recente), reinicie, adicione a integração com um token de administrador e cole a URL no seu cliente de IA.
- Integrações
- Claude, ChatGPT e outros clientes MCP; Nabu Casa ou um proxy reverso para acesso remoto.
- Dados e privacidade
- Roda dentro do seu Home Assistant; as ações usam a conta de administrador que você der. O acesso remoto por webhook é opcional.
- Custo em escala
- Grátis; o Nabu Casa só é necessário pela URL remota.
- Limites
- Só a versão estável atual do Home Assistant tem suporte oficial; não rode junto de outra instalação do HA-MCP.
O que é bom
- Configura e automatiza, não só controla aparelhos
- Instala pelo HACS ou pelo Marketplace do Home Assistant
- Roda dentro do Home Assistant em todos os tipos de instalação
- Licença MIT
O que não é
- Age com permissões de administrador
- O webhook remoto expõe um acesso de administração se for ativado
- Só a versão estável atual do Home Assistant tem suporte
- Mudanças incompatíveis entre versões
Ideal para
Usuários do Home Assistant à vontade com tokens de administrador que querem um assistente criando e editando as automações deles.
Alternativas ao HA-MCP
HA-MCP: perguntas frequentes
- HA-MCP vale a pena?
- O HA-MCP dá a um assistente de IA controle real sobre a configuração do Home Assistant, tão útil quanto poderoso, porque age como administrador. Damos nota 4.0 de 5.
- Quanto custa HA-MCP?
- Grátis e de código aberto (MIT).
- Quais são as desvantagens de HA-MCP?
- Age com permissões de administrador; o webhook remoto expõe um acesso de administração se for ativado; só a versão estável atual do Home Assistant tem suporte; mudanças incompatíveis entre versões.
- Para quem HA-MCP é indicado?
- Usuários do Home Assistant à vontade com tokens de administrador que querem um assistente criando e editando as automações deles.
- Quanto custa HA-MCP para uma equipe ou em produção?
- Grátis; o Nabu Casa só é necessário pela URL remota.
- HA-MCP é seguro para dados da empresa?
- Roda dentro do seu Home Assistant; as ações usam a conta de administrador que você der. O acesso remoto por webhook é opcional.
- Quais são as melhores alternativas ao HA-MCP?
- As alternativas mais próximas que analisamos são Home Assistant MCP Server.
Respostas verificadas em 15 de nov. de 2026.