Conecta ChatGPT a Home Assistant mediante la integración MCP Server incluida y controla tus luces, termostatos y sensores desde una ventana de chat. Mira qué necesita la configuración, qué dispositivos exponer, cuáles mantener fuera y cómo probar cada comando con seguridad.
Vas en el tren, recuerdas que la calefacción sigue encendida y ya tienes abierta una ventana de chat en el teléfono. Escribir "baja la calefacción del salón a 17 y dime si la puerta trasera está cerrada" en ChatGPT y ver cómo la casa obedece solía ser una demostración para desarrolladores. Ahora funciona gracias a MCP, el Model Context Protocol, y a la integración MCP Server incluida en Home Assistant. Este artículo explica cómo encajan las piezas, qué debes preparar, qué dispositivos conviene exponer y cuáles deben quedar fuera de alcance.
En resumen: Home Assistant se convierte en un servidor MCP, ChatGPT actúa como cliente y tus luces, termostatos y sensores pasan a ser herramientas que el chatbot puede invocar. Sin código personalizado, sin ningún servicio intermedio, y tú decides la lista de entidades. Si buscas una configuración fiable de automatización del hogar inteligente que puedas controlar con lenguaje natural, esta es ahora la forma más sencilla de hacerlo.
MCP es un protocolo abierto que permite a una aplicación de IA comunicarse con sistemas externos mediante un conjunto estándar de herramientas, prompts y recursos. En lugar de que cada chatbot invente su propio formato de plugin, un mismo servidor puede atender a cualquier cliente que hable el protocolo. Home Assistant, el hub de código abierto que ya se comunica con miles de dispositivos, ahora puede actuar como ese servidor.
Cuando le pides a ChatGPT que atenúe una lámpara, el modelo no adivina una solicitud web. Lee una lista de herramientas que Home Assistant publica, elige la correcta, rellena el nombre de la entidad y el brillo, y espera el resultado. La respuesta que lees se construye con lo que tu casa devolvió realmente, no con la imaginación del modelo.
Mucha gente confunde estas integraciones, así que aquí tienes la diferencia:
| Integración | Dirección | Qué hace | Úsala cuando |
|---|---|---|---|
| MCP Server | ChatGPT hacia Home Assistant | ChatGPT controla tu casa a través de la API de Assist | Quieres chatear con tu casa desde la aplicación de ChatGPT |
| OpenAI Conversation | Home Assistant hacia los modelos de OpenAI | Assist usa un modelo de OpenAI como su cerebro | Quieres comandos de voz más inteligentes en altavoces y paneles de pared |
| Integración cliente MCP | Home Assistant hacia otros servidores MCP | Assist accede a herramientas externas | Quieres que tu asistente use calendarios u otros servicios |
Este artículo se centra en la primera fila. Las tres pueden funcionar a la vez sin conflictos.
💡 Consejo: Usa OpenAI Conversation para el asistente de voz de la cocina y MCP Server para los chats escritos desde el teléfono. Resuelven problemas distintos y comparten las mismas entidades expuestas.
La integración MCP Server llegó con Home Assistant 2025.2, así que cualquier instalación actual la incluye. Antes de tocar ningún ajuste, asegúrate de tener:
El nombre importa más que el hardware. Las entidades llamadas "Light 3" o "Switch 12" son malos objetivos para un chat. Renómbralas primero como "Lámpara del escritorio" o "Calefactor del pasillo", porque el modelo elige herramientas y destinos según esas etiquetas.
Este es el paso que frena a la mayoría. Las conexiones remotas necesitan una URL HTTPS pública para Home Assistant, o Home Assistant Cloud. ChatGPT llama a tu endpoint desde internet, así que una dirección local como homeassistant.local:8123 nunca funcionará. Tienes tres opciones realistas:
⚠️ Nunca abras un puerto HTTP sin cifrar a internet. Este endpoint puede encender y apagar dispositivos de tu casa, así que trátalo como una puerta principal.
Los clientes locales son otra historia. La documentación describe mcp-proxy como un puente para herramientas basadas en stdio, junto con un token de larga duración. Eso encaja con aplicaciones de escritorio en tu propia red, pero no con el conector en la nube de ChatGPT.
La documentación de Home Assistant indica que ChatGPT en los planes Plus, Pro y superiores es un cliente compatible. Los conectores MCP personalizados están detrás del modo desarrollador en la configuración de ChatGPT, en la sección de conectores. Los nombres de los menús cambian entre versiones, así que busca "Conectores" o una sección extra de ajustes y activa el modo desarrollador. Las normas de los planes también cambian de vez en cuando, así que revisa qué incluye tu suscripción antes de dedicar una tarde a la configuración.
El endpoint ya está activo en /api/mcp, y la API de Assist tiene su propio endpoint en /api/mcp/assist. El servidor usa Streamable HTTP, así que no hay ningún socket de larga duración que vigilar. Los tutoriales antiguos pueden mostrar otro endpoint, así que fíate de la página de la integración para la versión que tienes instalada.
Home Assistant respeta la página de entidades expuestas en los ajustes del asistente de voz. Solo es visible para el conector lo que expongas allí, y esa lista única es tu control de seguridad más importante. Usa esta tabla como punto de partida:
| Categoría | Ejemplos | Recomendación |
|---|---|---|
| Seguro para exponer | Luces, escenas, ventiladores, reproductores multimedia | Empieza por aquí |
| Sensores | Temperatura, humedad, contactos de puertas, consumo energético | Solo lectura por naturaleza, ideales para preguntas |
| Piénsalo dos veces | Termostatos, calefactores, riego, persianas motorizadas | Los errores cuestan dinero o confort |
| Mantener fuera | Cerraduras, puertas de garaje, paneles de alarma, cámaras | Consulta la sección de riesgos más abajo |
Home Assistant ofrece dos formas de autenticarse. La primera es OAuth mediante IndieAuth, en la que el cliente se identifica con un ID de cliente basado en una URL. La segunda es un token de acceso de larga duración, que creas desde tu perfil de usuario en la pestaña de Seguridad para los clientes que no admiten OAuth.
Hay un límite que conviene conocer: Home Assistant no admite Dynamic Client Registration (RFC 7591), así que un cliente que lo exija no podrá registrarse. Prefiere OAuth siempre que la pantalla del conector lo ofrezca. El acceso se puede revocar, y nunca pegas un secreto en un ajuste del chat. Si la pantalla solo ofrece un campo para el token, un token de larga duración funciona, pero protégelo como si fuera una contraseña.
/api/mcp, por ejemplo https://home.example.com/api/mcp.Avanza paso a paso y sin prisa. Empieza con una pregunta de solo lectura: "¿Qué temperatura hay en el dormitorio?" Luego prueba algo reversible: "Enciende la lámpara del escritorio al 30 por ciento." Solo cuando funcionen ambas, pide algo compuesto como "Atenúa el salón, cierra las persianas y dime si hay alguna ventana abierta."
💡 Consejo: Abre el Registro de Home Assistant después de cada prueba. Muestra qué entidad cambió y cuándo, que es la forma más rápida de confirmar lo que ChatGPT hizo realmente.
| Síntoma | Causa probable | Solución |
|---|---|---|
| El conector no puede llegar al servidor | La URL no es pública o no es HTTPS | Abre la URL desde tu teléfono con datos móviles |
| Bucle de inicio de sesión o error de registro | El cliente necesita Dynamic Client Registration | Prueba un token de larga duración u otro cliente |
| La lista de herramientas llega vacía | No hay entidades expuestas | Expón entidades en los ajustes del asistente de voz |
| Reacciona el dispositivo equivocado | Nombres duplicados o vagos | Renombra las entidades y añade áreas y alias |
| Respuestas lentas | Demasiadas entidades expuestas | Reduce la lista a lo que realmente usas |
La iluminación es lo más fácil de conseguir, porque los resultados son inmediatos y nada se rompe si el modelo entiende mal lo que dices. Frases que funcionan de forma fiable:
El mejor truco es crear las escenas dentro de Home Assistant y dejar que ChatGPT las active por su nombre. Una sola llamada a la herramienta "Noche de cine" es más fiable que doce ajustes de luz por separado, y puedes afinar la escena sin tocar tus prompts.
Aquí es donde el modelo demuestra su valor, porque puede combinar información en lugar de seguir una regla fija. Pregunta "¿Qué habitaciones están ahora por encima de 22 grados?" o "¿Hay alguna ventana abierta mientras la calefacción está encendida?" y leerá varios sensores para responder en una sola frase. Un asistente de voz clásico no puede hacer eso sin una automatización personalizada para cada pregunta.
Las rutinas siguen la misma lógica. Por la mañana puedes pedir la temperatura, las luces de la planta baja y el estado de las persianas en un solo mensaje antes de que se termine el café. Por la noche, una sola frase puede apagar las lámparas y confirmar que el calefactor del salón está apagado.
💡 Consejo: Si repites la misma secuencia cada día, conviértela en una automatización de Home Assistant. Usa el chat para las excepciones y las preguntas, y deja que las automatizaciones se encarguen del horario fijo.
El endpoint es potente, y por eso esta sección importa. Un chatbot puede malinterpretar una frase, y una petición mal formulada puede tener consecuencias físicas.
Las cerraduras, las puertas de garaje, los paneles de alarma y las cámaras no deberían estar en la lista de expuestos. Un comando equivocado que abra la puerta principal, o una petición que desactive la alarma, es un problema mucho mayor que una lámpara que se enciende en la habitación equivocada.
También existe un riesgo más sutil llamado inyección de prompts. Si el mismo chat lee texto de otras fuentes, como una página web o un correo a través de otro conector, unas instrucciones ocultas en ese texto podrían empujar al modelo a invocar las herramientas de tu casa. Mantén tu conector de Home en chats propios, alejado de otros conectores que lean contenido que tú no controlas.
Crea en Home Assistant un usuario específico sin permisos de administrador solo para ChatGPT, e inicia sesión con esa cuenta al autorizar el conector. La lista de entidades expuestas sigue siendo el verdadero filtro, pero una identidad separada mantiene tu cuenta de administrador fuera de la ecuación y te permite revocar el acceso con un solo clic. Una rutina corta ayuda:
Antes de exponer un solo dispositivo, un modelo de lenguaje potente puede preparar el terreno. Puede sugerir nombres de entidades más claros, redactar escenas y escribir el YAML de las automatizaciones que luego pegas en Home Assistant. GPT 5.4 en PicassoIA es adecuado para esta tarea porque sigue instrucciones largas y detalladas y acepta imágenes junto con texto.
| Ajuste | Valor a probar | Por qué |
|---|---|---|
| verbosity | low | Respuesta corta, lista para pegar |
| reasoning_effort | none para renombrar, medium o high para automatizaciones | Velocidad para tareas simples, profundidad para la lógica |
| max_completion_tokens | Súbelo cuando el esfuerzo sea alto | El razonamiento puede consumir todo el presupuesto y dejar una respuesta vacía |
| system_prompt | "Devuelve solo YAML" | Evita respuestas charlatanas que rompen el copiar y pegar |
⚠️ Revisa cada automatización generada antes de guardarla. Un modelo puede inventarse un nombre de entidad que no existe en tu casa.
Si quieres una segunda opinión sobre el mismo prompt, Claude Sonnet 5 y Gemini 3.5 Flash también están disponibles en la colección de modelos de lenguaje de la plataforma.
Una casa inteligente se ve mejor cuando las pantallas coinciden con las habitaciones que las rodean. Puedes usar PicassoIA para crear las imágenes de tu propio sistema: un fondo tranquilo para la tableta de pared, paneles de inspiración para cada habitación o imágenes de cabecera para la entrada del blog donde documentas tu proyecto.
Tres modelos merecen una primera prueba:
Prueba un prompt como "Un salón acogedor al anochecer, luz cálida de lámpara, una tableta de pared junto a la estantería, fotografía analógica natural, objetivo de 35 mm" y cambia un detalle cada vez: la hora del día, el objetivo, la habitación. En pocos intentos tendrás un conjunto de imágenes que encaja con tu casa, y el mismo hábito de probar cambios pequeños que funciona con tus escenas de Home Assistant sirve también para las imágenes. Abre PicassoIA, elige un modelo y genera tu primera imagen hoy mismo.
Elige tu idioma
