Resumen
Deja que tu IA lea tu Home Assistant: el estado actual de cada sensor, luz, puerta y termostato, el historial registrado, el registro de eventos de qué pasó y cuándo, y tus calendarios. Solo lectura: nunca controla dispositivos. Funciona con Home Assistant autoalojado.
Configuración guiada
Conecta Home Assistant a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Home Assistant con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Home Assistant
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Home Assistant, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Home Assistant + Microsoft Copilot
Deja que tu IA lea tu Home Assistant: el estado actual de cada sensor, luz, puerta y termostato, el historial registrado, el registro de eventos de qué pasó y cuándo, y tus calendarios. Solo lectura: nunca controla dispositivos. Funciona con Home Assistant autoalojado.
Requisitos previos
Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:
HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN
Paso 1 — Obtén las credenciales
La configuración lleva unos 3 minutos. Necesitas una instancia de Home Assistant a la que AnythingMCP pueda acceder y un token de acceso de larga duración, idealmente de un usuario dedicado sin permisos de administrador.
- Establece
HOME_ASSISTANT_URLcon la dirección desde la que abres Home Assistant, sin barra final y sin/api, por ejemplohttps://home.example.comohttp://192.168.1.10:8123(el puerto por defecto es 8123). - Recomendado: crea un usuario de Home Assistant dedicado para AnythingMCP en Ajustes → Personas → Usuarios → Añadir usuario, con Administrador desactivado. Ninguno de los endpoints que usa el conector necesita permisos de administrador.
- Inicia sesión con ese usuario y haz clic en tu nombre, abajo a la izquierda, para abrir tu perfil. Abre la pestaña Seguridad y, en Tokens de acceso de larga duración, haz clic en Crear token. Copia el token (se muestra una sola vez y sigue siendo válido durante 10 años) y pégalo en
HOME_ASSISTANT_TOKEN, sin la palabra Bearer. - Instala el conector y ejecuta
home_assistant_get_config: devuelve la versión, el nombre de la ubicación y la zona horaria, y confirma que la dirección y el token funcionan.
Qué lee: el estado actual de cada entidad (sensores, luces, clima, puertas, presencia) con sus atributos, el historial registrado de valores durante un periodo, el registro de eventos de qué pasó y cuándo (por ejemplo, cuándo se abrió por última vez la puerta del garaje), tus calendarios y sus eventos, y la configuración de la instancia. Los identificadores de entidad tienen un aspecto como sensor.living_room_temperature o binary_sensor.garage_door.
Solo lectura: todas las herramientas son peticiones GET. El conector no puede llamar a acciones (servicios), encender ni apagar nada, abrir cerraduras, ejecutar scripts ni cambiar estados. El endpoint de acciones de Home Assistant no es exclusivo de administradores, así que esta garantía proviene de que el conector expone únicamente lecturas, no del token.
Dónde se ejecuta Home Assistant: en un AnythingMCP autoalojado, una instancia en una red privada (http://192.168.x.x:8123, homeassistant.local) requiere que un administrador permita el host en SSRF_ALLOWED_HOSTS o en la lista de permitidos de los ajustes de administración. AnythingMCP Cloud solo puede acceder a una instancia expuesta a internet público mediante HTTPS, por ejemplo detrás de un proxy inverso o con el acceso remoto de Home Assistant Cloud.
Privacidad: los datos del hogar revelan quién está en casa y las rutinas diarias de la familia. Asigna el conector solo a servidores MCP cuyos usuarios puedan ver estos datos.
Horas: las marcas de tiempo se envían en formato ISO 8601 en UTC con el sufijo Z, por ejemplo 2026-10-01T00:00:00Z. home_assistant_get_config devuelve la zona horaria del hogar para presentar los resultados.
Errores comunes: 401 significa que el token es incorrecto o se ha eliminado. 404 en una entidad o en los eventos de su calendario significa que ninguna entidad tiene ese identificador; 404 en todas las llamadas significa que HOME_ASSISTANT_URL es incorrecta o ya termina en /api. 400 en los eventos del calendario significa que falta start o end, o que no es una marca de tiempo válida. Una conexión rechazada o bloqueada significa que el host no está permitido en la lista de permitidos de SSRF (autoalojado) o que no es público mediante HTTPS (Cloud).
El conector no llama a acciones ni servicios, no escribe ni elimina estados, no dispara eventos, no renderiza plantillas, no muestra imágenes de cámaras ni lee el flujo de eventos, el registro de errores o la API WebSocket (áreas, dispositivos, registro de entidades).
Paso 2 — Instala el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añade el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Home Assistant. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
home_assistant_get_config | Obtiene la configuración de Home Assistant: versión, nombre de la ubicación, zona horaria, sistema de unidades, coordenadas y componentes cargados |
home_assistant_list_states | Lista todas las entidades que el token puede leer, resumidas en entity_id, estado, nombre descriptivo, unidad y last_changed |
home_assistant_get_state | Obtiene el estado actual de una entidad con todos sus atributos, last_changed y last_updated, p. ej. la temperatura objetivo de un termostato o… |
home_assistant_get_history | Obtiene los cambios de estado registrados de una o varias entidades durante un periodo, p. ej. la temperatura del salón durante la noche |
home_assistant_get_logbook | Obtiene las entradas del registro de eventos desde una hora de inicio: eventos legibles como la apertura de una puerta, el encendido de una luz o la llegada de una persona a casa, con… |
home_assistant_list_calendars | Lista las entidades de calendario de esta instancia de Home Assistant (entity_id y nombre, p. ej. calendar.family) |
home_assistant_get_calendar_events | Obtiene los eventos de un calendario entre start y end: resumen, inicio, fin, descripción y ubicación |
Preguntas frecuentes
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?