Noi e terze parti selezionate usiamo cookie o tecnologie simili per finalità tecniche e, con il tuo consenso, per analizzare l’uso del sito.

Puoi liberamente prestare, negare o revocare il tuo consenso in qualsiasi momento.

UniFi Gateway

Server MCP di Pete Stergion

Gestisci UniFi Network, Protect e Access self-hosted con anteprime dry-run, supporto multi-sito e un log di audit.

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con dockerServe una chiave API

Installa UniFi Gateway

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0

Richiede Docker sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

  • STUB_MODE facoltativo When true, the server returns realistic mock data and requires no UniFi hardware. Defaults to true so the image is functional out of the…
  • UNIFI_HOST facoltativo IP address or hostname of the UniFi OS gateway (UCG-Fiber, UDM Pro, etc). Required when STUB_MODE=false and MCP_UNIFI_CONTROLLERS_FILE is…
  • UNIFI_API_KEY segreto facoltativo Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and…
  • UNIFI_SITE facoltativo UniFi controller site name. Defaults to 'default'.
  • UNIFI_VERIFY_SSL facoltativo Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert.
  • MCP_UNIFI_CONTROLLERS_FILE facoltativo Path to a YAML file describing multiple named controllers for multi-site management. When set, the legacy UNIFI_HOST / UNIFI_API_KEY env…

Condividi questo server

Apre questa pagina, con il comando di installazione e i passaggi di configurazione.

mcp.tc/i/unifi-gateway

Descrizione

Server della community per i gateway UniFi self-hosted. Copre UniFi Network (dispositivi, VLAN, WLAN, firewall, porte dello switch, port forward, prenotazioni DHCP, osservabilità), UniFi Protect opzionale (telecamere, eventi di movimento, rilevamenti intelligenti) e UniFi Access in sola lettura (porte, credenziali, visitatori, eventi dei badge). I tool distruttivi accettano un flag dry-run e ogni chiamata viene scritta in un log di audit JSONL con i segreti oscurati.

Si esegue in locale come immagine Docker (stdio o Streamable HTTP), bundle per Claude Desktop, chart Helm o uvx. Serve una chiave API UniFi locale del gateway; non è richiesto alcun account cloud. Una modalità stub restituisce dati fittizi, così puoi provarlo senza hardware. Una sola istanza può gestire più controller tramite un file YAML.

Cosa puoi fare

  • Gestire VLAN, WLAN, regole firewall, prenotazioni DHCP e port forward
  • Visualizzare in anteprima le modifiche distruttive con dry-run prima di applicarle
  • Ispezionare dispositivi, client e impostazioni radio degli access point
  • Leggere telecamere, eventi di movimento e rilevamenti intelligenti di UniFi Protect
  • Leggere porte, credenziali ed eventi dei badge di UniFi Access
  • Gestire più siti UniFi da un solo server
  • Consultare un log di audit JSONL di ogni chiamata ai tool
  • Provare i tool in modalità stub senza hardware

Tool

I server locali mostrano i loro tool solo quando sono in esecuzione, quindi non possiamo mostrarli qui. Cerca l’elenco nella sua documentazione; il tuo client li mostra dopo che lo hai aggiunto.

Prompt di esempio

  • Elenca tutte le VLAN e le WLAN sul mio gateway UniFi.

  • Mostra l’anteprima della creazione di una rete IoT con dry run prima di applicarla.

  • Verifica le porte aperte nelle regole del firewall e nelle policy di zona.

  • Mostrami i recenti eventi di movimento delle mie telecamere Protect.

Configurazione

Ogni client avvia UniFi Gateway sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

Claude Code

  1. Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio unifi-gateway --env "UNIFI_API_KEY=<YOUR_UNIFI_API_KEY>" --env "UNIFI_ACCESS_API_KEY=<YOUR_UNIFI_ACCESS_API_KEY>" -- docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0
  1. Avvia Claude Code e digita /mcp. unifi-gateway dovrebbe risultare collegato.

Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.

Claude Desktop

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
claude_desktop_config.json
{
  "mcpServers": {
    "unifi-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_ACCESS_API_KEY",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.25.0"
      ],
      "env": {
        "UNIFI_API_KEY": "<YOUR_UNIFI_API_KEY>",
        "UNIFI_ACCESS_API_KEY": "<YOUR_UNIFI_ACCESS_API_KEY>"
      }
    }
  }
}
  1. Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.

Richiede Docker sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.

Cursor

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

mcp.json
{
  "mcpServers": {
    "unifi-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_ACCESS_API_KEY",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.25.0"
      ],
      "env": {
        "UNIFI_API_KEY": "<YOUR_UNIFI_API_KEY>",
        "UNIFI_ACCESS_API_KEY": "<YOUR_UNIFI_ACCESS_API_KEY>"
      }
    }
  }
}

Richiede Docker sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

VS Code

Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:

.vscode/mcp.json
{
  "servers": {
    "unifi-gateway": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_ACCESS_API_KEY",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.25.0"
      ],
      "env": {
        "UNIFI_API_KEY": "${input:unifi-api-key}",
        "UNIFI_ACCESS_API_KEY": "${input:unifi-access-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "unifi-api-key",
      "description": "UNIFI_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "unifi-access-api-key",
      "description": "UNIFI_ACCESS_API_KEY",
      "password": true
    }
  ]
}

Richiede Docker sul tuo computer.

Devin Desktop

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "unifi-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_ACCESS_API_KEY",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.25.0"
      ],
      "env": {
        "UNIFI_API_KEY": "<YOUR_UNIFI_API_KEY>",
        "UNIFI_ACCESS_API_KEY": "<YOUR_UNIFI_ACCESS_API_KEY>"
      }
    }
  }
}
  1. Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.

Devin Desktop è il nuovo nome di Windsurf.

Codex

codex mcp add unifi-gateway --env "UNIFI_API_KEY=<YOUR_UNIFI_API_KEY>" --env "UNIFI_ACCESS_API_KEY=<YOUR_UNIFI_ACCESS_API_KEY>" -- docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0

Oppure modifica direttamente ~/.codex/config.toml:

config.toml
[mcp_servers.unifi-gateway]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/pete-builds/mcp-unifi:0.25.0"]
env = { UNIFI_API_KEY = "<YOUR_UNIFI_API_KEY>", UNIFI_ACCESS_API_KEY = "<YOUR_UNIFI_ACCESS_API_KEY>" }

Richiede Docker sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

Gemini CLI

gemini mcp add -e "UNIFI_API_KEY=<YOUR_UNIFI_API_KEY>" -e "UNIFI_ACCESS_API_KEY=<YOUR_UNIFI_ACCESS_API_KEY>" unifi-gateway docker -- run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0

Così lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.

Qualsiasi client

La maggior parte dei client che avviano server locali accetta questa forma:

{
  "mcpServers": {
    "unifi-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_ACCESS_API_KEY",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.25.0"
      ],
      "env": {
        "UNIFI_API_KEY": "<YOUR_UNIFI_API_KEY>",
        "UNIFI_ACCESS_API_KEY": "<YOUR_UNIFI_ACCESS_API_KEY>"
      }
    }
  }
}

Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.

Richiede Docker sul tuo computer. Sostituisci i segnaposto con i tuoi valori.

Embed

Mostra UniFi Gateway in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed

Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.

Badge per il README

Anteprima del badge, chiaroAnteprima del badge, scuro
Markdown
[![UniFi Gateway on mcp.tc](https://mcp.tc/i/unifi-gateway/badge.svg)](https://mcp.tc/i/unifi-gateway)
HTML
<a href="https://mcp.tc/i/unifi-gateway"><img src="https://mcp.tc/i/unifi-gateway/badge.svg" alt="UniFi Gateway on mcp.tc" height="20"></a>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Card per il sito

HTML
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>

La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

iframe

HTML
<iframe src="https://mcp.tc/embed/unifi-gateway" title="UniFi Gateway on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/unifi-gateway.json

Cosa significa ogni campo

Prompt per l’AI

Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di UniFi Gateway al tuo sito.

Markdown
Aggiungi al mio sito la card di mcp.tc per UniFi Gateway, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.

Metti questo tag dove deve comparire la card. La card appare subito prima del tag:

```html
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>
```

Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.

```html
<div data-mcptc="unifi-gateway"><a href="https://mcp.tc/i/unifi-gateway">UniFi Gateway on mcp.tc</a></div>
```

Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.

Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).

Per un README o altra documentazione in Markdown, usa invece il badge:

```markdown
[![UniFi Gateway on mcp.tc](https://mcp.tc/i/unifi-gateway/badge.svg)](https://mcp.tc/i/unifi-gateway)
```

Riferimento: https://mcp.tc/it/embed

Cronologia delle modifiche

Gira sul tuo computer e non ha un pacchetto che possiamo seguire. Qui compaiono le modifiche di chi lo gestisce.

Segui UniFi Gateway e ti mandiamo un’email quando qualcosa cambia.

Nulla di registrato per ora. Qui compariranno le modifiche di chi gestisce il server.

Domande frequenti

Posso incollare mcp.tc/i/unifi-gateway nel mio client MCP?

No. UniFi Gateway gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0.

UniFi Gateway richiede una chiave API?

Sì. Legge UNIFI_API_KEY e UNIFI_ACCESS_API_KEY dal suo ambiente, e UNIFI_API_KEY e UNIFI_ACCESS_API_KEY sono segreti. Metti i valori nella configurazione del tuo client sul tuo computer, mai in un file condiviso.

UniFi Gateway è un server remoto o locale?

Locale. Il tuo client lo avvia come processo sul tuo computer con docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0, che richiede Docker.

Cosa può fare UniFi Gateway?

Puoi gestire VLAN, WLAN, regole firewall, prenotazioni DHCP e port forward, visualizzare in anteprima le modifiche distruttive con dry-run prima di applicarle e ispezionare dispositivi, client e impostazioni radio degli access point.

Quali client possono usarlo?

Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.

mcp.tc tiene traccia delle modifiche di UniFi Gateway?

In parte. UniFi Gateway gira sul tuo computer e non ha un pacchetto che possiamo seguire, quindi la sua sezione Cronologia mostra solo le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.

Chi ha scritto questa pagina?

Il robot di mcp.tc ha letto i metadati pubblici di UniFi Gateway (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.

mcp.tc non è affiliato a Pete Stergion. Questa pagina è stata creata a partire dai metadati pubblici di UniFi Gateway (ultimo controllo: 4 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.