HA-MCP: управляйте умным домом через Claude и ChatGPT
HA-MCP позволяет подключить Claude, ChatGPT и другие AI-ассистенты к Home Assistant для управления умным домом через MCP.
Умный дом под управлением AI: HA-MCP упрощает интеграцию
HA-MCP — проект, который позволяет устанавливать MCP-сервер (Model Context Protocol) прямо в Home Assistant через HACS и запускать его внутри самой системы. Он совместим со всеми типами установки: Home Assistant OS, Supervised, Container и Core. Теперь с выходом Home Assistant 2026.11 установка стала ещё проще — через встроенный Marketplace.
MCP (Model Context Protocol) — открытый протокол, который позволяет AI-моделям вроде Claude или ChatGPT взаимодействовать с внешними сервисами и устройствами.
Что такое HA-MCP и зачем он нужен
Home Assistant 2026.10 интегрировал MCP прямо в платформу, открыв возможность превратить весь умный дом в единый контекст для любого AI-агента. HA-MCP идёт дальше: он расширяет встроенные возможности, добавляя поддержку редактирования конфигураций, тем, резервных копий и продвинутой автоматизации.
MCP — это мост, позволяющий таким моделям, как Claude, ChatGPT или Cursor, общаться с локальными устройствами. Благодаря этому Home Assistant открывает доступ к более чем 2000 встроенным интеграциям для AI-агентов.
Для сравнения: Google продвигает собственную платформу Home MCP как платную подписку стоимостью $20 в месяц — только чтобы AI мог взаимодействовать с вашим домом. HA-MCP — полностью бесплатный и открытый.
Home Assistant 2026.11: HACS стал Marketplace
Home Assistant 2026.11 вышел 4 ноября 2026 года. Главное изменение — HACS превратился во встроенный Marketplace, добавились exclude targets для автоматизаций и пересмотрены имена сущностей.
Начиная с Home Assistant 2026.11, HACS (Home Assistant Community Store) встроен прямо в систему и теперь называется Marketplace — его можно найти в разделе Settings → Marketplace.
Миграция происходит автоматически: при обновлении все загруженные через HACS материалы — интеграции, карточки, темы — переходят в Marketplace без каких-либо ручных действий.
Как установить HA-MCP
Интеграция требует Home Assistant 2026.8.0 или новее. На версиях 2026.8–2026.10 нужно открыть HACS, найти HA-MCP и нажать Download. На 2026.11 и новее — открыть Settings → Marketplace, принять предупреждение при первом запуске и найти HA-MCP.
graph TD
A[Home Assistant 2026.11+] --> B[Settings → Marketplace]
B --> C[Поиск: HA-MCP]
C --> D[Install]
D --> E[Restart Home Assistant]
E --> F[Settings → Devices & Services]
F --> G[Add Integration → HA-MCP Server]
G --> H[Вставить токен / логин]
H --> I[Скопировать URL]
I --> J[Вставить в AI-клиент]
J --> K[✅ Готово!]
Настройка доступа
После установки нужно выбрать способ авторизации сервера:
- Long-lived access token (долгосрочный токен доступа) — создаётся в профиле пользователя в разделе Security.
- Отдельный аккаунт для HA-MCP — более безопасный вариант: создать отдельного пользователя с правами администратора только для локального доступа.
Способы подключения
| Метод | Тип установки | Сложность | Рекомендуется |
|---|---|---|---|
| HA-MCP Custom Component (Marketplace) | Все типы | ⭐ Просто | ✅ Да |
| App / Add-on | OS, Supervised | ⭐⭐ Средне | Для опытных |
| Docker (HTTP-сервер) | Container, Core | ⭐⭐⭐ Сложнее | При необходимости |
| PyPI / uvx | Любой хост | ⭐⭐⭐ Сложнее | При необходимости |
| stdio (локально) | Любой | ⭐⭐⭐⭐ Не рекоменд. | ❌ Только тест |
Удалённый доступ
Для подключения AI-клиентов извне локальной сети доступны несколько вариантов:
- Nabu Casa — облачный сервис Home Assistant для безопасного туннеля.
- Webhook через компонент — HA-MCP автоматически регистрирует webhook-URL вида
https://<ваш-домен>/api/webhook/<id>. - Прямой порт в локальной сети — сервер доступен по адресу
http://<ha-ip>:9584/private_<random>.
Home Assistant 2026.11 добавил собственный администраторский API с инструментами для работы с логами, историей, шаблонами и системной информацией. А с версии 2026.10 в разделе Settings → System → AI появился собственный MCP-сервер платформы.
Что умеет HA-MCP: панель управления
Пока сервер работает, в боковой панели Home Assistant появляется раздел HA-MCP (только для администраторов), где можно:
- Управлять доступными AI-инструментами
- Включать/отключать экспериментальные функции (feature flags)
- Создавать резервные копии
- Менять темы оформления
Контекст: зачем это важно
Пользователи больше не привязаны к конкретным AI-возможностям производителя устройств. Если вам нравится логика рассуждений Claude, теперь можно направить его прямо на ваш дом. По сути, дом превращается в API, по которому AI ориентируется, а не в набор разрозненных гаджетов.
HA-MCP — одно из ключевых сообщественных решений, которое делает умный дом действительно умным: без подписок, без привязки к вендору, с полным контролем у пользователя.