UniFi Access MCP — MCP-сервер для Claude Code: двери и доступ
MCP-сервер открывает ИИ-агенту двери UniFi Access, пропуска, политики доступа и события. Чтение — по умолчанию, изменения — только после подтверждения.
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 access -- uvx unifi-access-mcpЧто делает UniFi Access MCP
Сервер отдаёт агенту инструменты для работы с контроллером UniFi Access: список дверей и устройств, учётные данные, политики доступа, гостевые пропуска и журнал событий. Запросы на чтение выполняются сразу, а любые изменения проходят через предварительный просмотр с подтверждением — случайно открыть дверь или выдать пропуск не выйдет.
Авторизация двухканальная. Ключ API работает на отдельном порту Access (по умолчанию 12445) и годится для чтения и перечисления устройств. Блокировка и разблокировка дверей, управление учётными данными, политиками, посетителями и событиями требуют локальной сессии через /api/auth/login на порту 443. Достаточно настроить хотя бы один путь, но без локальной сессии большинство изменяющих инструментов не заработает.
В Claude плагин ставит сам сервер, скилл для поиска инструментов и команду настройки. Учётные данные передаются как файл или команда-провайдер, а не вводятся в чат; пароль или ключ, сохранённый как опция, уходит в системный кэш ключей. Настройки применяются во всех проектах, поэтому после установки нужна новая сессия Claude. Без заданного хоста контроллера сервер всё равно стартует в режиме настройки: подсказывает клиенту, что заполнить, и держит только инструмент access_setup_status.
Какие задачи решает
- посмотреть, кто и когда проходил через двери за день
- найти учётные данные, истекающие в ближайший месяц
- разобрать неудачные попытки приложить пропуск у серверной
- выпустить гостевой пропуск на вход с ограничением по времени
- проверить, какие двери открываются вне рабочих часов
Примеры запросов агенту
- Покажи, кто проходил через двери офиса сегодня, и собери таймлайн событий
- Выпиши все пропуска, срок действия которых истекает в следующие 30 дней
- Сделай гостевой пропуск для John Smith на главный вход с 9 до 17 завтра
Как установить UniFi Access 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 access -- uvx unifi-access-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-access-mcp <команда>
Командой платформы
codex mcp add access --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-access-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-access-mcp <команда>
Файл настроек
{
"mcpServers": {
"access": {
"command": "uvx",
"args": [
"unifi-access-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-access-mcp <команда>
Файл настроек
{
"servers": {
"access": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-access-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-access-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> access uvx unifi-access-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-access-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о UniFi Access MCP
Как установить UniFi Access MCP в Claude Code?
Добавьте маркетплейс плагинов командой /plugin marketplace add sirkirby/unifi-mcp, затем установите плагин: /plugin install unifi-access@unifi-plugins. После этого запустите /unifi-access:unifi-access-setup и начните новую сессию Claude.
Что делает UniFi Access MCP?
Даёт ИИ-агенту доступ к контроллеру UniFi Access: двери, устройства, учётные данные, политики, посетители и события. Чтение идёт сразу, изменения — через предпросмотр и подтверждение.
Что нужно для работы сервера?
Хост контроллера и хотя бы один способ авторизации. Ключ API закрывает чтение и перечисление устройств, а для блокировки дверей и управления пропусками нужна локальная сессия с логином и паролем администратора.
