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.

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:
- Você ativa a integração do servidor MCP no Home Assistant.
- Você decide quais entidades o assistente pode ver, usando as configurações de exposição do Assist.
- Você cola a URL do servidor no ChatGPT como conector personalizado e escolhe OAuth como método de autenticação.
- 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 cliente | De onde vem a requisição | Precisa de acesso público? |
|---|
| App de desktop na sua rede doméstica | Seu próprio computador | Geralmente não |
| ChatGPT no site | Servidores da OpenAI | Sim |
| App no celular com dados móveis | Nuvem ou celular, fora da sua LAN | Sim |
| Script ou agente local | Mesma rede | Nã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.

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ê colou | Problema |
|---|
http://homeassistant.local:8123/api/mcp | Só local, e não HTTPS |
https://myhome.example.com | Falta 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/mcp | Forma 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.

Checklist de correção passo a passo
Siga esta ordem. Pare assim que algo começar a funcionar.
- 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.
- Confirme a exposição. Garanta que pelo menos uma entidade esteja exposta ao assistente.
- Confirme a URL externa. Configurações, Sistema, Rede. Use o mesmo endereço HTTPS que você pretende passar ao ChatGPT.
- Teste de fora. Dados móveis, sem VPN, carregue a página de login.
- Verifique os cabeçalhos do proxy. Se você usa qualquer proxy ou túnel, adicione-o a
trusted_proxies.
- Remova conectores antigos. Apague as tentativas com falha no ChatGPT antes de adicionar uma nova.
- Adicione o conector. Cole a URL completa de
/api/mcp e escolha OAuth.
- Teste com uma pergunta somente de leitura. Depois tente uma ação inofensiva, como uma única lâmpada.
- Leia os logs. Se algo ainda falhar, o log do Home Assistant e o log do seu proxy costumam apontar o verdadeiro culpado.

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.

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ção | Melhor opção | Esforço |
|---|
| Atrás de CGNAT da operadora ou internet compartilhada de prédio | Serviço de túnel | Baixo |
| Internet residencial com IP público real e alguma familiaridade com redes | DNS dinâmico e proxy reverso | Médio |
| Você quer o teste mais rápido | Funil de VPN em malha | Baixo |
| Você quer zero manutenção | Home 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.

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.

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?"

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.

Ainda travado? Tabela de diagnóstico rápido
| Sintoma | Causa mais provável | Tente isto |
|---|
| Carregamento infinito ao adicionar o conector | Servidor inacessível pela internet | Teste a URL com dados móveis |
| "Failed to resolve OAuth client" | Divergência de proxy, domínio ou URL externa | Alinhe a URL externa, adicione proxies confiáveis, adicione o conector de novo |
| Login funciona, nenhuma ferramenta listada | Nenhuma entidade exposta | Exponha algumas entidades nas configurações do assistente de voz |
| Ferramentas listadas, ações recusadas | Plano, modo ou chamadas de ferramentas bloqueadas | Tente um pedido somente de leitura, um chat novo, confira as configurações do conector |
| Funciona por um dia e depois para | IP alterado, túnel expirado ou segredo gerado de novo | Verifique o DNS dinâmico, o status do túnel e o log do add-on |
| Dispositivo errado acionado | Nomes de entidades vagos | Renomeie as entidades e atribua áreas |
| 404 na URL do conector | Caminho errado | Use o caminho /api/mcp |
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.