Nosotros y terceros seleccionados usamos cookies o tecnologías similares con fines técnicos y, con tu consentimiento, para analizar cómo se usa el sitio.

Puedes dar, negar o retirar libremente tu consentimiento en cualquier momento.

UniFi Gateway

Servidor MCP de Pete Stergion

Gestiona UniFi Network, Protect y Access autoalojados con vistas previas dry-run, varios sitios y registro de auditoría.

Se ejecuta en local (Se ejecuta en tu equipo: su página tiene el comando de instalación)Se ejecuta con dockerRequiere clave de 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…

Compartir este servidor

El enlace abre esta página, con el comando de instalación y los pasos de configuración.

mcp.tc/i/unifi-gateway

Descripción

Servidor de la comunidad para gateways UniFi autoalojados. Cubre UniFi Network (dispositivos, VLAN, WLAN, firewall, puertos de switch, reenvío de puertos, reservas DHCP, observabilidad), UniFi Protect opcional (cámaras, eventos de movimiento, detecciones inteligentes) y UniFi Access de solo lectura (puertas, credenciales, visitantes, eventos de credencial). Las herramientas destructivas aceptan un indicador dry-run y cada llamada se escribe en un registro de auditoría JSONL con los secretos eliminados.

Se ejecuta en local como imagen de Docker (stdio o Streamable HTTP), bundle de Claude Desktop, chart de Helm o uvx. Se necesita una clave de API local de UniFi del gateway; no hace falta cuenta en la nube. Un modo stub devuelve datos simulados para probarlo sin hardware. Una instancia puede gestionar varios controladores mediante un archivo YAML.

Qué puedes hacer

  • Gestionar VLAN, WLAN, reglas de firewall, reservas DHCP y reenvíos de puertos
  • Previsualizar cambios destructivos con dry-run antes de aplicarlos
  • Inspeccionar dispositivos, clientes y ajustes de radio de los AP
  • Leer cámaras, eventos de movimiento y detecciones inteligentes de UniFi Protect
  • Leer puertas, credenciales y eventos de credencial de UniFi Access
  • Gestionar varios sitios UniFi desde un solo servidor
  • Revisar un registro de auditoría JSONL de cada llamada a herramientas
  • Probar la superficie de herramientas en modo stub sin hardware

Herramientas

Los servidores locales muestran sus herramientas cuando están en marcha, así que no podemos mostrarlas aquí. Busca la lista en su documentación; tu cliente las muestra después de añadirlo.

Prompts de ejemplo

  • Lista todas las VLAN y WLAN de mi gateway UniFi.

  • Previsualiza con dry run la creación de una red IoT antes de aplicarla.

  • Audita los puertos abiertos en mis reglas de firewall y políticas de zona.

  • Muestra los eventos de movimiento recientes de mis cámaras Protect.

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

  1. Ejecútalo en un terminal, en la carpeta de tu proyecto:
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. Inicia Claude Code y escribe /mcp. unifi-gateway debería aparecer como conectado.

Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.

Claude Desktop

  1. Abre Settings → Developer → Edit Config. Se abre claude_desktop_config.json. Añade:
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. Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.

Necesita Docker en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.

Cursor

O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):

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

Necesita Docker en tu equipo. Sustituye los marcadores por tus propios valores.

VS Code

Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:

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

Necesita Docker en tu equipo.

Devin Desktop

  1. Añádelo a ~/.config/devin/mcp_config.json (macOS y 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. Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.

Devin Desktop es el nuevo nombre 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.0

O edita directamente ~/.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>" }

Necesita Docker en tu equipo. Sustituye los marcadores por tus propios valores.

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

Así lo añades al proyecto actual. Añade -s user para usarlo en todas partes.

Cualquier cliente

La mayoría de los clientes que inician servidores locales aceptan esta 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 pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.

Necesita Docker en tu equipo. Sustituye los marcadores por tus propios valores.

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

La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.

Insignia para README

Vista previa de la insignia, claraVista previa de la insignia, oscura
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

Prompt para la IA

Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de UniFi Gateway a tu web.

Markdown
Añade a mi web la tarjeta de mcp.tc de UniFi Gateway, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.

Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:

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

Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.

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

Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.

Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).

Para un README u otra documentación en Markdown, usa la insignia:

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

Referencia: https://mcp.tc/es/embed

Historial de cambios

Se ejecuta en tu ordenador y no tiene un paquete que podamos seguir. Aquí aparecen las ediciones de su responsable.

Sigue UniFi Gateway y te enviaremos un correo cuando algo cambie.

Todavía no hay nada registrado. Aquí aparecerán las ediciones del responsable del servidor.

Preguntas frecuentes

¿Puedo pegar mcp.tc/i/unifi-gateway en mi cliente MCP?

No. UniFi Gateway se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0.

¿UniFi Gateway necesita una clave de API?

Sí. Lee UNIFI_API_KEY y UNIFI_ACCESS_API_KEY de su entorno, y UNIFI_API_KEY y UNIFI_ACCESS_API_KEY son secretos. Pon los valores en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.

¿UniFi Gateway es un servidor remoto o local?

Local. Tu cliente lo inicia como un proceso en tu equipo con docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.25.0, que necesita Docker.

¿Qué puede hacer UniFi Gateway?

Puedes gestionar VLAN, WLAN, reglas de firewall, reservas DHCP y reenvíos de puertos, previsualizar cambios destructivos con dry-run antes de aplicarlos y inspeccionar dispositivos, clientes y ajustes de radio de los AP.

¿Qué clientes pueden usarlo?

Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.

¿mcp.tc sigue los cambios de UniFi Gateway?

En parte. UniFi Gateway se ejecuta en tu ordenador y no tiene un paquete que podamos seguir, así que su pestaña Historial solo muestra las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.

¿Quién escribió esta página?

El robot de mcp.tc leyó los metadatos públicos de UniFi Gateway (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.

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. La traducción la hizo un modelo de IA a partir del texto en inglés.