Подключение к Claude Code

Те же инструменты можно использовать в своём Claude Code в терминале:

• «что включено в спальне?»
• «добавь новый датчик протечки в ванную»
• «почему мост Zigbee молчит?»
• «поставь таймер на 20 минут»

Одной кнопкой

Настройки → Колонка → Мозги Хомера → Подключить к Claude Code.

Подключение ставит сама колонка, на своём компьютере и от своего пользователя Windows. Поэтому сервер попадает именно в тот Claude Code, в который вы вошли на этом компьютере.

Что происходит:

1. Сервер регистрируется на уровне пользователя, то есть доступен во всех проектах:

   claude mcp add homer -s user -e PYTHONIOENCODING=utf-8 -- python tools\speaker\homer_mcp.py

2. В ~/.claude/skills/ раскладываются навыки:
   • homer-house — общие правила работы с домом: сначала смотреть, потом действовать; как добавить Zigbee-устройство; где документация;
   • homer-<название> — по одному на каждый ваш навык.
3. В журнал уходит запись «подключил MCP homer к Claude Code».

Кнопки в карточке:

Кнопка	Что делает
Подключить к Claude Code	Регистрирует сервер и раскладывает навыки
Обновить навыки	Переписывает навыки заново после правок
Отключить	Убирает сервер и все навыки homer-*

Проверить в терминале:

claude mcp get homer

Должно быть Status: ✔ Connected.

Вручную, на другом компьютере

1. Скопируйте папку tools/speaker и файл secrets/ha-credentials.txt с токеном Home Assistant (строка token=…).
2. Поставьте пакеты:

   pip install mcp paho-mqtt websocket-client yandex-music

3. Зарегистрируйте сервер, подставив адреса своего дома:

   claude mcp add homer -s user ^
     -e HOMER_HA=http://<дом>:8123 ^
     -e HOMER_MQTT=<дом> ^
     -e HOMER_SIDECAR=http://<дом>:8730 ^
     -e HOMER_SPEAKER_URL=http://<компьютер с колонкой>:8790 ^
     -- python C:\путь\tools\speaker\homer_mcp.py

4. Проверьте: claude mcp get homer.

Переменная	По умолчанию	Что это
HOMER_HA	http://127.0.0.1:8123	Home Assistant
HOMER_MQTT	127.0.0.1	MQTT-брокер моста Zigbee (порт HOMER_MQTT_PORT, 1883)
HOMER_SIDECAR	http://127.0.0.1:8730	Сервер дома: настройки, журнал
HOMER_SPEAKER_URL	http://127.0.0.1:8790	Колонка: музыка, таймеры, say
HOMER_MCP_LEVEL	full	Уровень: full (Claude Code), opus, voice

Без ключа колонки

Если рядом нет файла secrets/alice-skill-key.txt, сервер работает со всеми инструментами уровня «Claude Code» по умолчанию, но не пишет журнал и не знает ваших настроек и навыков.

Что видно в журнале

Каждый вызов опасного инструмента из Claude Code попадает в Telegram с пометкой, кто вызвал:

🔧 Claude Code (varyen@VARYEN-PC): zigbee_pair(seconds=120, wait=True)
→ 0xa4c138…: готово: Tuya TS0505B

Дом с нуля

Claude Code с сервером homer заводит новый дом целиком. Достаточно попросить: «подними дом на http://192.168.1.10:8123, HA только что поставлен».

1. ha_onboard проходит экран «Добро пожаловать» свежего Home Assistant: заводит владельца-админа, место, язык и часовой пояс, выпускает долгоживущий токен. Логин, пароль и токен ложатся в secrets/ha-credentials.txt (или в файл credentials_file). Уже заведённый HA инструмент не трогает. HA уже работает — токен кладёт человек строкой token=… в тот же файл, а ha_connect его проверяет.
2. ha_flow добавляет интеграции: mqtt, Zigbee, yandex_station и любые другие, шаг за шагом по полям мастера HA. Что HA нашёл в сети сам, показывает ha_integrations.
3. ha_area заводит комнаты и этажи, ha_device_update раскладывает по ним устройства.
4. homer_connect подключает сервер к серверу дома Homer владельцем. Для этого в HA заводится отдельный админ «Homer MCP», и ключ владельца выдаётся ему. Поэтому ваш ключ владельца не перевыпускается. Владельцы дома получают уведомление. Новому дому, у которого ещё нет токена HA, homer_connect сразу выдаёт и его. Если «Homer MCP» стал первым владельцем, станьте владельцем сами в приложении: Настройки → Доступ → Сайдкар дома → Стать владельцем.
5. plan_add расставляет вещи по плану, homer_invite выдаёт приглашения телефонам и планшетам. Код ложится в secrets/homer-invite.txt.

Доступ сервера к Homer хранится в secrets/homer-sidecar.txt. Чтобы его отозвать, удалите доступ «Homer MCP» в Доступ → Доступы и пользователя «Homer MCP» в HA.