ChatGPT com Home Assistant MCP: correções para quando não funciona, acesso remoto e configuração gratuita

O ChatGPT se recusa a se conectar ao seu servidor MCP do Home Assistant, ou conecta mas nunca controla nada? Este artigo percorre as causas reais: falhas de OAuth, falta de acesso remoto, chamadas de ferramentas bloqueadas e URLs erradas. Também mostra como montar uma configuração gratuita de acesso remoto e manter tudo seguro.

ChatGPT com Home Assistant MCP: correções para quando não funciona, acesso remoto e configuração gratuita
Cristian Da Conceicao

Você digitou a URL do servidor MCP no ChatGPT, clicou em conectar e apareceu um carregamento que nunca termina. Ou pior: uma mensagem críptica sobre um cliente OAuth que não pôde ser resolvido. Se seu link ChatGPT Home Assistant MCP não está funcionando, você está em boa companhia. Este é o obstáculo mais comum de quem tenta falar com a casa inteligente por meio de um chatbot, e quase todos os casos se resumem a uma de cinco causas: o servidor não é acessível pela internet, a descoberta do OAuth falha atrás de um proxy, a URL está errada, a integração não expõe as entidades certas, ou as chamadas de ferramentas estão sendo bloqueadas do lado do ChatGPT.

Este artigo percorre cada causa na ordem em que você mais provavelmente vai encontrá-la e, em seguida, monta uma configuração gratuita de acesso remoto para que você não precise pagar nada só para uma janela de chat alcançar a sua sala de estar.

💡 Resposta rápida: o ChatGPT no site roda na nuvem. Serviços na nuvem não conseguem enxergar homeassistant.local. Sua instância precisa de um endereço HTTPS público, e esse endereço precisa passar pela descoberta OAuth sem erros. Resolva essas duas coisas e a maioria dos casos de "não funciona" desaparece.

Um usuário frustrado diante de um notebook, com uma mensagem de erro em vermelho e anotações manuscritas sobre a mesa

O que o MCP realmente faz aqui

MCP significa Model Context Protocol. Pense nele como um plugue padrão entre um assistente de IA e uma ferramenta. O Home Assistant traz uma integração de servidor MCP que expõe as entidades e serviços que você escolher, para que um cliente de IA possa ler estados ("a porta da garagem está aberta?") e executar ações ("apague a luz da cozinha").

O fluxo parece simples no papel:

  1. Você ativa a integração do servidor MCP no Home Assistant.
  2. Você decide quais entidades o assistente pode ver, usando as configurações de exposição do Assist.
  3. Você cola a URL do servidor no ChatGPT como conector personalizado e escolhe OAuth como método de autenticação.
  4. O ChatGPT descobre os endpoints do OAuth, leva você por um login e lista as ferramentas.

Cada uma dessas etapas pode falhar sem aviso. O restante deste artigo é um mapa de onde isso acontece.

O endpoint de que você precisa

A integração nativa serve o endpoint no caminho /api/mcp do endereço do seu Home Assistant. Tutoriais mais antigos da comunidade ainda citam o caminho /mcp_server/sse, que vem dos primeiros tempos do recurso. Se você está seguindo um tutorial com mais de alguns meses, verifique qual caminho ele usa antes de culpar sua rede.

Clientes locais versus clientes na nuvem

Um cliente de desktop que roda no seu próprio computador muitas vezes consegue alcançar sua instância pela rede local. O ChatGPT na web não consegue. Essa diferença explica um número surpreendente de discussões em fóruns em que "funcionou no meu notebook, mas não no navegador".

Tipo de clienteDe onde vem a requisiçãoPrecisa de acesso público?
App de desktop na sua rede domésticaSeu próprio computadorGeralmente não
ChatGPT no siteServidores da OpenAISim
App no celular com dados móveisNuvem ou celular, fora da sua LANSim
Script ou agente localMesma redeNão

Por que o ChatGPT não consegue se conectar

Vamos passar pelas falhas da mais comum para a menos comum.

Causa 1: não há endereço público

Se a URL do seu Home Assistant termina em .local, começa com 192.168 ou só funciona no seu Wi-Fi, o ChatGPT nunca vai alcançá-la. A documentação do Home Assistant é direta sobre isso: quando o agente de IA roda na nuvem, a instância precisa ser acessível pela internet, por exemplo pelo Home Assistant Cloud ou por outro método de acesso remoto.

Como testar: desligue o Wi-Fi do celular, abra sua URL externa em um navegador móvel e veja se a página de login carrega. Se não carregar, o problema não é o ChatGPT.

Um roteador branco com luzes de status verdes e um cabo ethernet azul sobre uma prateleira de madeira

Causa 2: a descoberta OAuth falha atrás de um proxy

Esta causa gera o famoso erro: "Failed to resolve OAuth client for MCP connector." Relatos da comunidade mostram que ele aparece em instâncias atrás de um domínio personalizado, de um túnel ou de um proxy reverso. O motivo mais comum é que os metadados que o Home Assistant devolve durante a descoberta não correspondem ao endereço que o ChatGPT usou para chegar até ele.

Gatilhos comuns:

  • A URL externa nas configurações do Home Assistant é diferente do endereço que você colou no ChatGPT.
  • Um proxy reverso reescreve o cabeçalho host, então o Home Assistant anuncia um endereço interno.
  • trusted_proxies e use_x_forwarded_for estão ausentes na configuração de http:, então a instância não confia nos cabeçalhos encaminhados.
  • Um redirecionamento de http para https, ou de um domínio simples para www, muda o emissor no meio do handshake.

💡 Ordem da correção: defina a URL externa como o endereço HTTPS público exato que você vai colar no ChatGPT, adicione seu proxy à lista de proxies confiáveis, reinicie e depois remova e adicione o conector de novo. Não tente apenas repetir o antigo. Um registro com falha em cache pode continuar falhando.

Causa 3: o conector é adicionado, mas as ferramentas nunca rodam

Alguns usuários concluem o login OAuth, veem as ferramentas listadas e, em seguida, todas as chamadas são recusadas. Há discussões na comunidade sobre chamadas de ferramentas bloqueadas do lado da OpenAI mesmo quando a conexão em si parece saudável. Se suas ferramentas aparecem, mas nada acontece:

  • Confira se você está em um plano e modo do ChatGPT que permitem conectores personalizados com ações de escrita. Os requisitos de plano para conectores MCP personalizados já mudaram mais de uma vez, então consulte a tela de configurações atual em vez de um artigo antigo.
  • Comece com um pedido somente de leitura, como "qual é a temperatura do corredor?", antes de pedir uma ação.
  • Abra um chat novo. Conectores ativados no meio de uma conversa às vezes não são anexados.

Causa 4: a forma errada da URL

Muita gente cola uma destas opções e se pergunta por que nada funciona:

O que você colouProblema
http://homeassistant.local:8123/api/mcpSó local, e não HTTPS
https://myhome.example.comFalta o caminho do MCP
https://myhome.example.com/api/mcp/A barra final pode quebrar a correspondência estrita em alguns proxies
https://myhome.example.com/api/mcpForma correta

Causa 5: nada está exposto

Mesmo uma conexão perfeita não serve de nada se nenhuma entidade estiver exposta. Abra as configurações dos assistentes de voz no Home Assistant e exponha as luzes, interruptores, dispositivos de clima e cenas que você quer que o assistente veja. Comece com cinco a dez entidades. Uma lista gigante deixa as respostas mais lentas e aumenta o risco de o modelo escolher o dispositivo errado.

Uma mulher de camisa jeans sorrindo para o celular em uma cozinha iluminada enquanto um pendente se acende

Checklist de correção passo a passo

Siga esta ordem. Pare assim que algo começar a funcionar.

  1. Confirme que a integração está ativa. No Home Assistant, adicione a integração Model Context Protocol Server e verifique se ela carrega sem erros.
  2. Confirme a exposição. Garanta que pelo menos uma entidade esteja exposta ao assistente.
  3. Confirme a URL externa. Configurações, Sistema, Rede. Use o mesmo endereço HTTPS que você pretende passar ao ChatGPT.
  4. Teste de fora. Dados móveis, sem VPN, carregue a página de login.
  5. Verifique os cabeçalhos do proxy. Se você usa qualquer proxy ou túnel, adicione-o a trusted_proxies.
  6. Remova conectores antigos. Apague as tentativas com falha no ChatGPT antes de adicionar uma nova.
  7. Adicione o conector. Cole a URL completa de /api/mcp e escolha OAuth.
  8. Teste com uma pergunta somente de leitura. Depois tente uma ação inofensiva, como uma única lâmpada.
  9. Leia os logs. Se algo ainda falhar, o log do Home Assistant e o log do seu proxy costumam apontar o verdadeiro culpado.

Um desenvolvedor em um escritório em casa lendo logs em dois monitores à luz do fim de tarde

Lendo os logs sem perder a noite

Logs são cheios de ruído. Um truque prático: copie as dez linhas em volta da tentativa de conexão que falhou, remova tokens e endereços pessoais e cole em um modelo de chat para uma explicação em linguagem simples. No PicassoIA você pode fazer isso com o GPT-4o, o Claude Sonnet 5 ou o Gemini 3.5 Flash. Para configurações de proxy mais longas, o GPT 5.6 Sol lida bem com tarefas com muito código. Sempre remova os segredos antes.

Acesso remoto sem pagar

Aqui está a parte que a maioria dos tutoriais deixa de lado. O caminho mais simples é o Home Assistant Cloud, da Nabu Casa. Ele cuida do endereço HTTPS público e dos certificados para você, e sua URL externa é detectada automaticamente. Também é uma assinatura paga, e ajuda a financiar o desenvolvimento do projeto, então é uma escolha justa se você quer o mínimo de esforço.

Mas você pediu uma configuração gratuita, então vamos ver o que de fato funciona com custo mensal zero.

Vista de cima de uma bancada de trabalho com um pequeno computador de placa única, um SSD, cabos e um caderno com um esboço de rede

Opção A: um serviço de túnel gratuito

Um túnel faz uma conexão de saída da sua casa para um provedor, que então encaminha o tráfego HTTPS público de volta para você. Você não abre nenhuma porta no roteador.

O que você precisa:

  • Um nome de domínio (o domínio é o único custo pequeno inevitável, muitas vezes alguns dólares por ano) ou um subdomínio gratuito de alguns provedores.
  • O add-on ou contêiner de túnel rodando ao lado do Home Assistant.
  • Seu proxy adicionado a trusted_proxies.

Prós: sem encaminhamento de portas, funciona atrás de CGNAT da operadora, os certificados são cuidados para você.

Contras: você depende de um terceiro, e alguns recursos de túnel mudam os termos do plano gratuito.

Opção B: DNS dinâmico mais encaminhamento de portas

A rota clássica. Um nome de DNS dinâmico gratuito aponta para o IP da sua casa, o roteador encaminha a porta 443 para um proxy reverso, e o proxy obtém um certificado gratuito da Let's Encrypt.

Prós: totalmente sob seu controle, sem taxas recorrentes.

Contras: precisa de um IP público (não ficar atrás de CGNAT da operadora), expõe uma porta e exige que você mantenha o proxy atualizado.

Opção C: um funil público por meio de uma VPN em malha

Algumas ferramentas de VPN em malha conseguem publicar um serviço na internet pública por HTTPS em um endereço gerado, enquanto o restante dos seus dispositivos continua privado. A configuração é curta, mas o endereço gerado é definido pelo provedor, então confira se a descoberta OAuth ainda passa com esse nome de host.

Qual opção gratuita serve para você

SituaçãoMelhor opçãoEsforço
Atrás de CGNAT da operadora ou internet compartilhada de prédioServiço de túnelBaixo
Internet residencial com IP público real e alguma familiaridade com redesDNS dinâmico e proxy reversoMédio
Você quer o teste mais rápidoFunil de VPN em malhaBaixo
Você quer zero manutençãoHome Assistant Cloud (pago)Mínimo

💡 Teste antes de se comprometer. Qualquer que seja sua escolha, confirme que a página https://your-address/api/mcp responde com dados móveis antes de mexer no ChatGPT. Isso economiza uma hora de tentativa e erro.

Um jovem em uma plataforma de trem ao entardecer olhando o celular

A rota do proxy de webhook

Alguns projetos da comunidade, como o add-on ha-mcp, seguem um caminho diferente da integração nativa. Eles rodam o próprio servidor MCP e o expõem por uma URL secreta ou por um proxy de webhook. Para usuários da Nabu Casa, o proxy gera um endereço no formato https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx.

Se você seguir por esse caminho, três detalhes importam:

  • Copie a URL completa do log do add-on. Um segredo digitado errado ou gerado de novo é uma causa comum de falha.
  • Trate a URL como uma senha. Quem tiver em mãos pode conseguir alcançar suas ferramentas.
  • Gere outra se ela vazar. Depois atualize o conector.

Esse caminho é útil se o fluxo OAuth nativo continuar falhando na sua configuração. A contrapartida é que você depende de um add-on de terceiros, então leia o que ele expõe antes de ativá-lo.

Mantenha tudo seguro

Dar a um chatbot da nuvem o poder de acionar interruptores exige algum cuidado. Algumas regras mantêm o risco pequeno.

Um cadeado de latão em um portão de jardim de madeira desgastada, com hera e luz da manhã

Exponha menos do que você imagina

Não exponha fechaduras de porta, portões de garagem, painéis de alarme ou qualquer coisa que abra sua casa para um estranho. Comece com luzes, clima e mídia. Adicione mais só quando confiar no comportamento.

Use um usuário dedicado

Crie um usuário separado no Home Assistant para o assistente, se sua configuração permitir, assim você pode revogar o acesso com um clique sem mexer no seu próprio login.

Acompanhe a atividade

Confira o registro de eventos depois das primeiras sessões. Você verá exatamente quais serviços o assistente chamou. Se algo surpreender você, reduza a lista de entidades expostas.

Mantenha o software atualizado

Tanto o Home Assistant quanto qualquer add-on de proxy ou túnel recebem correções de segurança. Um endereço público torna as atualizações mais importantes, não menos.

Nunca cole segredos em um chat

Tokens de acesso de longa duração, URLs de webhook e senhas não pertencem a prompts. Se você compartilhar a configuração para solucionar problemas, substitua esses dados por marcadores.

O que você pode fazer quando funcionar

Quando a conexão finalmente se sustentar, a diversão começa. Estes pedidos funcionam bem com um conjunto modesto de entidades expostas:

  • "Apague todas as luzes do andar de baixo, menos a do corredor."
  • "Ficou alguma coisa ligada na cozinha?"
  • "Ajuste o termostato do quarto para 19 graus e me diga a leitura atual."
  • "Ative a cena de filme."
  • "Quais janelas estão abertas agora?"

Uma mão pressionando um interruptor de parede branco simples, com um abajur quente aceso ao fundo

Escreva nomes de entidades melhores

O modelo escolhe os dispositivos pelo nome. "Luz 3" é um nome ruim. "Abajur de leitura da sala" é um bom. Gaste vinte minutos renomeando entidades e áreas, e a precisão melhora bastante. Atribua cada dispositivo a uma área para que uma frase como "apague as luzes do quarto" tenha com o que se relacionar.

Use scripts e cenas como atalhos

Em vez de fazer o assistente compor cinco ações separadas, agrupe-as em um script ou cena. "Boa noite" vira uma única chamada que reúne a lógica em que você confia: luzes apagadas, termostato mais baixo, mídia pausada. Menos chamadas significam menos chances de erro.

Peça o estado antes da ação

Um hábito que evita surpresas: pergunte o que está ligado antes de pedir para desligar coisas. Isso confirma que a conexão está ativa e que os nomes das entidades batem com o que você espera.

Um casal relaxando em um sofá à noite, com um notebook, um abajur aceso e um gato sobre uma manta

Ainda travado? Tabela de diagnóstico rápido

SintomaCausa mais provávelTente isto
Carregamento infinito ao adicionar o conectorServidor inacessível pela internetTeste a URL com dados móveis
"Failed to resolve OAuth client"Divergência de proxy, domínio ou URL externaAlinhe a URL externa, adicione proxies confiáveis, adicione o conector de novo
Login funciona, nenhuma ferramenta listadaNenhuma entidade expostaExponha algumas entidades nas configurações do assistente de voz
Ferramentas listadas, ações recusadasPlano, modo ou chamadas de ferramentas bloqueadasTente um pedido somente de leitura, um chat novo, confira as configurações do conector
Funciona por um dia e depois paraIP alterado, túnel expirado ou segredo gerado de novoVerifique o DNS dinâmico, o status do túnel e o log do add-on
Dispositivo errado acionadoNomes de entidades vagosRenomeie as entidades e atribua áreas
404 na URL do conectorCaminho erradoUse o caminho /api/mcp

Com qual assistente combiná-lo

O ChatGPT não é o único assistente que consegue conversar com um servidor MCP. Se você quer uma segunda opinião ou uma reserva quando um serviço fica fora do ar, vale manter outros modelos de chat por perto para ajuda com configurações, escrita de YAML e leitura de logs. No PicassoIA você pode comparar o Claude Fable 5 para tarefas de programação, o Gemini 3.1 Pro para respostas gerais, o DeepSeek V3.1 para raciocínio de custo baixo e o GPT 5.6 Luna para respostas rápidas. Eles são úteis para rascunhar automações, transformar uma ideia bruta em um script limpo ou traduzir um log confuso para linguagem simples. Aqui eles não se conectam sozinhos ao seu Home Assistant, mas deixam a parte de solução de problemas bem mais rápida.

💡 Prompt que funciona bem para ajuda com configuração: "Aqui está a minha seção http: do Home Assistant e o erro do conector. Explique o que está desalinhado e mostre uma versão corrigida. Use marcadores para qualquer endereço ou token."

Experimente você mesmo no Picasso IA

Fazer um chatbot controlar sua casa é um projeto gratificante, e a mesma curiosidade rende em outros lugares. Se você gosta da parte de solução de problemas, abra os modelos de linguagem do Picasso IA e experimente colar um log, rascunhar uma automação ou pedir uma explicação clara de uma configuração de proxy. Depois vá além: gere imagens, vídeos curtos, narrações ou músicas com as outras ferramentas da plataforma. Escolha um modelo, escreva um prompt e veja o que volta. Seu próximo experimento está a um prompt de distância.

Compartilhe este artigo

Escolha seu idioma

FreeCrie imagens e vídeos com IAGrátis, sem cartão de créditoGerações grátis para começarSeedance 2.5 Lite incluídoComece grátis agora