> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP de la API de Rhombus

> Da a Claude y a otros asistentes de IA acceso directo a tus cámaras, puertas, sensores y alertas de Rhombus a través del servidor Node.js del Model Context Protocol (MCP).

<Note>
  Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, [contáctenos](mailto:support@rhombus.com).
</Note>

El **servidor MCP de la API de Rhombus** conecta herramientas de IA directamente con tu plataforma de seguridad Rhombus. A diferencia del [MCP de documentación](/es/documentation-mcp) (que busca en los docs), este servidor da a los asistentes de IA la capacidad de **realizar acciones** —listar cámaras, extraer clips, administrar puertas, revisar alertas y más— usando tu API key de Rhombus.

<Warning>
  Este servidor MCP interactúa con tu entorno de Rhombus en vivo. Las acciones realizadas a través de herramientas de IA (desbloquear puertas, reiniciar cámaras, etc.) son reales. Úsalo con la precaución adecuada.
</Warning>

## Lo que puedes hacer

El servidor ofrece más de 30 herramientas organizadas por capacidad:

<AccordionGroup>
  <Accordion title="Cámaras y video" icon="video">
    * **camera-tool** — Lista cámaras, obtén detalles de cámaras, consulta estado y salud
    * **clips-tool** — Busca y recupera clips de video guardados (manuales y disparados por políticas)
    * **video-walls-tool** — Administra configuraciones de video walls para el monitoreo de múltiples cámaras
    * **reboot-cameras** — Reinicia cámaras de forma remota
    * **camera-uptime-tool** — Consulta el tiempo de actividad y el historial de conectividad de las cámaras
  </Accordion>

  <Accordion title="Control de acceso y puertas" icon="door-open">
    * **access-control-tool** — Administra sistemas de control de acceso, credenciales y usuarios
    * **door-tool** — Bloquea, desbloquea y monitorea el estado de las puertas
    * **door-schedule-exception-tool** — Crea y administra excepciones de horario de puertas
    * **guest-management-tool** — Administra el acceso de invitados y las credenciales de visitantes
  </Accordion>

  <Accordion title="Seguridad y monitoreo" icon="shield-check">
    * **alarm-monitoring-tool** — Consulta el estado del monitoreo, administra casos de amenaza
    * **policy-alerts-tool** — Revisa y descarta alertas disparadas por políticas (movimiento, detección de personas, etc.)
    * **events-tool** — Consulta eventos de seguridad y registros de actividad
    * **rules-tool** — Administra reglas de automatización y disparadores
  </Accordion>

  <Accordion title="Analítica y búsqueda" icon="chart-line">
    * **analytics-tool** — Utilización del espacio, patrones de tráfico y análisis de escena en tiempo real
    * **search-tool** — Busca en cámaras, eventos y entidades
    * **count-tool** — Conteo de personas y datos de ocupación
    * **faces-tool** — Búsqueda de personas por reconocimiento facial
    * **lpr-tool** — Búsquedas por reconocimiento de placas de matrícula
  </Accordion>

  <Accordion title="Organización y usuarios" icon="building">
    * **user-tool** — Administra usuarios y permisos
    * **user-audit-tool** — Revisa los registros de auditoría de la actividad de los usuarios
    * **user-access-trail-tool** — Rastrea el historial de acceso de los usuarios
    * **location-tool** — Administra ubicaciones y la configuración del sitio
    * **get-org-information** — Recupera los detalles de la organización
    * **report-tool** — Genera y recupera reportes
  </Accordion>

  <Accordion title="Utilidades" icon="wrench">
    * **entity-lookup-tool** — Busca cualquier entidad por UUID
    * **get-entity-tool** — Obtén información detallada de una entidad
    * **time-tool** — Utilidades de hora actual
    * **time-conversion-tool** — Convierte entre formatos de hora y zonas horarias
    * **update-tool** — Actualiza propiedades de entidades
  </Accordion>
</AccordionGroup>

## Requisitos previos

* Una organización de Rhombus con acceso a la API habilitado
* Una API key generada desde la [Consola de Rhombus](https://console.rhombussystems.com/settings/api-management/)
* **Node.js 18+** (para npx) o **Docker** (para configuración basada en contenedores)

## Configuración

<Tabs>
  <Tab title="Claude Code">
    Agrega el servidor MCP de Rhombus con un solo comando:

    ```bash theme={null}
    claude mcp add rhombus -- npx --yes --package rhombus-node-mcp mcp-server-rhombus
    ```

    Establece tu API key como variable de entorno:

    ```bash theme={null}
    export RHOMBUS_API_KEY=YOUR_API_KEY
    ```

    Verifica preguntándole a Claude Code:

    ```text theme={null}
    "List all my Rhombus cameras"
    ```
  </Tab>

  <Tab title="Claude Desktop (npx)">
    Agrega a tu `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "rhombus": {
          "command": "npx",
          "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
          "env": {
            "RHOMBUS_API_KEY": "YOUR_API_KEY"
          }
        }
      }
    }
    ```

    <Tip>
      En macOS, este archivo se encuentra en `~/Library/Application Support/Claude/claude_desktop_config.json`
    </Tip>
  </Tab>

  <Tab title="Claude Desktop (Docker)">
    Ejecuta vía Docker para un entorno aislado:

    ```json theme={null}
    {
      "mcpServers": {
        "rhombus": {
          "command": "docker",
          "args": [
            "run", "-i", "--rm",
            "-e", "RHOMBUS_API_KEY=YOUR_API_KEY",
            "rhombussystems/mcp-server-rhombus"
          ],
          "env": {
            "RHOMBUS_API_KEY": "YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Agrega a tu configuración de MCP de Cursor (`Cmd+Shift+P` → "Open MCP settings"):

    ```json theme={null}
    {
      "mcpServers": {
        "rhombus": {
          "command": "npx",
          "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
          "env": {
            "RHOMBUS_API_KEY": "YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Reinicia Cursor después de guardar.
  </Tab>

  <Tab title="Smithery">
    Instala automáticamente vía [Smithery](https://smithery.ai/server/@RhombusSystems/rhombus-node-mcp):

    ```bash theme={null}
    npx -y @smithery/cli install @RhombusSystems/rhombus-node-mcp --client claude
    ```
  </Tab>
</Tabs>

## Flujos de trabajo de ejemplo

### Monitorea tus cámaras

Pregúntale a tu asistente de IA:

```text theme={null}
"Show me the status of all my cameras. Are any offline?"
```

El asistente usa la **camera-tool** para listar cámaras y comprobar el estado de conectividad.

### Revisa las alertas de seguridad

```text theme={null}
"What policy alerts happened in the last 24 hours? Show me the most critical ones."
```

El asistente usa la **policy-alerts-tool** para consultar alertas recientes y la **events-tool** para los detalles.

### Administra el acceso a puertas

```text theme={null}
"Unlock the main entrance door for 30 seconds, then lock it again."
```

El asistente usa la **door-tool** para controlar las cerraduras de las puertas en tiempo real.

### Busca vehículos

```text theme={null}
"Has a red Toyota been seen in any camera in the last week?"
```

El asistente usa la **lpr-tool** para buscar datos de reconocimiento de placas de matrícula en tus cámaras.

### Genera un reporte

```text theme={null}
"Give me a summary of foot traffic at the front entrance over the past month."
```

El asistente usa la **analytics-tool** y la **count-tool** para los datos de ocupación y tráfico.

## Ejecución local

Para compilar y ejecutar desde el código fuente:

<Steps>
  <Step title="Clona el repositorio">
    ```bash theme={null}
    git clone https://github.com/RhombusSystems/rhombus-node-mcp.git
    cd rhombus-node-mcp
    ```
  </Step>

  <Step title="Instala las dependencias">
    ```bash theme={null}
    npm install
    ```
  </Step>

  <Step title="Compila y ejecuta con Docker">
    ```bash theme={null}
    docker build -t mcp-server-rhombus .
    ```

    Luego actualiza tu configuración de MCP para usar el nombre de imagen local `mcp-server-rhombus` en lugar de `rhombussystems/mcp-server-rhombus`.
  </Step>
</Steps>

## Contribuir

El servidor MCP es de código abierto (licencia MIT). Puedes crear nuevas herramientas usando el scaffolding integrado:

```bash theme={null}
npm run create:tool
```

Esto genera el código base para una nueva herramienta en `src/tools/`.

## Recursos

<CardGroup cols={2}>
  <Card title="Repositorio de GitHub" icon="github" href="https://github.com/RhombusSystems/rhombus-node-mcp">
    Código fuente, issues y contribuciones
  </Card>

  <Card title="Paquete npm" icon="npm" href="https://www.npmjs.com/package/rhombus-node-mcp">
    Detalles del paquete e historial de versiones
  </Card>

  <Card title="Smithery" icon="hammer" href="https://smithery.ai/server/@RhombusSystems/rhombus-node-mcp">
    Instalación con un clic para clientes compatibles
  </Card>

  <Card title="Comentarios de la beta" icon="comment" href="https://rhmbs.link/beta_test">
    Comparte comentarios y ayuda a dar forma al desarrollo
  </Card>
</CardGroup>

<Note>
  El servidor MCP de la API de Rhombus está en beta. Para preguntas o problemas, contacta a [support@rhombus.com](mailto:support@rhombus.com) o visita [rhombus.community](https://rhombus.community).
</Note>