UniFi Gateway
MCP-Server von Pete Stergion
Selbst gehostetes UniFi Network, Protect und Access verwalten, mit Dry-Run-Vorschau, Multi-Site-Unterstützung und Audit-Log.
UniFi Gateway installieren
Läuft auf deinem Rechner. Dein Client startet ihn mit diesem Befehl:
Braucht Docker auf deinem Rechner. Die Schritte unten zeigen, wo der Befehl in jedem Client hingehört.
STUB_MODEoptional 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_HOSToptional 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_KEYgeheim optional Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and…UNIFI_SITEoptional UniFi controller site name. Defaults to 'default'.UNIFI_VERIFY_SSLoptional Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert.MCP_UNIFI_CONTROLLERS_FILEoptional Path to a YAML file describing multiple named controllers for multi-site management. When set, the legacy UNIFI_HOST / UNIFI_API_KEY env…
Diesen Server teilen
Öffnet diese Seite mit dem Installationsbefehl und den Einrichtungsschritten.
mcp.tc/i/unifi-gatewayÜber den Server
Community-Server für selbst gehostete UniFi-Gateways. Er deckt UniFi Network ab (Geräte, VLANs, WLANs, Firewall, Switch-Ports, Portweiterleitungen, DHCP-Reservierungen, Observability), optional UniFi Protect (Kameras, Bewegungsereignisse, Smart Detections) und schreibgeschützt UniFi Access (Türen, Zugangsdaten, Besucher, Badge-Ereignisse). Destruktive Tools akzeptieren ein Dry-Run-Flag, und jeder Aufruf wird in ein JSONL-Audit-Log geschrieben, in dem Geheimnisse entfernt sind.
Er läuft lokal als Docker-Image (stdio oder Streamable HTTP), als Claude-Desktop-Bundle, als Helm-Chart oder mit uvx. Nötig ist ein lokaler UniFi-API-Schlüssel vom Gateway; ein Cloud-Konto ist nicht erforderlich. Ein Stub-Modus liefert Mock-Daten, sodass du ihn ohne Hardware ausprobieren kannst. Eine Instanz kann über eine YAML-Datei mehrere Controller verwalten.
Was du damit machen kannst
- VLANs, WLANs, Firewall-Regeln, DHCP-Reservierungen und Portweiterleitungen verwalten
- Destruktive Änderungen vor dem Anwenden per Dry-Run prüfen
- Geräte, Clients und AP-Funkeinstellungen untersuchen
- UniFi-Protect-Kameras, Bewegungsereignisse und Smart Detections lesen
- UniFi-Access-Türen, Zugangsdaten und Badge-Ereignisse lesen
- Mehrere UniFi-Sites über einen Server verwalten
- JSONL-Audit-Log jedes Tool-Aufrufs einsehen
- Tool-Umfang im Stub-Modus ohne Hardware ausprobieren
Tools
Lokale Server zeigen ihre Tools erst, wenn sie laufen, deshalb können wir sie hier nicht anzeigen. Die Liste findest du in seiner Dokumentation; dein Client zeigt sie, nachdem du ihn hinzugefügt hast.
Beispiel-Prompts
Liste alle VLANs und WLANs auf meinem UniFi-Gateway auf.
Zeige per Dry-Run eine Vorschau für das Anlegen eines IoT-Netzwerks, bevor du es anwendest.
Prüfe die offenen Ports in meinen Firewall-Regeln und Zonenrichtlinien.
Zeige die letzten Bewegungsereignisse meiner Protect-Kameras.
Einrichtung
Jeder Client startet UniFi Gateway mit demselben Befehl auf deinem Rechner. Wähl deinen; die Seite merkt sich deine Wahl.
Claude Code
- Führe das in einem Terminal in deinem Projektordner aus:
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- Starte Claude Code und tippe
/mcp. unifi-gateway sollte als verbunden angezeigt werden.
Ergänze --scope user, damit er in jedem Projekt verfügbar ist. Ersetze die Platzhalter durch deine eigenen Werte.
Claude Desktop
- Öffne Settings → Developer → Edit Config. Das öffnet
claude_desktop_config.json. Füge hinzu:
{
"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>"
}
}
}
}- Speichere die Datei und starte Claude Desktop neu. Ersetze die Platzhalter durch deine eigenen Werte.
Braucht Docker auf deinem Rechner. Die Datei liegt unter macOS in ~/Library/Application Support/Claude/ und unter Windows in %APPDATA%\Claude\.
Cursor
Zu Cursor hinzufügen (öffnet in einem neuen Tab)
Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:
{
"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>"
}
}
}
}Braucht Docker auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
VS Code
Füge ihn zu .vscode/mcp.json hinzu. VS Code fragt beim ersten Mal nach dem Secret und speichert es sicher:
{
"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
}
]
}Braucht Docker auf deinem Rechner.
Devin Desktop
- Füge ihn zu
~/.config/devin/mcp_config.json(macOS und Linux) oder%APPDATA%\devin\mcp_config.json(Windows) hinzu:
{
"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>"
}
}
}
}- Aktualisiere die Liste der MCP-Server in Cascade. Ersetze die Platzhalter durch deine eigenen Werte.
Devin Desktop ist der neue Name von 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.0Oder bearbeite ~/.codex/config.toml direkt:
[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>" }Braucht Docker auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
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.0Damit fügst du ihn dem aktuellen Projekt hinzu. Ergänze -s user, um ihn überall zu nutzen.
Jeder Client
Die meisten Clients, die lokale Server starten, akzeptieren diese Form:
{
"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 legt Server in seinen Einstellungen unter context_servers ab, mit denselben Feldern command, args und env.
Braucht Docker auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
Einbinden
Zeig UniFi Gateway in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt den Installationsbefehl des Servers und setzt keine Cookies. So funktionieren Einbindungen
Karte, iframe und JSON sind auf Englisch. Häng ?lang=it, fr, de oder es an ihre Adresse an, um eine andere Sprache zu bekommen.
README-Badge
[](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>Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.
Website-Karte
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.
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>Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.
JSON
Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, Installationsbefehl, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).
https://mcp.tc/i/unifi-gateway.jsonKI-Prompt
Füg ihn in einen KI-Coding-Assistenten wie Claude Code oder Cursor ein, und er baut die Karte von UniFi Gateway in deine Website ein.
Füge meiner Website die mcp.tc-Karte für den MCP-Server UniFi Gateway hinzu. Es ist ein einziges statisches Skript: kein Build-Schritt, kein Paket zu installieren, keine Cookies.
Setz dieses Tag dorthin, wo die Karte erscheinen soll. Die Karte erscheint direkt davor:
```html
<script src="https://mcp.tc/w/unifi-gateway.js" async></script>
```
Um sie woanders zu zeigen, setz dort diesen Platzhalter ein und lade dasselbe Skript nur einmal, zum Beispiel vor `</body>`. Lass den Link darin stehen: Besucher ohne JavaScript sehen ihn.
```html
<div data-mcptc="unifi-gateway"><a href="https://mcp.tc/i/unifi-gateway">UniFi Gateway on mcp.tc</a></div>
```
Optionen:
- `data-theme="light"` oder `"dark"` am Tag oder Platzhalter legt die Farben fest. Ohne das Attribut folgt die Karte dem hellen oder dunklen Modus der Besucher.
- `data-size="compact"` ergibt eine kleinere Karte ohne Kurzbeschreibung.
- Die CSS-Variable `--mcptc-max-width` am Platzhalter oder einem Elternelement legt die Breite fest (Standard `520px`).
- `?lang=` in der Skript-URL legt die Sprache der Karte fest: `en`, `it`, `fr`, `de` oder `es`.
Wenn die Website eine Content Security Policy hat, erlaube `script-src https://mcp.tc` und `img-src data:` (das Icon ist eingebettet).
Für ein README oder andere Markdown-Dokumentation nimm stattdessen das Badge:
```markdown
[](https://mcp.tc/i/unifi-gateway)
```
Referenz: https://mcp.tc/de/embedÄnderungsverlauf
Er läuft auf deinem Computer und hat kein Paket, das wir verfolgen können. Änderungen seines Betreibers erscheinen hier.
Noch nichts festgehalten. Änderungen des Server-Betreibers erscheinen hier.
Häufige Fragen
Kann ich mcp.tc/i/unifi-gateway in meinen MCP-Client einfügen?
Nein. UniFi Gateway läuft auf deinem eigenen Rechner und wird von deinem Client gestartet, hat also keine Webadresse, mit der man sich verbinden könnte. Der Quick-Link ist die Seite zum Teilen; der Installationsbefehl lautet docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0.
Braucht UniFi Gateway einen API-Schlüssel?
Ja. Er liest UNIFI_API_KEY und UNIFI_ACCESS_API_KEY aus seiner Umgebung, und UNIFI_API_KEY und UNIFI_ACCESS_API_KEY sind geheim. Trag die Werte in die Konfiguration deines Clients auf deinem eigenen Rechner ein, nie in eine geteilte Datei.
Ist UniFi Gateway ein Remote- oder ein lokaler Server?
Lokal. Dein Client startet ihn mit docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0 als Prozess auf deinem Rechner; dafür brauchst du Docker.
Was kann UniFi Gateway?
Du kannst damit VLANs, WLANs, Firewall-Regeln, DHCP-Reservierungen und Portweiterleitungen verwalten, Destruktive Änderungen vor dem Anwenden per Dry-Run prüfen und Geräte, Clients und AP-Funkeinstellungen untersuchen.
Welche Clients können ihn nutzen?
Jeder Client, der lokale Server startet: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed und andere. claude.ai und ChatGPT verbinden sich nur mit Remote-Servern.
Verfolgt mcp.tc Änderungen an UniFi Gateway?
Teilweise. UniFi Gateway läuft auf deinem Computer und hat kein Paket, das wir verfolgen können, deshalb zeigt sein Tab Verlauf nur Änderungen seines Betreibers. Folge dem Eintrag, um eine E-Mail zu bekommen, wenn er sich ändert.
Wer hat diese Seite geschrieben?
Der Roboter von mcp.tc hat die öffentlichen Metadaten von UniFi Gateway (seine Paket- und Repository-Seiten) gelesen, und ein KI-Modell hat daraus den Text entworfen. Ein Mensch prüft alles, was die Prüfungen nicht bestätigen können. Der Text kann trotzdem falsch sein; wenn dir ein Fehler auffällt, nutze Eintrag melden auf dieser Seite. Diese Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.
mcp.tc steht in keiner Verbindung zu Pete Stergion. Diese Seite entstand aus den öffentlichen Metadaten von UniFi Gateway, zuletzt geprüft am 4. Okt. 2026, und ein KI-Modell hat die Beschreibung geschrieben, sie kann also Fehler enthalten. Namen und Marken gehören ihren Inhabern. Stimmt etwas nicht? Eintrag melden. Die Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.