> ## Índice de la documentación > Consulta el índice completo de la documentación en: https://developer.rhombus.com/llms.txt > Úsalo para descubrir todas las páginas disponibles antes de seguir explorando. # 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 se tradujo automáticamente. Si encuentras errores o tienes sugerencias, [escríbenos](mailto:support@rhombus.com). 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](https://developer.rhombus.com/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 clave de API de Rhombus. > **Warning**: 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](https://console.rhombussystems.com/settings/integrations/api-tokens/), con el rol más limitado que necesite el asistente (consulta [Permisos](https://developer.rhombus.com/es/authentication/permissions#privilegio-mínimo)) - **Node.js 18+** (para npx) o **Docker** (para configuración basada en contenedores) ## Configuración **Claude Code** 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: ```text "List all my Rhombus cameras" ``` **Claude Desktop (npx)** 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" } } } } ``` > **Tip**: En macOS, este archivo se encuentra en `~/Library/Application Support/Claude/claude_desktop_config.json` **Claude Desktop (Docker)** 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" } } } } ``` **Cursor** 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. **Smithery** Instala automáticamente vía [Smithery](https://smithery.ai/server/@RhombusSystems/rhombus-node-mcp): ```bash npx -y @smithery/cli install @RhombusSystems/rhombus-node-mcp --client claude ``` ## Cuentas partner Con una clave de API de [partner](https://developer.rhombus.com/es/partner-api-calls), 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`](https://developer.rhombus.com/es/partner-api-calls#paso-1-lista-tus-organizaciones-cliente). ## Flujos de trabajo de ejemplo ### Monitorea tus cámaras Pregúntale a tu asistente de IA: ```text "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 "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 ```text "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 ```text "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 "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: 1. **Clona el repositorio** ```bash git clone https://github.com/RhombusSystems/rhombus-node-mcp.git cd rhombus-node-mcp ``` 2. **Instala las dependencias** ```bash npm install ``` 3. **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`. ## Contribuir El servidor MCP es de código abierto (licencia MIT). Puedes crear nuevas herramientas usando el scaffolding integrado: ```bash npm run create:tool ``` Esto genera el código base para una nueva herramienta en `src/tools/`. ## Recursos - **[Repositorio de GitHub](https://github.com/RhombusSystems/rhombus-node-mcp)**: Código fuente, issues y contribuciones - **[Paquete npm](https://www.npmjs.com/package/rhombus-node-mcp)**: Detalles del paquete e historial de versiones - **[Smithery](https://smithery.ai/server/@RhombusSystems/rhombus-node-mcp)**: Instalación con un clic para clientes compatibles - **[Comentarios de la beta](mailto:support@rhombus.com?subject=Rhombus%20MCP%20beta%20feedback)**: Comparte comentarios y ayuda a dar forma al desarrollo > **Note**: El servidor MCP de la API de Rhombus está en beta. Para preguntas o problemas, contacta a .