ChatGPT y Home Assistant MCP: soluciones cuando no funciona, acceso remoto y configuración gratuita

¿ChatGPT se niega a conectarse a tu servidor MCP de Home Assistant o se conecta pero nunca controla nada? Este artículo repasa las causas reales: fallos de OAuth, falta de acceso remoto, llamadas a herramientas bloqueadas y URL incorrectas. También muestra cómo montar una configuración gratuita de acceso remoto y mantenerlo todo seguro.

ChatGPT y Home Assistant MCP: soluciones cuando no funciona, acceso remoto y configuración gratuita
Cristian Da Conceicao

Escribiste la URL del servidor MCP en ChatGPT, pulsaste conectar y apareció un indicador de carga que nunca termina. O peor: un mensaje críptico sobre un cliente OAuth que no se pudo resolver. Si tu conexión con ChatGPT Home Assistant MCP no funciona, estás en buena compañía. Es el obstáculo más común de quienes intentan hablar con su casa inteligente a través de un chatbot, y casi todos los casos se deben a una de cinco causas: el servidor no es accesible desde internet, el descubrimiento de OAuth falla detrás de un proxy, la URL es incorrecta, la integración no expone las entidades adecuadas o las llamadas a herramientas se bloquean en el lado de ChatGPT.

Este artículo repasa cada causa en el orden en que es más probable que te encuentres con ella y después monta una configuración gratuita de acceso remoto, para que no tengas que pagar nada solo para que una ventana de chat llegue a tu sala de estar.

💡 Respuesta rápida: ChatGPT en la web funciona en la nube. Los servicios en la nube no pueden ver homeassistant.local. Tu instancia necesita una dirección HTTPS pública, y esa dirección debe superar el descubrimiento de OAuth sin errores. Si solucionas esas dos cosas, la mayoría de los casos de "no funciona" desaparecen.

Un usuario frustrado con un equipo portátil, un mensaje de error en rojo y notas escritas a mano sobre una mesa

Qué hace realmente MCP aquí

MCP significa Model Context Protocol. Piensa en ello como un enchufe estándar entre un asistente de IA y una herramienta. Home Assistant incluye una integración de servidor MCP que expone las entidades y servicios que elijas, para que un cliente de IA pueda leer estados ("¿está abierta la puerta del garaje?") y ejecutar acciones ("apaga la luz de la cocina").

El flujo parece sencillo sobre el papel:

  1. Activas la integración del servidor MCP en Home Assistant.
  2. Decides qué entidades puede ver el asistente, usando la configuración de exposición de Assist.
  3. Pegas la URL del servidor en ChatGPT como conector personalizado y eliges OAuth como método de autenticación.
  4. ChatGPT descubre los endpoints de OAuth, te lleva a un inicio de sesión y muestra las herramientas disponibles.

Cualquiera de esos pasos puede fallar en silencio. El resto de este artículo es un mapa de dónde.

El endpoint que necesitas

La integración incorporada sirve su endpoint en la ruta /api/mcp de la dirección de tu Home Assistant. Los tutoriales comunitarios más antiguos todavía mencionan una ruta /mcp_server/sse, que viene de los primeros tiempos de la función. Si sigues un tutorial de hace más de unos pocos meses, revisa qué ruta usa antes de culpar a tu red.

Clientes locales frente a clientes en la nube

Un cliente de escritorio que se ejecuta en tu propio equipo puede a menudo conectarse a tu instancia a través de la red local. ChatGPT en la web no puede. Esta diferencia explica un buen número de hilos de foros en los que "funcionaba en mi equipo portátil pero no en el navegador".

Tipo de clienteDe dónde sale la solicitud¿Necesita acceso público?
App de escritorio en tu red domésticaTu propio equipoNormalmente no
ChatGPT en la webServidores de OpenAISí
App móvil con datos móvilesNube o teléfono, fuera de tu LANSí
Script o agente localMisma redNo

Por qué ChatGPT no puede conectarse

Repasemos los fallos de más a menos común.

Causa 1: no hay dirección pública

Si la URL de tu Home Assistant termina en .local, empieza por 192.168 o solo funciona en tu Wi-Fi, ChatGPT nunca llegará a ella. La documentación de Home Assistant lo deja claro: cuando el agente de IA se ejecuta en la nube, la instancia debe ser accesible desde internet, por ejemplo mediante Home Assistant Cloud u otro método de acceso remoto.

Cómo comprobarlo: desactiva el Wi-Fi de tu teléfono, abre tu URL externa en el navegador móvil y mira si carga la página de inicio de sesión. Si no carga, el problema no es ChatGPT.

Un router blanco con luces de estado verdes y un cable ethernet azul sobre una estantería de madera

Causa 2: el descubrimiento de OAuth falla detrás de un proxy

Esto provoca el famoso error: "Failed to resolve OAuth client for MCP connector." Los informes de la comunidad lo muestran en instancias detrás de un dominio personalizado, un túnel o un proxy inverso. El motivo habitual es que los metadatos que Home Assistant devuelve durante el descubrimiento no coinciden con la dirección que ChatGPT usó para llegar a ella.

Causas frecuentes:

  • La URL externa de los ajustes de Home Assistant es distinta de la dirección que pegaste en ChatGPT.
  • Un proxy inverso reescribe la cabecera host, de modo que Home Assistant anuncia una dirección interna.
  • trusted_proxies y use_x_forwarded_for faltan en la configuración de http:, así que la instancia no confía en las cabeceras reenviadas.
  • Una redirección de http a https, o de un dominio sin ruta a www, cambia el emisor a mitad del handshake.

💡 Orden de la solución: establece la URL externa como la dirección HTTPS pública exacta que vas a pegar en ChatGPT, añade tu proxy a la lista de proxies de confianza, reinicia y luego elimina y vuelve a añadir el conector. No reintentes simplemente el anterior. Un registro fallido en caché puede seguir fallando.

Causa 3: el conector se añade, pero las herramientas nunca se ejecutan

Algunos usuarios completan el inicio de sesión de OAuth, ven las herramientas listadas y después cada llamada se rechaza. Hay hilos en la comunidad sobre llamadas a herramientas bloqueadas en el lado de OpenAI, incluso cuando la conexión en sí parece correcta. Si tus herramientas aparecen pero no pasa nada:

  • Comprueba que tienes un plan y un modo de ChatGPT que permitan conectores personalizados con acciones de escritura. Los requisitos de los planes para conectores MCP personalizados han cambiado más de una vez, así que revisa la pantalla de ajustes actual y no un artículo antiguo.
  • Empieza con una solicitud de solo lectura, como "¿cuál es la temperatura del pasillo?", antes de pedir una acción.
  • Abre un chat nuevo. Los conectores activados a mitad de una conversación a veces no se adjuntan.

Causa 4: la forma incorrecta de la URL

La gente pega una de estas y se pregunta por qué no funciona nada:

Lo que pegasteProblema
http://homeassistant.local:8123/api/mcpSolo local, y no es HTTPS
https://myhome.example.comFalta la ruta MCP
https://myhome.example.com/api/mcp/La barra final puede romper la coincidencia estricta en algunos proxies
https://myhome.example.com/api/mcpForma correcta

Causa 5: no hay nada expuesto

Incluso una conexión perfecta no sirve de nada si no hay entidades expuestas. Abre los ajustes de asistentes de voz en Home Assistant y expón las luces, interruptores, dispositivos de clima y escenas que quieras que vea el asistente. Empieza con cinco a diez entidades. Una lista enorme ralentiza las respuestas y aumenta el riesgo de que el modelo elija el dispositivo equivocado.

Una mujer con camisa vaquera sonríe mirando su teléfono en una cocina luminosa mientras se enciende una lámpara colgante

Lista de comprobación paso a paso

Sigue estos pasos en orden. Detente en cuanto algo empiece a funcionar.

  1. Confirma que la integración está activada. En Home Assistant, añade la integración Model Context Protocol Server y comprueba que se carga sin errores.
  2. Confirma la exposición. Asegúrate de que al menos una entidad está expuesta al asistente.
  3. Confirma la URL externa. Ajustes, Sistema, Red. Usa la misma dirección HTTPS que piensas dar a ChatGPT.
  4. Prueba desde fuera. Datos móviles, sin VPN, carga la página de inicio de sesión.
  5. Revisa las cabeceras del proxy. Si usas algún proxy o túnel, añádelo a trusted_proxies.
  6. Elimina los conectores antiguos. Borra los intentos fallidos en ChatGPT antes de añadir uno nuevo.
  7. Añade el conector. Pega la URL completa de /api/mcp y elige OAuth.
  8. Prueba con una pregunta de solo lectura. Después intenta una acción inofensiva, como una sola lámpara.
  9. Lee los registros. Si algo sigue fallando, el registro de Home Assistant y el de tu proxy suelen indicar el verdadero culpable.

Un desarrollador en un despacho en casa leyendo registros en dos monitores con luz de atardecer

Leer los registros sin perder una tarde

Los registros hacen mucho ruido. Un truco práctico: copia las diez líneas alrededor del intento de conexión fallido, elimina cualquier token o dirección personal y pégalas en un modelo de chat para que te expliquen el problema en lenguaje sencillo. En PicassoIA puedes hacerlo con GPT-4o, Claude Sonnet 5 o Gemini 3.5 Flash. Para configuraciones de proxy más largas, GPT 5.6 Sol maneja bien las tareas con mucho código. Elimina siempre los secretos antes.

Acceso remoto sin pagar

Esta es la parte que la mayoría de los tutoriales pasan por alto. La vía más limpia es Home Assistant Cloud de Nabu Casa. Se encarga de la dirección HTTPS pública y de los certificados, y tu URL externa se detecta automáticamente. También es una suscripción de pago, y ayuda a financiar el desarrollo del proyecto, así que es una opción razonable si quieres el mínimo esfuerzo.

Pero preguntaste por una configuración gratuita, así que veamos qué funciona de verdad sin ningún costo mensual.

Vista cenital de una mesa de trabajo con una placa de un solo circuito, un SSD, cables y un cuaderno con un boceto de red

Opción A: un servicio de túnel gratuito

Un túnel crea una conexión saliente desde tu casa hacia un proveedor, que luego reenvía el tráfico HTTPS público hasta ti. No abres ningún puerto en el router.

Qué necesitas:

  • Un nombre de dominio (el dominio es el único gasto pequeño e inevitable, normalmente unos pocos dólares al año) o un subdominio gratuito de algunos proveedores.
  • El add-on o contenedor de túnel instalado junto a Home Assistant.
  • Tu proxy añadido a trusted_proxies.

Ventajas: sin reenvío de puertos, funciona detrás de CGNAT de operadora, los certificados se gestionan por ti.

Desventajas: dependes de un tercero, y algunas funciones de túnel cambian las condiciones de su nivel gratuito.

Opción B: DNS dinámico más reenvío de puertos

La ruta clásica. Un nombre de DNS dinámico gratuito apunta a la IP de tu casa, tu router reenvía el puerto 443 a un proxy inverso y el proxy obtiene un certificado gratuito de Let's Encrypt.

Ventajas: control total, sin cuotas recurrentes.

Desventajas: necesita una IP pública (no estar detrás de CGNAT de operadora), expone un puerto y exige mantener el proxy actualizado.

Opción C: un embudo público a través de una VPN en malla

Algunas herramientas de VPN en malla pueden publicar un servicio en internet por HTTPS en una dirección generada, mientras el resto de tus dispositivos sigue privado. La configuración es corta, pero el proveedor fija la dirección generada, así que comprueba que el descubrimiento de OAuth sigue superándose con ese nombre de host.

Qué opción gratuita te conviene

SituaciónMejor opciónEsfuerzo
Detrás de CGNAT de operadora o de una internet compartida de edificioServicio de túnelBajo
Internet doméstica con IP pública real y algo de soltura con redesDNS dinámico y proxy inversoMedio
Quieres la prueba más rápidaEmbudo de VPN en mallaBajo
Quieres cero mantenimientoHome Assistant Cloud (de pago)Mínimo

💡 Prueba antes de comprometerte. Sea cual sea tu elección, confirma que la página https://your-address/api/mcp responde desde datos móviles antes de tocar ChatGPT. Te ahorrará una hora de adivinanzas.

Un joven en un andén de tren al atardecer mirando su teléfono

La ruta del proxy de webhooks

Algunos proyectos de la comunidad, como el add-on ha-mcp, toman un camino distinto al de la integración incorporada. Ejecutan su propio servidor MCP y lo exponen mediante una URL secreta o a través de un proxy de webhooks. En el caso de los usuarios de Nabu Casa, el proxy genera una dirección con la forma https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx.

Si sigues este camino, tres detalles son importantes:

  • Copia la URL completa desde el registro del add-on. Un secreto mal escrito o regenerado es un motivo habitual de fallo.
  • Trata la URL como una contraseña. Cualquiera que la tenga podría llegar a tus herramientas.
  • Regénerala si se filtra. Después actualiza el conector.

Esta vía es útil si el flujo de OAuth integrado sigue fallando en tu configuración. La contrapartida es que dependes de un add-on de terceros, así que lee qué expone antes de activarlo.

Mantenlo seguro

Dar a un chatbot en la nube el poder de encender y apagar interruptores merece cierta precaución. Unas cuantas reglas mantienen el riesgo bajo.

Un candado de latón en una puerta de jardín de madera desgastada, con hiedra y luz de la mañana

Expón menos de lo que crees

No expongas cerraduras de puertas, puertas de garaje, paneles de alarma ni nada que abra tu casa a un desconocido. Empieza con luces, clima y multimedia. Añade más solo cuando confíes en su comportamiento.

Usa un usuario dedicado

Crea un usuario de Home Assistant separado para el asistente, si tu configuración lo permite, así podrás revocar el acceso con un solo clic sin tocar tu propio inicio de sesión.

Vigila la actividad

Revisa el registro de actividad después de las primeras sesiones. Verás exactamente qué servicios llamó el asistente. Si algo te sorprende, reduce la lista de entidades expuestas.

Mantén el software actualizado

Tanto Home Assistant como cualquier add-on de proxy o túnel reciben parches de seguridad. Una dirección pública hace que las actualizaciones sean más importantes, no menos.

Nunca pegues secretos en un chat

Los tokens de acceso de larga duración, las URL de webhooks y las contraseñas no tienen cabida en los prompts. Si compartes la configuración para resolver problemas, sustitúyelos por marcadores de posición.

Qué puedes hacer cuando funciona

Cuando por fin la conexión se mantiene, empieza la diversión. Estas son solicitudes que funcionan bien con un conjunto modesto de entidades expuestas:

  • "Apaga todas las luces de abajo excepto la del pasillo."
  • "¿Queda algo encendido en la cocina?"
  • "Pon el termostato del dormitorio a 19 grados y dime la lectura actual."
  • "Activa la escena de la película."
  • "¿Qué ventanas están abiertas ahora mismo?"

Una mano pulsando un interruptor de pared blanco y liso, con una lámpara cálida encendida al fondo

Escribe mejores nombres de entidades

El modelo elige los dispositivos por su nombre. "Luz 3" es un mal nombre. "Lámpara de lectura del salón" es uno bueno. Dedica veinte minutos a renombrar entidades y áreas, y la precisión mejora de forma notable. Asigna cada dispositivo a un área para que una frase como "apaga las luces del dormitorio" tenga con qué coincidir.

Usa scripts y escenas como atajos

En lugar de hacer que el asistente componga cinco acciones por separado, envuélvelas en un script o escena. "Buenas noches" se convierte en una sola llamada que fija la lógica en la que confías: luces apagadas, termostato más bajo, multimedia en pausa. Menos llamadas significan menos oportunidades de error.

Pide el estado antes de la acción

Un hábito que evita sorpresas: pregunta qué está encendido antes de pedir que apague cosas. Así confirmas que la conexión está activa y que los nombres de las entidades coinciden con lo que esperas.

Una pareja relajándose en un sofá por la tarde con un equipo portátil, una lámpara encendida y un gato sobre una manta

¿Sigues atascado? Tabla de diagnóstico rápido

SíntomaCausa más probablePrueba esto
Indicador de carga eterno al añadir el conectorServidor inaccesible desde internetPrueba la URL con datos móviles
"Failed to resolve OAuth client"Desajuste de proxy, dominio o URL externaAlinea la URL externa, añade los proxies de confianza, vuelve a añadir el conector
El inicio de sesión funciona, no aparecen herramientasNo hay entidades expuestasExpón algunas entidades en los ajustes de asistentes de voz
Herramientas listadas, acciones rechazadasPlan, modo o llamadas a herramientas bloqueadasPrueba una solicitud de solo lectura, un chat nuevo, revisa los ajustes del conector
Funciona un día y luego se detieneIP cambiada, túnel caducado o secreto regeneradoRevisa el DNS dinámico, el estado del túnel y el registro del add-on
Se activa el dispositivo equivocadoNombres de entidades vagosRenombra las entidades y asigna áreas
Error 404 en la URL del conectorRuta incorrectaUsa la ruta /api/mcp

Con qué asistente combinarlo

ChatGPT no es el único asistente que puede hablar con un servidor MCP. Si quieres una segunda opinión o una alternativa cuando un servicio se cae, vale la pena tener otros modelos de chat a mano para ayuda con la configuración, escribir YAML y leer registros. En PicassoIA puedes comparar Claude Fable 5 para tareas de programación, Gemini 3.1 Pro para respuestas generales, DeepSeek V3.1 para razonamiento económico y GPT 5.6 Luna para respuestas rápidas. Son útiles para redactar automatizaciones, convertir una idea difusa en un script limpio o traducir un registro confuso a un lenguaje claro. Aquí no se conectan por sí solos a tu Home Assistant, pero hacen que la parte de resolución de problemas vaya mucho más rápido.

💡 Prompt que funciona bien para ayudar con la configuración: "Esta es mi sección http: de Home Assistant y el error del conector. Explica qué no coincide y muestra una versión corregida. Usa marcadores de posición para cualquier dirección o token."

Pruébalo tú mismo en Picasso IA

Conseguir que un chatbot maneje tu casa es un proyecto satisfactorio, y la misma curiosidad da frutos en otros lugares. Si te gusta la parte de resolver problemas, abre los modelos de lenguaje de Picasso IA y prueba a pegar un registro, redactar una automatización o pedir una explicación clara de un ajuste de proxy. Luego ve más allá: genera imágenes, clips cortos, locuciones o música con las demás herramientas de la plataforma. Elige un modelo, escribe un prompt y mira qué sale. Tu próximo experimento está a un prompt de distancia.

Compartir este artículo

Elige tu idioma

FreeCrea imágenes y videos con IAGratis, sin tarjeta de créditoGeneraciones gratis para empezarSeedance 2.5 Lite incluidoEmpieza gratis ya