# UniFi Fabric MCP Server

MCP-сервер UniFi Fabric MCP Server для Claude Code связывает ИИ-ассистента с сетью UniFi. Он помогает находить отключённые устройства, разбирать проблемы Wi-Fi и управлять настройками.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: swkstudios
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/swkstudios/unifi-fabric-mcp-server
- Обновлён: 2026-11-15
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/unifi-fabric-mcp-server

## Что делает

Сервер даёт ИИ-ассистенту доступ к данным и настройкам UniFi Fabric: сетям, Wi-Fi, VPN, правилам firewall, клиентам и устройствам. Он также работает с камерами Protect и планами этажей InnerSpace. Инструменты подгружаются по запросу; полный каталог включает 798 инструментов.

Для подключения нужны консоли, добавленные в fabric через UniFi Site Manager, и ключ API fabric. Один ключ охватывает организацию, а несколько ключей позволяют подключить несколько организаций.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `UNIFI_API_KEY`, `UNIFI_WRITE_POLICY`, `UNIFI_TOOL_MODE`, `MCP_AUTH_MODE`, `MCP_BEARER_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> --env UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> --env MCP_AUTH_MODE=<MCP_AUTH_MODE> --env MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> --transport stdio unifi-fabric-mcp-server -- uvx unifi-fabric-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-fabric-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add unifi-fabric-mcp-server --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> --env UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> --env MCP_AUTH_MODE=<MCP_AUTH_MODE> --env MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> -- uvx unifi-fabric-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-fabric-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unifi-fabric-mcp-server": {
            "command": "uvx",
            "args": [
                "unifi-fabric-mcp-server"
            ],
            "env": {
                "UNIFI_API_KEY": "<UNIFI_API_KEY>",
                "UNIFI_WRITE_POLICY": "<UNIFI_WRITE_POLICY>",
                "UNIFI_TOOL_MODE": "<UNIFI_TOOL_MODE>",
                "MCP_AUTH_MODE": "<MCP_AUTH_MODE>",
                "MCP_BEARER_TOKEN": "<MCP_BEARER_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-fabric-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "unifi-fabric-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "unifi-fabric-mcp-server"
            ],
            "env": {
                "UNIFI_API_KEY": "<UNIFI_API_KEY>",
                "UNIFI_WRITE_POLICY": "<UNIFI_WRITE_POLICY>",
                "UNIFI_TOOL_MODE": "<UNIFI_TOOL_MODE>",
                "MCP_AUTH_MODE": "<MCP_AUTH_MODE>",
                "MCP_BEARER_TOKEN": "<MCP_BEARER_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-fabric-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e UNIFI_API_KEY=<UNIFI_API_KEY> -e UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> -e UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> -e MCP_AUTH_MODE=<MCP_AUTH_MODE> -e MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> unifi-fabric-mcp-server uvx unifi-fabric-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from unifi-fabric-mcp-server <команда>

## Когда брать
- найти отключённые устройства UniFi
- разобрать проблемы с Wi-Fi
- просмотреть события камер Protect
- найти планы этажей в InnerSpace
- изменить сетевые и firewall-настройки

## Примеры запросов агенту
- Покажи сайты UniFi и устройства на каждом из них.
- Найди отключённые устройства и подскажи, что проверить.
- Покажи последние события камер Protect.

## Похожие
- [UniFi Protect MCP](https://affpapa.org/nevibecode/mcp/unifi-protect-mcp.md) — MCP-сервер · ★ 1107 у репозитория
- [UniFi Network MCP](https://affpapa.org/nevibecode/mcp/unifi-network-mcp.md) — MCP-сервер · ★ 1107 у репозитория
- [unifi-mcp-server](https://affpapa.org/nevibecode/mcp/unifi-mcp-server.md) — MCP-сервер · ★ 370 у репозитория
- [mcp-unifi-applications](https://affpapa.org/nevibecode/mcp/mcp-unifi-applications.md) — MCP-сервер · ★ 40 у репозитория
- [UniFi Gateway](https://affpapa.org/nevibecode/mcp/unifi-gateway.md) — MCP-сервер · ★ 31 у репозитория
- [UniFi MCP](https://affpapa.org/nevibecode/mcp/unifi-mcp.md) — MCP-сервер · ★ 87 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
