Conecta la IA a tu Home Assistant

Al terminar tendrás un Home Assistant recién instalado con Claude IA conectado y Zigbee2MQTT bien configurado, listo para poner en marcha tu hogar inteligente.

¡RECUERDA! Añade routers a tu malla Zigbee PRIMERO (dispositivos enchufados a la corriente, p. ej. enchufes inteligentes y bombillas), para que la malla sea fuerte antes de empezar a añadir dispositivos con pilas.

Lo que necesitas
  • Un Home Assistant en marcha, o un PC y RepairGuyDK Installer for Home Assistant para instalarlo (ver paso 0). Fuera de Dinamarca el instalador se vende como archivo ISO para descargar, que grabas tú mismo en un USB con Rufus o balenaEtcher. El USB listo para usar solo se vende a clientes en Dinamarca.
  • Una cuenta gratuita de GitHub para HACS. Créala ahora e inicia sesión.
  • Una cuenta de Claude (la gratuita basta para probar). Descarga Claude Desktop e inicia sesión con tu cuenta.
  • Uno de estos dos caminos (eliges en el paso 4):
    • Camino 1: Nabu Casa (Home Assistant Cloud). Una suscripción de pago con la que Claude funciona en todas partes, también en el móvil y fuera de casa.
    • Camino 2: Un PC con Windows en la misma red que Home Assistant. Gratis, pero solo funciona en casa en Claude Desktop.
Crear cuenta de GitHub Crear cuenta de Claude Descargar Claude Desktop

¿Ya tienes las cuentas y Claude Desktop? Entonces sáltate esto.

Cada botón azul abre Home Assistant en una pestaña nueva. Cierra la pestaña cuando termines el paso y vuelve a esta guía.

  1. 0

    ¿Ya tienes Home Assistant en marcha?

    La guía empieza cuando Home Assistant ya funciona en un PC de tu casa.

    Sí, ya lo tengo Ve directamente al paso 2.
    No, todavía no Instálalo primero con RepairGuyDK Installer for Home Assistant:
    1. Si has comprado el archivo ISO, grábalo primero en un USB vacío con Rufus (elige DD Image cuando te lo pregunte) o balenaEtcher. Se borra todo lo que hay en el USB. Si tienes el USB de RepairGuyDK, sáltate este punto.
    2. Conecta el USB al PC que será tu Home Assistant. Se borra todo el disco del PC.
    3. En la BIOS: UEFI activado, Secure Boot desactivado, Legacy/CSM desactivado
    4. Arranca el PC desde el USB (normalmente F9, F12, F11 o Esc al encenderlo) y elige la opción con UEFI
    5. Sigue las instrucciones de la pantalla y escribe SI (en mayúsculas) cuando te lo pida
    6. Quita el USB, conecta un cable de red y reinicia. Espera de 10 a 20 minutos y ve al paso 1.
  2. 1

    Abre Home Assistant y crea tu cuenta

    Abre un navegador en tu PC o móvil y ve a:

    http://homeassistant.local

    Haz clic en Crear mi hogar inteligente, crea tu usuario e indica dónde vives. Haz clic en Siguiente en las páginas siguientes y termina con Terminar. Apunta la contraseña.

    Primer arranque: si la página muestra "Preparing Home Assistant", espera de 10 a 20 minutos. Home Assistant se está descargando.

    ¿No funciona la dirección? Usa la dirección IP. Aparece en la pantalla de tu PC de Home Assistant, p. ej. http://192.168.1.50

  3. 2

    Instalar HACS

    HACS es una tienda de aplicaciones adicional para Home Assistant. La necesitamos para obtener la conexión IA.

    ¿Ya tienes HACS? Si HACS aparece en el menú de la izquierda de Home Assistant, ve directamente al paso 3.

    A. Añadir HACS a Home Assistant
    1. La primera vez que pulses un botón así, la página pide la dirección de tu Home Assistant. En el campo ya pone http://homeassistant.local:8123. Bórralo, escribe http://homeassistant.local sin :8123 y haz clic en Save. Si no funciona, escribe la dirección IP, p. ej. http://192.168.1.50. Aparece en la pantalla de tu PC de Home Assistant. Después haz clic en Open link.
    2. Tu Home Assistant pregunta si quieres añadir el repositorio de aplicación. Haz clic en Añadir. Un repositorio es solo la dirección de una tienda adicional.
    3. Ve a Configuración › Aplicaciones › Instalar aplicación y escribe HACS en el buscador de arriba
    4. Abre Get HACS, haz clic en Instalar y después en Iniciar. Solo funciona unos segundos. Que después aparezca como detenida es totalmente normal.
    5. Reinicia Home Assistant: ve a Configuración, haz clic en los tres puntos de arriba a la derecha y elige Reiniciar Home Assistant. Espera 1 o 2 minutos hasta que vuelva la página.
    B. Activar HACS
    1. Haz clic en el botón azul Añadir integración abajo a la derecha
    2. Escribe HACS en el buscador y elige HACS
    3. Marca todas las casillas y haz clic en Enviar
    4. Recibes un código de 8 caracteres y un enlace a GitHub. Abre el enlace, inicia sesión en GitHub, escribe el código y haz clic en Authorize HACS
    5. Vuelve a Home Assistant y haz clic en Terminar. Pulsa F5 y HACS aparecerá en el menú de la izquierda.
  4. 3

    Instalar la conexión IA (HA-MCP)

    HA-MCP es lo que permite a Claude hablar con tu casa. Funciona dentro de Home Assistant.

    A. Obtener HA-MCP en HACS
    1. HACS abre la página de HA-MCP Custom Component. Si pregunta si quieres añadir el repositorio, haz clic en Añadir.
    2. Haz clic en Descargar abajo a la derecha y después otra vez en Descargar
    3. Reinicia Home Assistant: ve a Configuración, haz clic en los tres puntos de arriba a la derecha y elige Reiniciar Home Assistant. Espera 1 o 2 minutos hasta que vuelva la página.
      ¡NO te saltes el reinicio! Sin reiniciar no encontrarás HA-MCP en el siguiente paso.
    B. Activar HA-MCP
    1. Haz clic en el botón azul Añadir integración abajo a la derecha
    2. Escribe HA-MCP en el buscador y elige HA-MCP Custom Component
    3. Elige HA-MCP Server y haz clic en Enviar
    4. Ahora pide un Administrator access token. Deja la ventana abierta y abre Home Assistant en una pestaña nueva (Ctrl+T)
    5. En la pestaña nueva: haz clic en tu nombre abajo en el menú de la izquierda, elige Seguridad y baja hasta Tokens de acceso de larga duración
    6. Haz clic en Crear token, escribe el nombre HA-MCP y haz clic en OK. Copia el código enseguida; solo se muestra una vez
    7. Vuelve a la pestaña de HA-MCP Server, pega el código en Administrator access token, deja vacíos el usuario y la contraseña y haz clic en Enviar
    8. Aparece un mensaje de que el servidor se ha iniciado y HA-MCP aparece en el menú de la izquierda. Ya funciona.

    Importante: Solo puede haber un HA-MCP en tu Home Assistant. Ve a Configuración › Aplicaciones y busca la aplicación Home Assistant MCP Server. Si está, ábrela y haz clic en Desinstalar antes de seguir. Si no está, no tienes que hacer nada.

  5. 4

    Elige tu camino y activa el acceso

    HA-MCP empieza totalmente cerrado, así que nadie puede conectarse. Aquí abres solo el camino que quieres usar.

    Abrir HA-MCP Server

    Junto a HA-MCP Server, haz clic en el engranaje. Después haz solo lo que pone en tu camino:

    Camino 1: Con Nabu Casa Funciona en claude.ai, en la app de Claude en el PC y en el móvil, también fuera de casa.
    1. Baja hasta pasar Home Assistant URL (advanced) y marca Remote access via webhook
    2. Deja Authentication mode en Sign in with Home Assistant (OAuth)
    3. Haz clic en Enviar y otra vez en el engranaje
    4. Copia la dirección que contiene ui.nabu.casa. Ve al paso 5.
    Camino 2: Solo en casa, gratis Funciona en Claude Desktop en un PC con Windows de tu red doméstica.
    1. Haz clic en el campo Network access (pone "This machine only (loopback)") y elige Local network
    2. Haz clic en Enviar y otra vez en el engranaje
    3. Copia la dirección completa que contiene :9584/private_, con http:// y :9584, p. ej. http://192.168.1.50:9584/private_XJtn3QszNpRXaYYmM6YeVA. No puede empezar por 127.0.0.1. Ve al paso 6.

    No toques los demás campos de la ventana.

    ¿No hay dirección con ui.nabu.casa después del Camino 1? Entonces Nabu Casa no está activado. Sigue el Camino 2.

    ¿La dirección empieza por 127.0.0.1 después del Camino 2? Entonces Local network no se ha guardado y Claude no puede llegar a tu Home Assistant. Haz clic otra vez en el engranaje, elige Local network en Network access, haz clic en Enviar y abre el engranaje una vez más. Ahora la dirección empieza por la IP de tu Home Assistant, p. ej. http://192.168.1.50:9584/private_...

    Cierra la ventana con la X cuando hayas copiado la dirección.

    La dirección es la llave de tu casa. Quien la tenga puede controlarlo todo. No la compartas y ocúltala en capturas de pantalla y vídeos.

  6. 5
    Solo Camino 1: Nabu Casa

    Dale la dirección a Claude

    Puedes hacerlo en el navegador en claude.ai o en Claude Desktop. Los botones son los mismos. Solo tienes que hacerlo en uno de los dos sitios.

    La conexión se guarda en tu cuenta de Claude. Después funciona en todos los sitios donde hayas iniciado sesión: en el navegador, en Claude Desktop y en el móvil.

    Abrir claude.ai
    1. Abre claude.ai en el navegador o abre Claude Desktop. Inicia sesión si te lo pide.
    2. Haz clic en tu nombre abajo a la izquierda y elige Configuración (Settings).
    3. En el menú de la izquierda, haz clic en Conectores (en inglés Connectors).
    4. Haz clic en el botón para añadir un conector personalizado (custom connector).
    5. En el campo Nombre escribe Home Assistant.
    6. En el campo URL pega la dirección con ui.nabu.casa del paso 4 (clic derecho y Pegar).
    7. Deja vacíos los demás campos y haz clic en Añadir.
    8. Ahora se abre tu Home Assistant. Inicia sesión con tu propio usuario de Home Assistant y haz clic en Permitir (Allow). Claude ya está conectado.

    ¿Has terminado el Camino 1? Sáltate el paso 6 y ve al paso 7.

  7. 6
    Solo Camino 2: En local en tu PC

    Ejecuta el programa de RepairGuyDK

    El programa conecta Claude Desktop con tu Home Assistant. No tienes que editar ningún archivo. Si todavía no tienes Claude Desktop, descárgalo e inicia sesión primero.

    Descargar Claude Desktop Abrir Claude Desktop

    Si ya tienes Claude Desktop, haz clic en Abrir Claude Desktop. Si el navegador pregunta si puede abrir Claude, haz clic en Abrir. Si no lo tienes, haz clic primero en Descargar Claude Desktop.

    Descargar Conexión IA de RepairGuyDK HA

    ¿Tienes el USB de RepairGuyDK? Entonces el programa también está ahí, en la carpeta Conexion-IA de la unidad REPAIRGUYDK.

    1. Haz clic derecho en el archivo zip descargado y elige Extraer todo
    2. Haz doble clic en INICIAR-AQUI
    3. Si Windows muestra "Windows protegió su PC", haz clic en Más información y después en Ejecutar de todas formas
    4. Pega la dirección con :9584/private_ del paso 4 (clic derecho en la ventana para pegar) y pulsa Enter
    5. Si Claude Desktop está abierto, el programa pregunta: ¿Puede el programa cerrar Claude Desktop ahora? (s/n). Escribe la letra s (de sí) y pulsa Enter. El programa instala lo necesario y vuelve a abrir Claude.
    6. Comprueba en Claude Desktop, en Configuración › Desarrollador (Developer), que home-assistant aparece en marcha
  8. 7

    Pruébalo

    1. Empieza un chat nuevo:
      Camino 1: en claude.ai, en Claude Desktop o en el móvil
      Camino 2: en Claude Desktop
    2. Escribe una de estas frases y pulsa Enter:
    • ¿Puedes ver mi Home Assistant?
    • Hazme una revisión del estado de mi Home Assistant.

    La primera vez, Claude pregunta si puede usar Home Assistant. Haz clic en Permitir.

Extra: MQTT y Zigbee2MQTT

¿Tienes un dongle Zigbee, p. ej. Home Assistant Connect ZBT o SONOFF? Entonces puedes instalar MQTT y Zigbee2MQTT con cuatro clics. Cada botón abre la página correcta en tu propio Home Assistant.

¿El botón muestra la página My Home Assistant con http://homeassistant.local:8123 en el campo? Borra :8123 para que ponga http://homeassistant.local (o la dirección IP, p. ej. http://192.168.1.50) y haz clic en Save. Pasa cuando usas otro navegador u otro móvil que en el paso 2, y solo hay que hacerlo una vez por navegador.

  1. A. Instalar Mosquitto (MQTT)Haz clic en Instalar, activa todos los interruptores y haz clic en Iniciar.
  2. B. Configurar MQTTConfirma que quieres configurar MQTT, elige "Use the official Mosquitto Mqtt Broker app" y haz clic en Terminar cuando indique que ha ido bien.
  3. C. Añadir Zigbee2MQTTHaz clic en Añadir cuando pregunte si quieres añadir el repositorio de aplicación.
  4. D. Instalar Zigbee2MQTTHaz clic en Instalar y activa todos los interruptores. ¡NO hagas clic en Iniciar! Claude la inicia por ti en el último paso.

Último paso: Conecta el dongle Zigbee a tu PC de Home Assistant. Empieza un chat nuevo con Claude y escribe:

Escribe esto a Claude (copiar/pegar)Configura Zigbee2MQTT con mi dongle e inícialo. Pregúntame qué dongle tengo. Guarda el puerto y el tipo de adaptador en los ajustes de la aplicación, y en env_vars añade name Z2M_ONBOARD_NO_SERVER con value "1", para saltarte la página de configuración inicial. Vuelve a leer los ajustes y comprueba que están guardados antes de iniciar la aplicación. Después comprueba en el registro que está conectada al dongle y a MQTT, y que no aparece "Onboarding page is available".

Claude encuentra el puerto y el tipo de adaptador por sí mismo e inicia Zigbee2MQTT por ti. Después no tienes que pasar por ninguna página de configuración en Zigbee2MQTT.

🎉

¡Enhorabuena, tu hogar inteligente está listo!

Home Assistant funciona, Claude está conectado y Zigbee2MQTT está listo para tus dispositivos. ¡Buen trabajo!

Siguiente paso: Añade primero tus routers (dispositivos enchufados a la corriente), para que tu malla Zigbee sea fuerte antes de que lleguen los dispositivos con pilas.

Prueba a escribir a Claude: "Crea una automatización que encienda la luz del pasillo cuando se ponga el sol"

Que lo disfrutes, de parte de RepairGuyDK 🔧

Si algo falla

¿Qué camino elijo?

Si tienes Nabu Casa (Home Assistant Cloud), sigue el Camino 1. Es lo más fácil y Claude también funciona en el móvil y fuera de casa. Si no tienes Nabu Casa, sigue el Camino 2. Es gratis, pero solo funciona en Claude Desktop en un PC de casa. Puedes ver si tienes Nabu Casa en Configuración › Home Assistant Cloud:

Si muestra que has iniciado sesión y estás conectado, tienes Nabu Casa. Sigue el Camino 1.

Si te invita a controlar tu casa cuando estás fuera, no tienes Nabu Casa. Sigue el Camino 2.

Los botones abren una página que no responde

Entonces tu navegador ha guardado una dirección equivocada de tu Home Assistant, normalmente con :8123 al final. Abre my.home-assistant.io/redirect/_change, borra lo que haya, escribe la dirección sin :8123 (p. ej. http://homeassistant.local o http://192.168.1.50) y haz clic en Save. Después prueba otra vez el botón.

homeassistant.local no se abre

Algunos routers y móviles no encuentran el nombre. Usa la dirección IP que aparece en la pantalla de tu PC de Home Assistant. También la encuentras en la lista de dispositivos conectados de tu router.

No encuentro Get HACS ni HA-MCP
  • Get HACS: pulsa F5 en la Tienda de aplicaciones. Si no ayuda, haz clic en los tres puntos de arriba a la derecha y elige Buscar actualizaciones.
  • HA-MCP en Añadir integración: se te ha olvidado el reinicio del paso 3. Reinicia Home Assistant e inténtalo otra vez.
Claude no ve mi Home Assistant
  • Camino 1: comprueba que Remote access via webhook esté marcado en el engranaje de HA-MCP Server, que hayas copiado la dirección completa con ui.nabu.casa y que el acceso remoto esté activado en Home Assistant Cloud. Elimina el conector en claude.ai y vuelve a añadirlo.
  • Camino 2: comprueba que Network access esté en Local network en el engranaje de HA-MCP Server. Cierra Claude del todo con Archivo › Salir (también desde el icono junto al reloj) y vuelve a abrirlo. Tu PC debe estar en la misma red que Home Assistant. Vuelve a ejecutar el programa de RepairGuyDK con la dirección que contiene :9584. Después comprueba en Claude Desktop, en Configuración › Desarrollador, que aparece home-assistant.
  • Los dos caminos: comprueba que HA-MCP aparezca en el menú de la izquierda de Home Assistant. Si Claude ve tus cosas pero no puede cambiarlas, haz clic en el engranaje junto a HA-MCP Server y comprueba que Read Only Mode esté desactivado (gris).
    Read Only Mode en HA-MCP Server con el interruptor desactivado, marcado en rojo
¿Dónde está el archivo de ajustes de Claude Desktop? (Camino 2)

El programa de RepairGuyDK encuentra el archivo por sí mismo, así que normalmente no tienes que buscarlo. Si quieres verlo, abre Claude Desktop, ve a Configuración › Desarrollador y haz clic en Editar configuración (Edit Config). El archivo se llama claude_desktop_config.json.

  • Versiones nuevas de Claude Desktop para Windows: C:\Users\TuNombre\AppData\Local\Claude-Data\claude_..., donde la carpeta termina en un código que cambia de un PC a otro
  • Versiones antiguas y muchas guías en internet: %APPDATA%\Claude
  • AppData es una carpeta oculta. Escribe la dirección directamente en la barra de direcciones del Explorador de archivos, o activa los elementos ocultos en Vista.

El archivo pertenece a tu usuario de Windows, no a tu cuenta de Claude. Si cambias entre varias cuentas de Claude en el mismo usuario de Windows, todas tendrán la misma conexión. Para mantenerlas separadas, usa otro usuario de Windows.

¿Es seguro?

HA-MCP empieza totalmente cerrado hasta que abres tu camino en el paso 4. La dirección contiene una clave secreta larga que HA-MCP ha creado por sí mismo. Con el Camino 2 todo funciona solo en tu propia red. Con el Camino 1 la conexión va cifrada a través de Nabu Casa, y además Claude tiene que iniciar sesión con tu usuario de Home Assistant antes de tener acceso. Claude pide permiso antes de usar Home Assistant. Si has compartido la dirección por error, elimina HA-MCP Server en Dispositivos y servicios y vuelve a añadirlo; así obtienes una nueva.

¿Puedo usar ChatGPT en su lugar?

Puede que sí, pero no está probado y requiere más que con Claude. ChatGPT solo puede añadir un conector propio con Plus o superior, no con el plan gratuito ni Go. Además hay que activar el Developer mode de ChatGPT en el navegador. Solo funciona con el Camino 1 (Nabu Casa), porque ChatGPT no puede usar el programa de RepairGuyDK del Camino 2. OpenAI también limita lo que ChatGPT puede cambiar a través de un conector así en los planes más baratos. Esta guía está hecha y probada para Claude, que ya funciona con la cuenta gratuita.

¿Basta con Claude gratis?

Para probar, sí. Claude gratis funciona con Home Assistant, y con el Camino 1 puedes añadir un conector personalizado. La versión gratuita tiene un límite de uso cada 5 horas. Las tareas de Home Assistant consumen mucho, porque Claude lee tus dispositivos, automatizaciones y registros. "Apaga la luz del salón" es una tarea pequeña, mientras que "crea un panel" puede gastar casi todo el límite gratuito. Cuando llegas al límite, Claude te pide que esperes. No es un error.

Si quieres usar Claude para crear automatizaciones o paneles, o para instalar cosas como Zigbee2MQTT, te recomendamos Claude Pro, que ofrece al menos 5 veces más uso. Consulta los precios actuales en claude.com/pricing.

Me he pasado a Claude Pro. ¿Tengo que cambiar algo?

No. Si mejoras la misma cuenta de Claude, todo sigue funcionando al momento. Con el Camino 1 la conexión está guardada en tu cuenta de Claude, y con el Camino 2 está en tu PC. Una mejora no cambia ninguna de las dos.

Si en cambio has creado una cuenta nueva de Claude para Pro, con el Camino 1 tienes que volver a añadir el conector como en el paso 5. El Camino 2 sigue funcionando porque va con tu PC. Si quieres, cierra Claude Desktop del todo con Archivo › Salir y vuelve a abrirlo después de la mejora.

¿Puedo deshacerlo?

Sí. Elimina HA-MCP Server en Configuración › Dispositivos y servicios y quita el conector en claude.ai. El programa de RepairGuyDK guarda una copia de seguridad de los ajustes de Claude antes de cambiar nada.

Script y guía creados por RepairGuyDK · Home Assistant, hogar inteligente e IA