home-assistant-vibecode-agent MCP — Instalar & Demo ao vivo

Por que usar

Principais recursos

Criação e depuração de automação de linguagem natural
Design do painel Lovelace e personalização do tema via IA
Backups automáticos baseados em Git com mensagens de commit e reversão significativas
Integração HACS para instalação de mais de 1.000 componentes da comunidade
Acesso completo à API REST HA e WebSocket com validação de configuração

Demo ao vivo

Como fica na prática

home-assistant-vibecode-agent-2.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "home-assistant-vibecode-agent-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "home-assistant-vibecode-agent-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add home-assistant-vibecode-agent-2 -- TODO 'See README: https://github.com/Coolver/home-assistant-vibecode-agent'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: home-assistant-vibecode-agent

Como criar uma automação Home Assistant com linguagem natural

👤 Entusiastas de casas inteligentes que preferem descrever o que desejam em vez de escrever YAML ⏱ ~10 min beginner

Quando usar: Você deseja automatizar algo em sua casa, mas não quer escrever YAML manualmente.

Pré-requisitos

Home Assistant com o complemento instalado — Adicione o repositório https://github.com/coolver/home-assistant-vibecode-agent e instale
Cliente MCP configurado — Configure o Claude Code ou Cursor para conectar-se ao endpoint MCP do complemento

Fluxo

Descreva sua automação

Crie uma automação: quando eu chegar em casa (o GPS do telefone entra na zona inicial), acenda as luzes da sala, ajuste-as para 70% de brilho e comece a tocar minha playlist do Spotify no alto-falante da cozinha.✓ Copiado

→ Automação YAML gerada e validada
Implantar e testar

Implante essa automação e acione uma execução de teste.✓ Copiado

→ Automação implantada com backup criado e resultados de teste

Resultado: Uma automação funcional do Home Assistant criada a partir de uma descrição simples em inglês.

Armadilhas

Os nomes das entidades não correspondem ao que você descreveu — Peça ao agente para listar as entidades disponíveis primeiro para que você possa referenciar os nomes corretos

Projete um painel Lovelace personalizado com IA

👤 Usuários do Home Assistant que desejam painéis melhores sem aprender Lovelace YAML ⏱ ~20 min intermediate

Quando usar: Você quer um painel bonito e funcional, mas acha o editor manual limitante.

Pré-requisitos

Agente Vibecode em execução e conectado — Instale o complemento e configure o cliente MCP

Fluxo

Descreva o painel

Projete um painel para meu quarto: mostre a temperatura/umidade do sensor, controles de luz com controles deslizantes de brilho, um cartão de reprodutor de mídia para o Sonos e um gráfico de temperatura nas últimas 24 horas.✓ Copiado

→ Lovelace YAML gerado com todos os cartões solicitados
Iterar no design

Mova o media player para o topo e adicione um tema escuro que combine com as cores do meu quarto.✓ Copiado

→ Painel atualizado com cartões reordenados e tema personalizado

Resultado: Um painel Lovelace sofisticado implantado no Home Assistant.

Armadilhas

Cartões personalizados requerem instalação do HACS — Peça ao agente para instalar os componentes HACS necessários antes de adicionar cartões personalizados

Combinações

Combine com outros MCPs para 10× de alavancagem

home-assistant-vibecode-agent-2 + filesystem

Exporte e faça backup das configurações do Home Assistant para arquivos locais

Exporte todas as minhas automações e configurações do painel para ~/ha-backup/ para controle de versão.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
create_automation	description or YAML	Crie ou modifique automações do Home Assistant
update_dashboard	dashboard config	Crie ou atualize painéis Lovelace
list_entities	domain?: str	Listar entidades de Home Assistant disponíveis
call_service	domain: str, service: str, data?: obj	Ligue para um serviço Home Assistant (acenda as luzes, reproduza mídia, etc.)
install_hacs	component: str	Instale um componente da comunidade HACS

Custo e limites

O que custa rodar

Cota de API: N/A – comunica-se com a instância local do Home Assistant
Tokens por chamada: 200–1000 tokens por operação
Monetário: Gratuito – complemento de código aberto
Dica: Liste as entidades primeiro para reduzir tentativas e erros ao criar automações.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Home Assistant long-lived access token

Armazenamento de credenciais: Token de acesso HA configurado nas configurações do complemento

Saída de dados: Comunica-se apenas com sua instância local do Home Assistant. Downloads do HACS no GitHub.

Este complemento tem acesso total à API do Home Assistant. Ele pode controlar todos os dispositivos, modificar configurações e instalar componentes.
Sempre verifique o YAML de automação antes de implantar – automações ruins podem acionar dispositivos inesperadamente.
O backup do Git fornece reversão, mas teste primeiro as alterações em dispositivos não críticos.

Solução de problemas

Erros comuns e correções

Add-on can't connect to Home Assistant

Verifique se o token de acesso de longa duração está correto e não expirou. Verifique os logs do complemento em busca de erros de conexão.

Verificar: Check Home Assistant → Settings → Add-ons for the agent's status

Automation validation fails

O YAML gerado pode fazer referência a entidades que não existem. Liste as entidades primeiro para verificar os nomes.

Verificar: list_entities to see all available entity IDs

HACS component not installing

Certifique-se de que o próprio HACS esteja instalado primeiro no Home Assistant. Verifique se o nome do componente está correto.

Verificar: Verify HACS is accessible from Home Assistant sidebar

Alternativas

home-assistant-vibecode-agent vs. outros

Alternativa	Quando usar	Troca
Home Assistant REST API directly	Você deseja acesso direto à API sem a camada MCP	Mais controle, mas sem geração ou validação de YAML assistida por IA

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills