UniFi Protect MCP — MCP-сервер для Claude Code: установка
Подключает контроллер UniFi Protect к ИИ-ассистентам. Помогает просматривать события камер, искать детекции и управлять подсветкой прямо из чата.
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 protect -- uvx unifi-protect-mcpЧто делает UniFi Protect MCP
Сервер связывает модели вроде Claude Code или Codex с инфраструктурой UniFi Protect: видеокамерами и охранными датчиками. Он читает журнал событий. Ассистент может находить распознанные автомобильные номера или лица людей, а также запрашивать видеозаписи за нужные отрезки времени.
Все операции чтения безопасны. Любые изменения настроек оборудования или включение прожектора требуют обязательного подтверждения после предварительного просмотра параметров. Если контроллер вернёт ошибку при частичной записи, инструмент сообщит, какие именно значения успели примениться.
Для запуска требуется Python 3.13+. Без переменной UNIFI_PROTECT_API_KEY команды изменения громкости микрофона или режима HDR завершатся сбоем ещё до отправки. При отсутствии параметров подключения процесс стартует в изолированном режиме настройки и не обращается к контроллеру.
Какие задачи решает
- найти детекции людей или автомобилей на выбранных камерах за период
- проверить список камер с нестабильным сигналом или статусом офлайн
- получить отметки срабатывания охранных датчиков за день
- настроить чувствительность PIR-сенсора и таймер прожектора
Примеры запросов агенту
- Покажи события умной детекции с камеры у входной двери за сегодня
- Найди записи с камеры на парковке с двух до пяти часов ночи
- Есть ли сейчас камеры со статусом офлайн или плохим качеством связи?
Как установить UniFi Protect 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 protect -- uvx unifi-protect-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-protect-mcp <команда>
Командой платформы
codex mcp add protect --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-protect-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-protect-mcp <команда>
Файл настроек
{
"mcpServers": {
"protect": {
"command": "uvx",
"args": [
"unifi-protect-mcp"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_PORT": "<UNIFI_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-protect-mcp <команда>
Файл настроек
{
"servers": {
"protect": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-protect-mcp"
],
"env": {
"UNIFI_HOST": "<UNIFI_HOST>",
"UNIFI_USERNAME": "<UNIFI_USERNAME>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>",
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_PORT": "<UNIFI_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-protect-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> protect uvx unifi-protect-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-protect-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о UniFi Protect MCP
Как установить UniFi Protect MCP в Claude Code?
Выполните регистрацию каталога плагинов командой /plugin marketplace add sirkirby/unifi-mcp, затем установите пакет через /plugin install unifi-protect@unifi-plugins. Для подключения к контроллеру запустите интерактивный мастер /unifi-protect:unifi-protect-setup.
Что делает UniFi Protect MCP?
Инструмент даёт ИИ-агенту доступ к камерам, датчикам и архивам записей UniFi Protect. Модель может анализировать умные события и менять рабочие параметры устройств.
Зачем нужен параметр UNIFI_PROTECT_API_KEY?
Этот ключ необходим публичному Integration API Protect для изменения громкости микрофона, переключения HDR и управления прожекторами. Для стандартного чтения событий и списков устройств достаточно логина и пароля локального администратора.
