UniFi Gateway
Serveur MCP par Pete Stergion
Gérer UniFi Network, Protect et Access auto-hébergés avec aperçus dry-run, prise en charge multi-site et journal d’audit.
Installer UniFi Gateway
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite Docker sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
STUB_MODEfacultatif 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_HOSTfacultatif 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_KEYsecret facultatif Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and…UNIFI_SITEfacultatif UniFi controller site name. Defaults to 'default'.UNIFI_VERIFY_SSLfacultatif Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert.MCP_UNIFI_CONTROLLERS_FILEfacultatif Path to a YAML file describing multiple named controllers for multi-site management. When set, the legacy UNIFI_HOST / UNIFI_API_KEY env…
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/unifi-gatewayPrésentation
Serveur communautaire pour les passerelles UniFi auto-hébergées. Il couvre UniFi Network (appareils, VLAN, WLAN, pare-feu, ports de switch, redirections de ports, réservations DHCP, observabilité), UniFi Protect en option (caméras, événements de mouvement, détections intelligentes) et UniFi Access en lecture seule (portes, identifiants, visiteurs, événements de badge). Les outils destructifs acceptent un indicateur dry-run, et chaque appel est écrit dans un journal d’audit JSONL dont les secrets sont masqués.
Il s’exécute en local sous forme d’image Docker (stdio ou Streamable HTTP), de bundle Claude Desktop, de chart Helm ou avec uvx. Une clé API UniFi locale de la passerelle est requise ; aucun compte cloud n’est nécessaire. Un mode stub renvoie des données fictives pour l’essayer sans matériel. Une instance peut gérer plusieurs contrôleurs via un fichier YAML.
Ce que vous pouvez faire
- Gérer les VLAN, WLAN, règles de pare-feu, réservations DHCP et redirections de ports
- Prévisualiser les changements destructifs avec dry-run avant de les appliquer
- Inspecter les appareils, les clients et les réglages radio des points d’accès
- Lire les caméras, événements de mouvement et détections intelligentes d’UniFi Protect
- Lire les portes, identifiants et événements de badge d’UniFi Access
- Gérer plusieurs sites UniFi depuis un seul serveur
- Consulter un journal d’audit JSONL de chaque appel d’outil
- Essayer les outils en mode stub sans matériel
Outils
Les serveurs locaux présentent leurs outils une fois lancés, nous ne pouvons donc pas les afficher ici. Cherchez la liste dans sa documentation ; votre client les affiche après l’ajout.
Exemples de prompts
Liste tous les VLAN et WLAN de ma passerelle UniFi.
Prévisualise la création d’un réseau IoT avec dry run avant de l’appliquer.
Audite les ports ouverts dans mes règles de pare-feu et mes politiques de zone.
Montre les derniers événements de mouvement de mes caméras Protect.
Configuration
Chaque client lance UniFi Gateway sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
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- Démarrez Claude Code et tapez
/mcp. unifi-gateway devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"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>"
}
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.
Nécessite Docker sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"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>"
}
}
}
}Nécessite Docker sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
VS Code
Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :
{
"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
}
]
}Nécessite Docker sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%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>"
}
}
}
}- Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.
Devin Desktop est le nouveau nom de 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.0Ou modifiez directement ~/.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>" }Nécessite Docker sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
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.0Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"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 place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite Docker sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Intégrer
Affichez UniFi Gateway dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.
Badge pour 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>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun 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>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/unifi-gateway.jsonPrompt pour l’IA
Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de UniFi Gateway à votre site.
Ajoute à mon site la carte mcp.tc de UniFi Gateway, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.
Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :
```html
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>
```
Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.
```html
<div data-mcptc="unifi-gateway"><a href="https://mcp.tc/i/unifi-gateway">UniFi Gateway on mcp.tc</a></div>
```
Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.
Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).
Pour un README ou une autre doc en Markdown, utilise plutôt le badge :
```markdown
[](https://mcp.tc/i/unifi-gateway)
```
Référence : https://mcp.tc/fr/embedHistorique des changements
Il tourne sur votre ordinateur et n’a pas de paquet que nous puissions suivre. Les modifications de son propriétaire apparaissent ici.
Rien de noté pour l’instant. Les modifications du propriétaire du serveur apparaîtront ici.
FAQ
Puis-je coller mcp.tc/i/unifi-gateway dans mon client MCP ?
Non. UniFi Gateway tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0.
UniFi Gateway a-t-il besoin d’une clé API ?
Oui. Il lit UNIFI_API_KEY et UNIFI_ACCESS_API_KEY dans son environnement, et UNIFI_API_KEY et UNIFI_ACCESS_API_KEY sont des secrets. Mettez les valeurs dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.
UniFi Gateway est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0, qui nécessite Docker.
Que peut faire UniFi Gateway ?
Vous pouvez gérer les VLAN, WLAN, règles de pare-feu, réservations DHCP et redirections de ports, prévisualiser les changements destructifs avec dry-run avant de les appliquer et inspecter les appareils, les clients et les réglages radio des points d’accès.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
mcp.tc suit-il les changements de UniFi Gateway ?
En partie. UniFi Gateway tourne sur votre ordinateur et n’a pas de paquet que nous puissions suivre, donc son onglet Historique ne montre que les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de UniFi Gateway (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.
mcp.tc n’est pas affilié à Pete Stergion. Cette page a été construite à partir des métadonnées publiques de UniFi Gateway, vérifiées pour la dernière fois le 4 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.