Actualizado el 25 de enero de 2026
MQTT sigue siendo, en 2026, el pilar fundamental para la comunicación de dispositivos IoT en un hogar inteligente robusto. Sin embargo, la forma de configurarlo en Home Assistant ha evolucionado drásticamente. Aquellos viejos métodos de editar archivos YAML de forma manual han dado paso a un proceso mucho más sencillo e intuitivo a través de la interfaz de usuario. Esta guía definitiva te mostrará cómo realizar una configuración de MQTT en Home Assistant moderna, estable y preparada para el futuro.
¿Qué es MQTT y por qué es crucial para Home Assistant?
Imagina MQTT (Message Queuing Telemetry Transport) como un cartero increíblemente eficiente para tus dispositivos inteligentes. En lugar de que cada dispositivo tenga que hablar directamente con Home Assistant, todos envían sus mensajes (estados, telemetría) a una «oficina de correos» central, conocida como Broker MQTT. Home Assistant se suscribe a los «buzones» que le interesan y recibe la información al instante. Es un protocolo ligero, rápido y fiable, perfecto para dispositivos de bajo consumo como sensores o interruptores basados en ESPHome.
Paso 1: Instalar el Mosquitto Broker (El Método Recomendado)
Olvídate de instalaciones complicadas en Docker o en otras máquinas. La forma más sencilla y estable de tener un broker en 2026 es usando el Add-on oficial de Home Assistant.
- Ve a Ajustes > Add-ons > Tienda de Add-ons.
- Busca «Mosquitto broker» y haz clic en él.
- Pulsa «Instalar» y espera a que finalice el proceso.
- Una vez instalado, ve a la pestaña «Configuración» del Add-on. Aquí necesitarás crear un usuario para que Home Assistant y tus dispositivos se conecten de forma segura. En la sección
logins, añade un usuario y una contraseña. Puedes dejarlo así:logins: - username: tu_usuario_mqtt password: tu_contraseña_segura - Guarda la configuración.
- Vuelve a la pestaña «Información» y activa las opciones «Iniciar en el arranque» y «Vigilante». Finalmente, pulsa «Iniciar».
¡Listo! Ya tienes tu oficina de correos MQTT funcionando directamente en Home Assistant.
Paso 2: La Integración MQTT de Home Assistant (vía UI)
Con el broker en marcha, ahora toca decirle a Home Assistant cómo conectarse a él.
- Ve a Ajustes > Dispositivos y Servicios.
- Si Home Assistant no ha descubierto el broker automáticamente, haz clic en el botón «+ Añadir Integración».
- Busca «MQTT» y selecciónalo.
- Home Assistant intentará conectarse al broker que acabamos de instalar. Debería detectar la configuración automáticamente. Si te pide credenciales, introduce el usuario y contraseña que creaste en el paso anterior.
- En la siguiente pantalla, asegúrate de marcar la opción «Habilitar el descubrimiento de dispositivos». Esto es CRUCIAL.
- Pulsa «Enviar» y la integración MQTT de Home Assistant estará completa.
(Aquí iría una captura de pantalla mostrando la integración MQTT en la sección de Dispositivos y Servicios de Home Assistant 2026)
La Magia del MQTT Discovery: Integración Automática
El paso más importante que hemos realizado es activar el MQTT Discovery. Esta función permite que los dispositivos compatibles se anuncien a sí mismos al broker, y Home Assistant los añadirá automáticamente con todas sus entidades, sin que tengas que escribir ni una sola línea de YAML.
Sistemas como Tasmota, ESPHome o Zigbee2MQTT en Home Assistant 2026: Guía Completa de Instalación y Configuración utilizan este método de forma nativa. Simplemente configuras en tu dispositivo la IP de tu Home Assistant y las credenciales MQTT, y este aparecerá mágicamente en la interfaz de Home Assistant.
Ejemplo práctico con Tasmota: En la configuración MQTT de tu dispositivo Tasmota, solo necesitas rellenar el Host (la IP de Home Assistant), el Usuario y la Contraseña. Al guardar, Tasmota enviará los mensajes de configuración necesarios y Home Assistant creará un nuevo dispositivo con todos sus sensores y actuadores.
Configuración Avanzada con `configuration.yaml` (Para Expertos)
Aunque el 95% de los casos de uso se cubren con MQTT Discovery, puede que tengas algún dispositivo antiguo o un proyecto muy específico que requiera una definición manual. En estos casos, todavía podemos recurrir al archivo configuration.yaml, pero la sintaxis ha cambiado respecto a los tutoriales antiguos.
Toda la configuración de entidades MQTT ahora debe anidarse bajo el dominio mqtt:. Ya no se define la plataforma dentro de cada tipo de entidad (light, sensor, etc.).
¡Atención! Este código es un ejemplo consolidado y actualizado a la sintaxis de 2026. Debes adaptarlo a los topics y payloads de tus propios dispositivos.
# configuration.yaml
mqtt:
# La configuración del broker ya NO se pone aquí. Se gestiona desde la UI.
# --- LUCES MQTT ---
light:
- name: "Luz del Sofá"
unique_id: "luz_sofa_mqtt_01" # Es una buena práctica añadir un unique_id
state_topic: "shellies/sofa/relay/0"
command_topic: "shellies/sofa/relay/0/command"
availability:
- topic: "shellies/sofa/online"
payload_available: "true"
payload_not_available: "false"
payload_on: "on"
payload_off: "off"
optimistic: false
qos: 1
retain: false
# --- SENSORES MQTT ---
sensor:
# Sensor de consumo de la lavadora (dispositivo Tasmota)
- name: "Lavadora Watios"
unique_id: "lavadora_watios_mqtt_01"
state_topic: "tele/SonoffWashing_machine/SENSOR"
value_template: "{{ value_json.ENERGY.Power }}"
unit_of_measurement: "W"
device_class: "power"
state_class: "measurement"
# Sensor de uso de CPU desde IOTLink
- name: "PC Albert - CPU Usada"
unique_id: "pc_albert_cpu_mqtt_01"
state_topic: "iotlink/workgroup/albert2018/windows-monitor/stats/cpu/usage"
unit_of_measurement: '%'
icon: mdi:speedometer
availability:
- topic: "iotlink/workgroup/albert2018/lwt"
payload_available: "ON"
payload_not_available: "OFF"
qos: 1
# --- SENSORES BINARIOS MQTT ---
binary_sensor:
- name: "PC Albert - Conectado"
unique_id: "pc_albert_conectado_mqtt_01"
state_topic: "iotlink/workgroup/alberT2018/lwt"
payload_on: "ON"
payload_off: "OFF"
device_class: "connectivity"
qos: 1
Si quieres saber más sobre cómo integrar tu PC, puedes consultar esta guía sobre cómo encender y apagar un PC desde Home Assistant.
Resolución de Problemas (Troubleshooting)
Incluso con la configuración simplificada, a veces las cosas no salen como esperamos. Aquí tienes los problemas más comunes y cómo solucionarlos:
- La integración no se conecta al broker: Revisa los logs del Add-on Mosquitto (en Ajustes > Add-ons > Mosquitto broker > Log). Los errores más comunes son credenciales incorrectas (usuario/contraseña) en la configuración del add-on o en la integración.
- Mis dispositivos no aparecen (con Discovery activado):
- Asegúrate de que la IP del broker, el puerto (normalmente 1883), el usuario y la contraseña están configurados exactamente igual en el dispositivo (Tasmota, ESPHome) que en Home Assistant. Un error tipográfico es la causa más frecuente.
- Verifica que el dispositivo y Home Assistant están en la misma red y que no hay firewalls bloqueando la comunicación. Si usas redes más complejas, una mala segmentación de red podría ser el problema.
- Una entidad no se actualiza o no responde: Este es el momento de usar una herramienta externa como MQTT Explorer. Conéctala a tu broker (usando la IP de Home Assistant y las credenciales MQTT) y podrás ver en tiempo real todos los mensajes que se están publicando. Así podrás confirmar si tu dispositivo está enviando datos al topic correcto o si está recibiendo los comandos que Home Assistant le envía.
Con esta guía, tienes todo lo necesario para dominar la integración MQTT en Home Assistant en 2026. El enfoque en la configuración por interfaz y el autodescubrimiento ha hecho que este protocolo sea más accesible que nunca, consolidándolo como la columna vertebral de cualquier instalación de domótica seria y escalable.