Интеграция Claude Code и Home Assistant: как я подключил нейросеть к умному дому через MCP

Использование агентного искусственного интеллекта привлекает тем, что инструмент можно напрямую связать с привычным софтом и сервисами для автоматизации рутины. Я уже интегрировал с Claude Code свой Google Диск и почту Gmail, что позволяет мне быстро проверять календарь, обрабатывать письма и забирать нужную информацию из файлов. Теперь этот список пополнился управлением домашним сервером благодаря протоколу MCP, что открывает совершенно новый уровень взаимодействия с техникой.

Когда речь заходит про интеграцию Claude Code и домашней лаборатории, на помощь приходит экосистема Home Assistant. Платформа имеет встроенный сервер Model Context Protocol, который открывает собственный Assist API. Поскольку все мои устройства уже подключены к серверу, мне не пришлось выстраивать инфраструктуру с нуля — достаточно было задействовать существующую схему для связи с ИИ-агентом.

Встроенный сервер MCP в Home Assistant

Интеграция Model Context Protocol в Home Assistant экспортирует Assist API наружу, делая умный дом доступным для Claude Code. Поскольку протокол является открытым стандартом, его можно задействовать и с другими совместимыми клиентами. Доступный набор инструментов позволяет нейросети получать актуальные данные о состоянии сущностей в доме, а также выполнять базовые действия, вроде включения и выключения света.

Контекст и ограничения Assist API

Вместе с командами Home Assistant передает модели контекст окружения, благодаря чему ИИ понимает текущую обстановку при обработке запросов. Кроме того, в качестве вызываемых инструментов можно выставлять заранее созданные скрипты, что дает агенту доступ к сложным сценариям, задействующим сразу несколько приборов.

Тем не менее, встроенный Assist API имеет четкие ограничения. Он не предоставляет ИИ полноценного административного доступа к Home Assistant. Это значит, что создавать новые интеграции или редактировать YAML-файлы автоматизации через него не выйдет — для этого потребуется отдельное соединение. Запуск готового скрипта и его полная перезапись с нуля решаются по-разному, и текущая встроенная интеграция отвечает именно за первый сценарий.

Способы подключения на сервере

Если вы запускаете на домашнем сервере стороннее приложение, вам понадобится отдельная служба MCP, которая экспортирует нужные функции для агента. Claude Code отлично поддерживает подключение к обычному HTTP-эндпоинту, именно так и работает официальный модуль Home Assistant. Альтернативным методом является запуск стандартного MCP-процесса (stdio) непосредственно на самом сервере через защищенное SSH-соединение.

Настройка доступа для Claude Code

Процесс подготовки самой платформы Home Assistant предельно прост: мне потребовалось зайти в раздел «Настройки», открыть пункт «Устройства и службы», а затем нажать кнопку добавления интеграции. После поиска Model Context Protocol Server я активировал тумблер управления системой. Следующим шагом стал переход в меню голосовых помощников, где во вкладке экспорта я выбрал конкретные сущности для взаимодействия — на первом этапе я решил ограничиться парой лампочек, а не открывать доступ ко всем приборам сразу.

Авторизация и добавление токена

Для безопасной связи с Claude Code также требуется настроить аутентификацию. Я открыл свой профиль пользователя в Home Assistant, перешел на вкладку безопасности и сгенерировал долгосрочный токен доступа (Long-Lived Access Token). Присвоив ему понятное имя вроде «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 оказалась невероятно практичной, особенно когда у меня уже открыт рабочий чат по какому-то проекту. Вместо того чтобы переключаться на дашборд умного дома, я могу просто написать агенту: «Выключи свет внизу, но оставь включенным в ванной». Искусственный интеллект самостоятельно определяет, какие именно устройства задействовать, и выполняет индивидуальные команды.

Доступно не только исполнение приказов, но и предварительная проверка статуса. Например, запрос в стиле «проверь, какие светильники сейчас активны на первом этаже, и погаси их» успешно совмещает получение информации и управляющее действие. А поскольку контекст диалога сохраняется, я могу в любой момент уточнить результат выполнения или скорректировать изначальную задачу.

Использование готовых скриптов и автоматизаций

Мой привычный сценарий отхода ко сну отлично демонстрирует, как в эту систему вписываются пользовательские скрипты. Я уже давно использую связку Home Assistant и Node-RED для выключения телевизора, регулировки термостата, постановки дома на охрану и приглушения света в ванной на несколько минут. Теперь я могу экспортировать этот скрипт как инструмент для Claude Code.

Таким образом, логика таймингов и последовательность действий по-прежнему жестко заданы на стороне сервера, а у ИИ появляется лишь удобная возможность запустить этот сценарий по текстовой реплике из чата. При этом я продолжаю полагаться на штатные автоматизации Home Assistant в вопросах регулярных расписаний и триггеров от датчиков. Подключение MCP дает агенту полезные инструменты для текущих задач, но не заменяет собой фоновые службы мониторинга.