Home Assistant·homeassistant-ai

Home Assistant MCP — подключение и инструкция

HA-MCP подключает ИИ-агента к Home Assistant для чтения состояния дома и разрешённого управления сущностями и автоматизациями.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

HA-MCP подключает ИИ-агента к Home Assistant для чтения состояния дома и разрешённого управления сущностями и автоматизациями.

02

Это community-проект homeassistant-ai, не просто включение встроенного official MCP integration.

03

Прочитай состояние одной безопасной тестовой сущности.

Задача для знакомства

Через HA-MCP прочитай состояние выбранного тестового датчика. Устройства и автоматизации не меняй.

Уточнить результат

Сверь entity ID, область дома и фактический эффект. Статус MCP success не доказывает, что физическое устройство выполнило команду; проверь state и доступность интеграции.

Как подключить

Выберите подходящий способ

Подключить Home Assistant MCP

Открой Setup Wizard проекта и выбери тип Home Assistant и MCP-клиент. Настрой URL и доступы, получи точную конфигурацию HTTP-сервера. Не публикуй secret URL; OIDC-режим настраивается отдельно и может использовать общие HA credentials для пользователей.

Что понадобится

  • Рабочий Home Assistant, доступные сущности и token/другой выбранный способ авторизации. Для внешнего запуска нужны Docker или окружение из Setup Wizard.
  1. 01

    Подготовь окружение

    Рабочий Home Assistant, доступные сущности и token/другой выбранный способ авторизации. Для внешнего запуска нужны Docker или окружение из Setup Wizard.

  2. 02

    Установи и настрой

    Открой Setup Wizard проекта и выбери тип Home Assistant и MCP-клиент. Настрой URL и доступы, получи точную конфигурацию HTTP-сервера. Не публикуй secret URL; OIDC-режим настраивается отдельно и может использовать общие HA credentials для пользователей.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Через HA-MCP прочитай состояние выбранного тестового датчика. Устройства и автоматизации не меняй.

Как проверить

Сверь entity ID, область дома и фактический эффект. Статус MCP success не доказывает, что физическое устройство выполнило команду; проверь state и доступность интеграции.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Home Assistant

HA-MCP подключает ИИ-агента к Home Assistant для чтения состояния дома и разрешённого управления сущностями и автоматизациями.

Это community-проект homeassistant-ai, не просто включение встроенного official MCP integration. README рекомендует setup wizard и HTTP-варианты; stdio имеет известные transport-ограничения.

Что подготовить перед подключением

Рабочий Home Assistant, доступные сущности и token/другой выбранный способ авторизации. Для внешнего запуска нужны Docker или окружение из Setup Wizard.

Как установить и подключить

Открой Setup Wizard проекта и выбери тип Home Assistant и MCP-клиент. Настрой URL и доступы, получи точную конфигурацию HTTP-сервера. Не публикуй secret URL; OIDC-режим настраивается отдельно и может использовать общие HA credentials для пользователей.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай состояние одной безопасной тестовой сущности. Затем задай конкретное действие и проверь реальное устройство и новое состояние. Автоматизацию сначала просмотри как проект изменения.

Как проверить результат и решить проблемы

Сверь entity ID, область дома и фактический эффект. Статус MCP success не доказывает, что физическое устройство выполнило команду; проверь state и доступность интеграции.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Управление может воздействовать на реальное оборудование. Доступность beta-инструментов и права токена отличаются; не включай все функции только ради первого подключения.

Исходники и документация

Репозиторий: homeassistant-ai/ha-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Home Assistant

HA-MCP подключает ИИ-агента к Home Assistant для чтения состояния дома и разрешённого управления сущностями и автоматизациями.
Вернуться в библиотеку