UniFi Gateway

Q: Does UniFi Gateway need an API key?

Yes. It reads UNIFI_API_KEY y UNIFI_ACCESS_API_KEY from its environment, and UNIFI_API_KEY y UNIFI_ACCESS_API_KEY are secrets. Put the values in your client’s config on your own machine, never in a shared file.

Servidor MCP de Pete Stergion

Manage self-hosted UniFi Network, Protect and Access with dry-run previews, multi-site support and an audit log.

Se ejecuta en localSe ejecuta con dockerRequiere clave API

Instalar UniFi Gateway

Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:

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

Requiere Docker en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.

STUB_MODE opcional 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 opcional 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 secreto opcional Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and…
UNIFI_SITE opcional UniFi controller site name. Defaults to 'default'.
UNIFI_VERIFY_SSL opcional Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert.
MCP_UNIFI_CONTROLLERS_FILE opcional Path to a YAML file describing multiple named controllers for multi-site management. When set, the legacy UNIFI_HOST / UNIFI_API_KEY env…

Añadir a Cursor

Descripción

Community server for self-hosted UniFi gateways. It covers UniFi Network (devices, VLANs, WLANs, firewall, switch ports, port forwards, DHCP reservations, observability), opt-in UniFi Protect (cameras, motion events, smart detections) and read-only UniFi Access (doors, credentials, visitors, badge events). Destructive tools accept a dry-run flag, and every call is written to a JSONL audit log with secrets scrubbed.

It runs locally as a Docker image (stdio or Streamable HTTP), a Claude Desktop bundle, a Helm chart or uvx. A local UniFi API key from the gateway is needed; no cloud account is required. A stub mode returns mock data so you can try it without hardware. One instance can manage several controllers via a YAML file.

Qué puedes hacer

Manage VLANs, WLANs, firewall rules, DHCP reservations and port forwards
Preview destructive changes with dry-run before applying
Inspect devices, clients and AP radio settings
Read UniFi Protect cameras, motion events and smart detections
Read UniFi Access doors, credentials and badge events
Manage multiple UniFi sites from one server
Review a JSONL audit log of every tool call
Try the tool surface in stub mode without hardware

Herramientas

UniFi Gateway solo muestra sus herramientas a clientes con clave, así que no podemos listarlas aquí.

Prompts de ejemplo

List all VLANs and WLANs on my UniFi gateway.
Preview creating an IoT network with dry run before applying it.
Audit open ports across my firewall rules and zone policies.
Show recent motion events from my Protect cameras.

Configuración

Todos los clientes inician UniFi Gateway en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.

Claude Code

Run this in a terminal, in your project folder:

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

Start Claude Code and type /mcp. unifi-gateway should show as connected.

Add --scope user to make it available in every project. Replace the placeholders with your own values.

Claude Desktop

Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:

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>"
      }
    }
  }
}

Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs Docker on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Añadir a Cursor (se abre en una pestaña nueva)

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

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>"
      }
    }
  }
}

Needs Docker on your computer. Replace the placeholders with your own values.

VS Code

Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:

.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
    }
  ]
}

Needs Docker on your computer.

Devin Desktop

Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %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>"
      }
    }
  }
}

Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for 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

Or edit ~/.codex/config.toml directly:

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>" }

Needs Docker on your computer. Replace the placeholders with your own values.

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

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "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 puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Docker on your computer. Replace the placeholders with your own values.

Preguntas frecuentes

Can I paste mcp.tc/i/unifi-gateway into my MCP client?

No. UniFi Gateway runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0.

Does UniFi Gateway need an API key?

Yes. It reads UNIFI_API_KEY y UNIFI_ACCESS_API_KEY from its environment, and UNIFI_API_KEY y UNIFI_ACCESS_API_KEY are secrets. Put the values in your client’s config on your own machine, never in a shared file.

Is UniFi Gateway a remote or a local server?

Local. Your client starts it as a process on your computer with docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0, which needs Docker.

What can UniFi Gateway do?

You can manage VLANs, WLANs, firewall rules, DHCP reservations and port forwards, preview destructive changes with dry-run before applying y inspect devices, clients and AP radio settings.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc’s robot read UniFi Gateway’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

Insertar

Muestra UniFi Gateway en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones

Insignia para README

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>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML

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

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

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>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

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

Qué significa cada campo

mcp.tc no tiene relación con Pete Stergion. Esta página se creó a partir de los metadatos públicos de UniFi Gateway, comprobados por última vez el 4 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha.

Instalar UniFi Gateway

Compartir este servidor

Descripción

Qué puedes hacer

Herramientas

Prompts de ejemplo

Configuración

Claude Code

Claude Desktop

Cursor

VS Code

Devin Desktop

Codex

Gemini CLI

Any client

Preguntas frecuentes

Insertar

Insignia para README

Tarjeta para web

iframe

JSON

Servidores relacionados

StackQL

Fly.io (flyctl), verificado

Firebase, verificado

DigitalOcean, verificado

Heroku, verificado

Terraform, verificado