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.
Installa UniFi Gateway
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede Docker sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
STUB_MODEfacoltativo 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_HOSTfacoltativo 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_KEYsegreto facoltativo Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and…UNIFI_SITEfacoltativo UniFi controller site name. Defaults to 'default'.UNIFI_VERIFY_SSLfacoltativo Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert.MCP_UNIFI_CONTROLLERS_FILEfacoltativo 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-gatewayDescrizione
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
- 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- 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
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"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>"
}
}
}
}- 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
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"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:
{
"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
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"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>"
}
}
}
}- 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.0Oppure modifica direttamente ~/.codex/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.0Così 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
[](https://mcp.tc/i/unifi-gateway)<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
<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
<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.jsonPrompt 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.
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
[](https://mcp.tc/i/unifi-gateway)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Gira sul tuo computer e non ha un pacchetto che possiamo seguire. Qui compaiono le modifiche di chi lo gestisce.
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.