Servidor MCP de la API de Rhombus - Documentación para desarrolladores de Rhombus

Nota

Esta página se tradujo automáticamente. Si encuentras errores o tienes sugerencias, escríbenos.

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 (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 clave de API de Rhombus.

Advertencia

Este servidor MCP actúa sobre tu organización de Rhombus en vivo: las herramientas que desbloquean puertas, cambian bloqueos o reinician dispositivos actúan en el mundo real. Por defecto, da al asistente una clave con un rol de solo lectura. Si debe realizar acciones, usa una clave aparte cuyo rol cubra solo esos dispositivos, y mantén activada en tu cliente MCP la confirmación de las llamadas a herramientas, para que una persona apruebe cada acción.

Lo que puedes hacer

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

Cámaras y 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

Control de acceso y puertas

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

Seguridad y monitoreo

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

Analítica y búsqueda

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

Organización y usuarios

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

Utilidades

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

Requisitos previos

Una organización de Rhombus con acceso a la API habilitado
Una clave de API generada desde la Consola de Rhombus, con el rol más limitado que necesite el asistente (consulta Permisos)
Node.js 18+ (para npx) o Docker (para configuración basada en contenedores)

Configuración

Agrega el servidor MCP de Rhombus con un solo comando:

bash

claude mcp add rhombus -- npx --yes --package rhombus-node-mcp mcp-server-rhombus

Establece tu clave de API como variable de entorno:

bash

export RHOMBUS_API_KEY=YOUR_API_KEY

Verifica preguntándole a Claude Code:

"List all my Rhombus cameras"

Agrega a tu claude_desktop_config.json:

json

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

Consejo

En macOS, este archivo se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json

Ejecuta vía Docker para un entorno aislado:

json

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

Agrega a tu configuración de MCP de Cursor (Cmd+Shift+P → "Open MCP settings"):

json

{
  "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.

Instala automáticamente vía Smithery:

bash

npx -y @smithery/cli install @RhombusSystems/rhombus-node-mcp --client claude

Cuentas partner

Con una clave de API de partner, el servidor puede actuar en una de tus organizaciones cliente. Define RHOMBUS_PARTNER_ORG con el UUID de la organización cliente junto a RHOMBUS_API_KEY:

json

{
  "mcpServers": {
    "rhombus": {
      "command": "npx",
      "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_PARTNER_API_KEY",
        "RHOMBUS_PARTNER_ORG": "CLIENT_ORG_UUID"
      }
    }
  }
}

Con el transporte HTTP, envía en su lugar el UUID de la organización cliente en el encabezado x-auth-org. Obtén la lista de tus organizaciones cliente y sus UUID con getClientsV2.

Flujos de trabajo de ejemplo

Monitorea tus cámaras

Pregúntale a tu asistente de IA:

"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

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

Revisa la actividad de las puertas

"Which doors were held open or forced open today?"

El asistente usa la door-tool para leer el estado y los eventos de las puertas.

Busca vehículos

"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

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

Clona el repositorio

bash

git clone https://github.com/RhombusSystems/rhombus-node-mcp.git
cd rhombus-node-mcp

Instala las dependencias
bash
```
npm install
```
Compila y ejecuta con Docker
bash
```
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.