Использование агентских ИИ-систем позволяет автоматизировать выполнение различных задач, подключая их к уже имеющимся инструментам. Ранее агент Claude Code уже использовался для работы с почтой Gmail, файлами на Google Drive и планированием событий в календаре. Теперь эти возможности расширены за счет интеграции с домашним сервером под управлением Home Assistant, что дает ИИ-агенту прямой доступ к управлению устройствами умного дома.
Интеграция через протокол Model Context Protocol
Home Assistant имеет встроенную поддержку сервера Model Context Protocol (MCP), который позволяет транслировать API помощника (Assist API) напрямую в Claude Code. Поскольку платформа построена на открытом стандарте MCP, подобная интеграция совместима и с другими клиентами, поддерживающими данный протокол. Инструменты позволяют Claude получать информацию о доступных объектах и выполнять команды, например, включать или выключать освещение. Кроме того, Home Assistant предоставляет контекст об этих устройствах, что помогает ИИ корректнее обрабатывать запросы.
Также существует возможность выставлять существующие скрипты в качестве вызываемых инструментов. Это дает агенту доступ к сложным сценариям, задействующим несколько устройств одновременно. Однако встроенный Assist API имеет ограничения: он не предоставляет Claude административный доступ к настройкам Home Assistant. Для изменения конфигурации автоматизации в YAML-файлах или создания интеграций потребуется отдельное подключение. Интеграция в текущем виде предназначена в первую очередь для запуска уже готовых скриптов.
Настройка связи между Claude Code и Home Assistant
Для настройки взаимодействия внутри Home Assistant необходимо перейти в раздел Settings -> Devices & services, выбрать пункт «Добавить интеграцию» (Add integration) и найти Model Context Protocol Server. После активации управления Home Assistant нужно перейти в Settings -> Voice assistants -> Expose. В этом разделе следует выбрать конкретные устройства, к которым Claude получит доступ. Рекомендуется начинать с малого количества объектов, чтобы не открывать доступ ко всем домашним системам сразу.
Для аутентификации в Home Assistant потребуется создать долгоживущий токен доступа. Это делается в профиле пользователя во вкладке «Безопасность» (Security). После генерации токена с понятным названием, например «Claude Code», необходимо зарегистрировать соединение в терминале вашего компьютера:
claude mcp add —transport http —scope user home-assistant http://HOME_ASSISTANT_IP:8123/api/mcp —header «Authorization: Bearer YOUR_TOKEN»
После завершения настройки запустите новую сессию Claude Code и введите команду /mcp, чтобы убедиться, что Home Assistant отображается в списке подключенных служб. Теперь можно проверить работоспособность, попросив ИИ уточнить статус любого из добавленных устройств.
Управление домом в процессе работы с ИИ
Наличие Home Assistant внутри Claude Code особенно удобно, когда открыта рабочая сессия для других задач. Вместо переключения между окнами можно попросить агента изменить настройки освещения, используя естественный язык. Claude самостоятельно определяет, какие устройства необходимо задействовать для выполнения запроса. ИИ также может объединять проверку состояния системы с последующим действием.
Использование существующих скриптов позволяет запускать сложные сценарии одним коротким запросом. Например, если у вас уже настроен алгоритм «отхода ко сну» (выключение телевизора, регулировка термостата, активация охраны), его можно представить как инструмент для Claude. Это сохраняет логику выполнения действий в Home Assistant, но делегирует запуск агенту. Важно отметить, что основная система автоматизации и дальше выполняет роль планировщика для событий, привязанных к расписанию или датчикам, тогда как Claude выступает в качестве интерфейса для оперативного ручного управления в рамках прямого диалога.
Расширенные возможности подключения и технические нюансы
Помимо использования HTTP-эндпоинта, который обеспечивает работу интеграции с Home Assistant, Claude Code поддерживает и другие способы взаимодействия. Если вы используете на домашнем сервере дополнительные приложения, требующие интеграции с агентом, можно задействовать MCP-службы, открывающие доступ к конкретным функциям. В качестве альтернативного метода подключения предусмотрен запуск stdio MCP-процесса на сервере через SSH, что расширяет возможности развертывания системы в зависимости от архитектуры вашей домашней сети.
Важно понимать разницу в полномочиях: хотя Claude Code получает широкие права на выполнение команд, он не превращается в полноценного администратора системы. Встроенный Assist API жестко разграничивает возможности: агент может запустить уже созданный скрипт, но не способен его переписать или изменить конфигурационные файлы YAML. Это своего рода «песочница», которая обеспечивает безопасность вашего умного дома, позволяя агенту управлять исполнением, но не позволяя вмешиваться в системную архитектуру.
«Я могу попросить его вызвать сообщения, требующие ответа, или проверить предстоящие события через подключенный календарь — это полезные дополнения к инструменту, который я раньше использовал в основном только для написания кода», — отмечают пользователи, уже внедрившие подобные агентские связки. Интеграция с Home Assistant органично вписывается в этот рабочий процесс, позволяя переключаться между написанием кода и управлением физическим пространством, не выходя из консоли.
Практические примеры использования в диалоге
Одним из ключевых преимуществ такой интеграции является контекстное взаимодействие. Claude Code «понимает» естественные запросы, требующие комплексного анализа состояния системы. Например, команда «выключи свет на первом этаже, но оставь включенным свет в ванной» заставляет агента самостоятельно определить, какие именно устройства подпадают под эти критерии, и последовательно отправить соответствующие команды. Возможность объединять получение информации с действием — например, запрос «проверь, какой свет включен внизу, и выключи его» — избавляет от необходимости совершать несколько итераций действий вручную.
Сценарии автоматизации, такие как «отход ко сну», наглядно демонстрируют синергию:
- Выключение телевизора и акустических систем.
- Корректировка настроек термостата.
- Постановка системы на охрану.
- Установка яркости освещения в ванной на минимальный уровень на 5–10 минут.
Все эти действия остаются прописанными в Home Assistant и Node-RED, что гарантирует стабильность выполнения рутинных задач, а агент выступает в роли удобного интерфейса для запуска этих процедур по голосовой или текстовой команде. Claude Code не заменяет собой 24/7 мониторинг системы датчиками, а лишь дополняет его, предоставляя пользователю возможность управлять умным домом прямо в процессе работы над программными проектами.
