UniFi Network MCP — MCP-сервер для Claude Code: установка
MCP-сервер даёт ИИ-агенту инструменты для управления UniFi Network: клиентами, устройствами, VLAN, VPN и правилами firewall. Подходит для аудита и изменений сети.
claude mcp add --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_PORT=<UNIFI_PORT> --transport stdio network -- uvx unifi-network-mcpЧто делает UniFi Network MCP
UniFi Network MCP подключает к ИИ-ассистенту 210 инструментов UniFi Network. Через него можно запрашивать клиентов, устройства, правила firewall, VLAN, VPN, Traffic Flows и статистику, а также смотреть события и изменения конфигурации.
Изменения проходят через предварительный просмотр и подтверждение: агент показывает, что будет изменено, до отправки операции. Для работы нужны адрес контроллера UniFi, имя пользователя и пароль; API key используется для инвентаризации и отдельных Integration API-инструментов. Без адреса контроллера сервер запускается только в режиме настройки и предоставляет unifi_setup_status.
В Claude Code настройка может сохранить параметры плагина и подключить сервер во всех проектах. В Codex после установки создаётся запись MCP с настройками контроллера; в других клиентах сервер запускается через uvx unifi-network-mcp.
Какие задачи решает
- просматривать клиентов и их нагрузку в VLAN
- аудировать правила firewall на конфликты
- находить точки доступа с частыми отключениями клиентов
- создавать и проверять изменения сетевой конфигурации
- анализировать крупные Traffic Flows и новые подключения
Примеры запросов агенту
- Покажи клиентов в VLAN Guest с уровнем сигнала и объёмом трафика.
- Проверь правила firewall и найди конфликтующие или лишние политики.
- Покажи изменения сети за последние 24 часа и подготовь правило блокировки IoT-устройств до подтверждения.
Как установить UniFi Network MCP
Командой платформы
claude mcp add --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_PORT=<UNIFI_PORT> --transport stdio network -- uvx unifi-network-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-network-mcp <команда>
Командой платформы
codex mcp add network --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_PORT=<UNIFI_PORT> -- uvx unifi-network-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-network-mcp <команда>
Файл настроек
{
"mcpServers": {
"network": {
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_PORT": "<UNIFI_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-network-mcp <команда>
Файл настроек
{
"servers": {
"network": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_PORT": "<UNIFI_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-network-mcp <команда>
Командой платформы
gemini mcp add -e UNIFI_HOST=<UNIFI_HOST> -e UNIFI_USERNAME=<UNIFI_USERNAME> -e UNIFI_PASSWORD=<UNIFI_PASSWORD> -e UNIFI_API_KEY=<UNIFI_API_KEY> -e UNIFI_PORT=<UNIFI_PORT> network uvx unifi-network-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-network-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Из того же набора3
Похожие
Рядом в теме «Бэкенд и API»
Все MCP-серверы по теме «Бэкенд и API» →Вопросы о UniFi Network MCP
Как установить UniFi Network MCP в Claude Code?
Выполните `claude mcp add unifi-network-mcp -e UNIFI_HOST=<UNIFI_HOST> -e UNIFI_USERNAME=<UNIFI_USERNAME> -e UNIFI_PASSWORD=<UNIFI_PASSWORD> -e UNIFI_API_KEY=<UNIFI_API_KEY> -- uvx unifi-network-mcp`.
Что делает UniFi Network MCP?
Сервер предоставляет ИИ-ассистенту инструменты для работы с UniFi Network: клиентами, устройствами, firewall, VLAN, VPN, статистикой и Traffic Flows. Операции изменения проходят через просмотр результата и подтверждение.
Что нужно для работы UniFi Network MCP?
Нужны адрес контроллера UniFi, учётные данные и запущенный MCP-клиент. API key нужен для инвентаризации и явных Integration API-инструментов.
