Instale « MCP Server for Xiaozhi » en Home Assistant (HA) mediante HACS y después añada la integración del mismo nombre. Según el artículo original, este paso ya viene configurado en los equipos HAIOTS enviados después de abril de 2026.
Paso 1: obtener la dirección del punto de acceso MCP de Xiaozhi
El dispositivo Xiaozhi necesita una dirección para comunicarse con HA. Inicie sesión en la consola oficial de Xiaozhi (normalmente xiaozhi.me; si aloja el servicio por su cuenta, use la dirección de su propia consola). En la lista de dispositivos, busque su ESP Xiaozhi y pulse « Configurar ».
Busque la sección « MCP Setting » y pulse « Get MCP Endpoint ». Copie la dirección generada, que normalmente empieza por wss://.
Paso 2: configurar la integración MCP de Xiaozhi en HA
En Home Assistant, abra « Ajustes » → « Dispositivos y servicios » → « Añadir integración ». Busque « MCP » o « Xiaozhi » y seleccione « MCP Server for Xiaozhi ». Pegue la dirección del punto de acceso MCP que copió en el paso anterior.
Si aparece la opción « llm_hass_api », actívela. Esta función de HA permite que Xiaozhi controle los dispositivos que usted haya autorizado. También puede seleccionar otros MCP si lo necesita. Confirme con « Enviar » o « Finalizar ».
Espere aproximadamente un minuto. Vuelva a « MCP Setting » en la consola de Xiaozhi, actualice la página y compruebe que el estado sea « Connected ».
Paso 3: exponer dispositivos HA a Xiaozhi
Por seguridad, HA no comparte automáticamente todos los dispositivos con los asistentes de voz. Abra « Ajustes » → « Asistentes de voz » → « Exponer ». Seleccione los dispositivos que Xiaozhi podrá controlar, como luces, interruptores, aires acondicionados, ventiladores o sensores. Para la primera prueba, elija solo una o dos luces y añada los demás dispositivos cuando funcione correctamente.
Paso 4: probar los comandos de voz y solucionar problemas
Pruebe una orden como « Xiaozhi, enciende la luz del estudio » y una consulta como « Xiaozhi, ¿qué temperatura hay ahora en el salón? ».
Si Xiaozhi no responde o responde de forma inesperada, consulte el historial de conversación en su consola: ¿entendió la orden e intentó llamar a la herramienta Home Assistant (Function Call)? Si hay conflictos con la música o la pantalla, use una orden más precisa, como « Enciende el plafón del salón a través del hogar inteligente ».
Si la orden llegó a HA pero el dispositivo no responde, abra « Ajustes » → « Sistema » → « Registros » y busque errores de la integración MCP.
