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.

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:
- Activas la integración del servidor MCP en Home Assistant.
- Decides qué entidades puede ver el asistente, usando la configuración de exposición de Assist.
- Pegas la URL del servidor en ChatGPT como conector personalizado y eliges OAuth como método de autenticación.
- 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 cliente | De dónde sale la solicitud | ¿Necesita acceso público? |
|---|
| App de escritorio en tu red doméstica | Tu propio equipo | Normalmente no |
| ChatGPT en la web | Servidores de OpenAI | Sí |
| App móvil con datos móviles | Nube o teléfono, fuera de tu LAN | Sí |
| Script o agente local | Misma red | No |
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.

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 pegaste | Problema |
|---|
http://homeassistant.local:8123/api/mcp | Solo local, y no es HTTPS |
https://myhome.example.com | Falta 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/mcp | Forma 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.

Lista de comprobación paso a paso
Sigue estos pasos en orden. Detente en cuanto algo empiece a funcionar.
- 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.
- Confirma la exposición. Asegúrate de que al menos una entidad está expuesta al asistente.
- Confirma la URL externa. Ajustes, Sistema, Red. Usa la misma dirección HTTPS que piensas dar a ChatGPT.
- Prueba desde fuera. Datos móviles, sin VPN, carga la página de inicio de sesión.
- Revisa las cabeceras del proxy. Si usas algún proxy o túnel, añádelo a
trusted_proxies.
- Elimina los conectores antiguos. Borra los intentos fallidos en ChatGPT antes de añadir uno nuevo.
- Añade el conector. Pega la URL completa de
/api/mcp y elige OAuth.
- Prueba con una pregunta de solo lectura. Después intenta una acción inofensiva, como una sola lámpara.
- Lee los registros. Si algo sigue fallando, el registro de Home Assistant y el de tu proxy suelen indicar el verdadero culpable.

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.

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ón | Mejor opción | Esfuerzo |
|---|
| Detrás de CGNAT de operadora o de una internet compartida de edificio | Servicio de túnel | Bajo |
| Internet doméstica con IP pública real y algo de soltura con redes | DNS dinámico y proxy inverso | Medio |
| Quieres la prueba más rápida | Embudo de VPN en malla | Bajo |
| Quieres cero mantenimiento | Home 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.

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.

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

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.

¿Sigues atascado? Tabla de diagnóstico rápido
| Síntoma | Causa más probable | Prueba esto |
|---|
| Indicador de carga eterno al añadir el conector | Servidor inaccesible desde internet | Prueba la URL con datos móviles |
| "Failed to resolve OAuth client" | Desajuste de proxy, dominio o URL externa | Alinea la URL externa, añade los proxies de confianza, vuelve a añadir el conector |
| El inicio de sesión funciona, no aparecen herramientas | No hay entidades expuestas | Expón algunas entidades en los ajustes de asistentes de voz |
| Herramientas listadas, acciones rechazadas | Plan, modo o llamadas a herramientas bloqueadas | Prueba una solicitud de solo lectura, un chat nuevo, revisa los ajustes del conector |
| Funciona un día y luego se detiene | IP cambiada, túnel caducado o secreto regenerado | Revisa el DNS dinámico, el estado del túnel y el registro del add-on |
| Se activa el dispositivo equivocado | Nombres de entidades vagos | Renombra las entidades y asigna áreas |
| Error 404 en la URL del conector | Ruta incorrecta | Usa 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.