UniFi Gateway — MCP-сервер для Claude Code: Network, Protect, Access
Подключает агента к контроллеру UniFi: читает сеть, камеры и точки доступа, а перед любым изменением показывает план. Полезно, когда править VLAN или firewall руками лень, но страшно.
Открыть на GitHubЧто делает 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-токена, поэтому токен придётся задать заранее.
Какие задачи решает
- посмотреть, что реально изменится в firewall до применения правила
- завести гостевую сеть и откатить шаги, если провижининг сорвался
- найти открытые порты сразу в старых правилах и в Zone-Based Firewall
- проверить, какие камеры и события движения есть на площадке
- повторить серию вызовов на другом контроллере из журнала
Примеры запросов агенту
- Покажи список VLAN на контроллере
homeи не меняй ничего - Создай гостевую сеть через
create_guest_network, сначала сdry_run=True - Проверь открытые порты на площадке
officeи приложи отчёт
Как установить UniFi Gateway
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о UniFi Gateway
Как установить UniFi Gateway в Claude Code?
Готовой команды для Claude нет. Запускайте через uvx --from git+https://github.com/pete-builds/mcp-unifi mcp-unifi (транспорт stdio) либо поднимайте контейнер с Streamable HTTP на порту 3714 и прописывайте его в конфигурации MCP.
Что делает UniFi Gateway?
Даёт агенту инструменты управления UniFi Network, Protect и Access с обязательным предохранителем: разрушительные вызовы принимают dry_run=True, составные операции откатываются при частичном сбое, всё пишется в журнал.
Что нужно, чтобы сервер заработал?
Локальный API-ключ из Settings → Control Plane → Integrations и контроллер на UniFi Network 9.x или новее. Для HTTP-транспорта дополнительно нужен bearer-токен, без него сервер не запустится.
