unifi-mcp-server — MCP-сервер для Claude Code: управление UniFi
Даёт ИИ-агенту доступ к UniFi Network, Protect и облачным API через MCP. С его помощью можно читать состояние инфраструктуры и менять настройки.
claude mcp add --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_PORT=<UNIFI_PORT> --env UNIFI_VERIFY_SSL=<UNIFI_VERIFY_SSL> --transport stdio unifi-mcp-server -- npx -y unifi-mcp-serverЧто делает unifi-mcp-server
Сервер предоставляет инструменты для управления сетевыми клиентами, устройствами, Wi-Fi, VLAN, правилами межсетевого экрана и камерами UniFi Protect. Через облачные API доступны сведения о сайтах и агрегированная статистика; управление отдельными устройствами и конфигурацией там не работает. Для этого нужен режим local.
Перед подключением потребуется API-ключ UniFi и адрес хоста. В Claude Code сервер можно добавить командой с переменными UNIFI_HOST, UNIFI_USERNAME и UNIFI_PASSWORD. Учтите, что пример установки использует npx, а основной запуск описан через pip или uvx: проверьте, какой способ подходит вашей среде. Для зонального межсетевого экрана требуется UniFi Network 9.0 или новее.
Какие задачи решает
- найти сетевого клиента и заблокировать его
- перезапустить устройство UniFi
- изменить настройки Wi-Fi и VLAN
- проверить события с камер UniFi Protect
- получить статистику по сайтам UniFi
Примеры запросов агенту
- Найди сетевого клиента с адресом
192.168.2.10и заблокируй его. - Покажи устройства UniFi и перезапусти точку доступа с именем
Office AP. - Проверь последние события камер UniFi Protect.
Как установить unifi-mcp-server
Командой платформы
claude mcp add --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_PORT=<UNIFI_PORT> --env UNIFI_VERIFY_SSL=<UNIFI_VERIFY_SSL> --transport stdio unifi-mcp-server -- npx -y unifi-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add unifi-mcp-server --env UNIFI_HOST=<UNIFI_HOST> --env UNIFI_USERNAME=<UNIFI_USERNAME> --env UNIFI_PASSWORD=<UNIFI_PASSWORD> --env UNIFI_PORT=<UNIFI_PORT> --env UNIFI_VERIFY_SSL=<UNIFI_VERIFY_SSL> -- npx -y unifi-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"unifi-mcp-server": {
"command": "npx",
"args": [
"-y",
"unifi-mcp-server"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_PORT": "<UNIFI_PORT>",
"UNIFI_VERIFY_SSL": "<UNIFI_VERIFY_SSL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"unifi-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"unifi-mcp-server"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_PORT": "<UNIFI_PORT>",
"UNIFI_VERIFY_SSL": "<UNIFI_VERIFY_SSL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e UNIFI_HOST=<UNIFI_HOST> -e UNIFI_USERNAME=<UNIFI_USERNAME> -e UNIFI_PASSWORD=<UNIFI_PASSWORD> -e UNIFI_PORT=<UNIFI_PORT> -e UNIFI_VERIFY_SSL=<UNIFI_VERIFY_SSL> unifi-mcp-server npx -y unifi-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о unifi-mcp-server
Как установить unifi-mcp-server в Claude Code?
Выполните `claude mcp add unifi-mcp-server -e UNIFI_HOST=<UNIFI_HOST> -e UNIFI_USERNAME=<UNIFI_USERNAME> -e UNIFI_PASSWORD=<UNIFI_PASSWORD> -- npx -y unifi-mcp-server`. Подставьте адрес хоста, имя пользователя и пароль.
Что делает unifi-mcp-server?
Подключает агента к UniFi Network, Protect и облачным API через MCP. Агент может читать данные и менять инфраструктуру, если выбран соответствующий режим API.
Работает ли управление устройствами через облачный API?
Нет. Режимы cloud-ea и cloud-v1 дают доступ к сайтам и общей статистике, но не к управлению отдельными устройствами или конфигурацией. Для этого используйте local.
