# mcp-hass

Скилл подключает агента к Home Assistant по MCP: включает свет, вентилятор, читает состояния устройств. Нужен, когда умный дом хочется дёргать прямо из чата.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3100 установок · ★ 164
- Автор: aahl
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/aahl/skills/tree/HEAD/skills/mcp-hass/SKILL.md
- Обновлён: 2026-09-15
- HTML: https://affpapa.org/nevibecode/skills/mcp-hass

## Что делает

Скилл даёт агенту доступ к вашему Home Assistant через MCP-сервер. Он умеет читать текущие состояния и переключать устройства: свет, вентилятор, целые области по имени. Команды уходят через `mcporter` — утилиту для вызова MCP-инструментов из терминала.

Перед первым запуском включите MCP-сервер в самом Home Assistant: Settings > Devices & services, кнопка добавления интеграции, в списке — Model Context Protocol. Дальше нужны переменные окружения `HASS_BASE_URL` и `HASS_ACCESS_TOKEN`. Если агент скажет, что MCP-сервер не найден, значит конфигурация не добавлена — вот тут скилл и напомнит про эти две переменные.

Конфигурация ставится одной командой `npx -y mcporter config add home-assistant` с транспортом http и заголовком авторизации. Без токена доступа ничего не заработает, потому что Home Assistant отклонит запрос. Полный список параметров каждого инструмента смотрите через `npx -y mcporter list home-assistant --schema --all-parameters`.

## Требования
- Работает с: Home Assistant

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aahl/skills --skill mcp-hass -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/mcp-hass/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/mcp-hass/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aahl/skills --skill mcp-hass -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/mcp-hass/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aahl/skills --skill mcp-hass -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/mcp-hass/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aahl/skills mcp-hass
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/mcp-hass/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aahl/skills --skill mcp-hass -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aahl/skills --path skills/mcp-hass
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/mcp-hass/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aahl/skills --skill mcp-hass -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aahl/skills/tree/HEAD/skills/mcp-hass/SKILL.md

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

## Примеры запросов агенту
- включи свет в спальне
- какая сейчас температура в гостиной?
- выключи все лампы в комнате Bedroom

## Похожие
- [home-assistant-best-practices](https://affpapa.org/nevibecode/skills/home-assistant-best-practices.md) — скилл · 8600 установок
- [Home Assistant Automation](https://affpapa.org/nevibecode/skills/home-assistant-automation.md) — скилл · 4900 установок
- [ha-mcp](https://affpapa.org/nevibecode/mcp/ha-mcp.md) — MCP-сервер · ★ 5195
- [embedded-iot-mentor](https://affpapa.org/nevibecode/skills/embedded-iot-mentor.md) — скилл · 22 установки
- [exa-web-search-free](https://affpapa.org/nevibecode/skills/exa-web-search-free.md) — скилл · 2800 установок
- [sonoscli](https://affpapa.org/nevibecode/skills/sonoscli.md) — скилл · 5300 установок

Из того же набора: [aahl/skills](https://affpapa.org/nevibecode/by/aahl/skills.md) — 8 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md