# UniFi Gateway

Подключает агента к контроллеру UniFi: читает сеть, камеры и точки доступа, а перед любым изменением показывает план. Полезно, когда править VLAN или firewall руками лень, но страшно.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 26
- Автор: pete-builds
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pete-builds/mcp-unifi
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/unifi-gateway

## Что делает

Сервер даёт агенту инструменты для UniFi Network: устройства, радио на точках доступа, VLAN и WLAN, firewall, порты коммутатора, проброс портов, DHCP-резервации, Threat Management, Honeypot и Teleport VPN. Отдельно включаются Protect (камеры, события движения, запись) и Access (двери, пропуска, посетители, события бейджей). Параметр `controller` позволяет одному процессу вести несколько площадок сразу.

Защита встроена в саму конструкцию. У каждого разрушительного инструмента есть `dry_run=True`: ответ вернёт предсказанный набор изменений и ничего не запишет. Составные операции вроде `create_iot_network` или `provision_camera` запоминают состояние до запуска и откатывают уже применённые шаги, если что-то сорвалось посередине. Все вызовы попадают в журнал JSONL с вычищенными секретами, а CLI `mcp-unifi-replay` умеет повторить его на чистом контроллере. Режим `MCP_UNIFI_READONLY=true` скрывает изменяющие инструменты из списка и отклоняет вызов по имени.

Нужен локальный API-ключ из Settings → Control Plane → Integrations, облачная учётная запись не требуется. Контроллер должен быть на UniFi Network 9.x или новее. Ставится четырьмя путями: Docker с Streamable HTTP на порту `3714`, готовый `.dxt` для Claude Desktop, Helm-чарт или `uvx`. По HTTP сервер не стартует без bearer-токена, поэтому токен придётся задать заранее.

## Требования
- Нужно: Docker
- Переменные окружения: `STUB_MODE`, `UNIFI_HOST`, `UNIFI_API_KEY`, `UNIFI_SITE`, `UNIFI_VERIFY_SSL`, `MCP_UNIFI_CONTROLLERS_FILE`, `MCP_UNIFI_MODULES_ENABLED`, `UNIFI_ACCESS_HOST`, `UNIFI_ACCESS_API_KEY`, `UNIFI_ACCESS_PORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- посмотреть, что реально изменится в firewall до применения правила
- завести гостевую сеть и откатить шаги, если провижининг сорвался
- найти открытые порты сразу в старых правилах и в Zone-Based Firewall
- проверить, какие камеры и события движения есть на площадке
- повторить серию вызовов на другом контроллере из журнала

## Примеры запросов агенту
- Покажи список VLAN на контроллере `home` и не меняй ничего
- Создай гостевую сеть через `create_guest_network`, сначала с `dry_run=True`
- Проверь открытые порты на площадке `office` и приложи отчёт

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

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