> ## Í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. # MCP de documentación > Conecta Claude, Cursor, VS Code y otras herramientas de IA a la documentación de la API de Rhombus mediante el servidor Model Context Protocol. > **Note**: Esta página se tradujo automáticamente. Si encuentras errores o tienes sugerencias, [escríbenos](mailto:support@rhombus.com). El **Model Context Protocol (MCP)** es un estándar abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos. Rhombus proporciona un servidor MCP que da a herramientas de IA como Claude Code, Cursor y Claude Desktop acceso instantáneo a toda nuestra documentación de API. > **Info**: **Acceso rápido** > > Servidor MCP de documentación para desarrolladores de Rhombus: `https://developer.rhombus.com/mcp` ## ¿Por qué usar el MCP de documentación? - **Acceso instantáneo a la documentación**: Los asistentes de IA pueden buscar y recuperar documentación relevante sin salir de tu flujo de trabajo - **Siempre actualizado**: Sincronizado automáticamente con la última documentación de la API de Rhombus - **Asistencia con contexto**: Las herramientas de IA entienden tu API y proporcionan respuestas precisas respaldadas por documentación - **Desarrollo más rápido**: Obtén respuestas sobre endpoints, parámetros y ejemplos al instante mientras programas ## Qué incluye El MCP de documentación de Rhombus proporciona: - **Herramienta de búsqueda**: Consulta toda la documentación de la API de Rhombus - **Información de endpoints**: Detalles de todos los endpoints de API disponibles - **Ejemplos de código**: Acceso a ejemplos de implementación y mejores prácticas - **Guía de autenticación**: Información sobre claves de API y métodos de autenticación - **Patrones de integración**: Implementaciones del reproductor de video y casos de uso avanzados ## Instrucciones de configuración Elige tu herramienta de IA a continuación para ver las instrucciones de configuración: **Claude Code** ### Añadir el MCP a Claude Code Claude Code facilita añadir servidores MCP con un solo comando. 1. **Abre la terminal** Abre tu terminal o símbolo del sistema 2. **Ejecuta el comando MCP Add** Ejecuta el siguiente comando: ```bash claude mcp add --transport http rhombus-docs https://developer.rhombus.com/mcp ``` Esto añade el MCP de documentación de Rhombus con el nombre `rhombus-docs`. 3. **Verifica la instalación** El MCP estará disponible inmediatamente en Claude Code. Puedes verificarlo preguntando: ```text "Search the Rhombus documentation for camera endpoints" ``` Claude Code ahora usará el MCP para recuperar documentación precisa. ### Usar el MCP en Claude Code Una vez configurado, Claude Code automáticamente: - Busca en la documentación cuando haces preguntas relacionadas con la API - Hace referencia a endpoints específicos al construir integraciones - Proporciona ejemplos de código de la documentación - Sugiere mejores prácticas basadas en las guías oficiales **Consultas de ejemplo:** - "How do I authenticate with the Rhombus API?" - "Show me camera endpoints for retrieving video" - "What parameters does the access control API accept?" - "How do I implement the video player?" **Claude Desktop** ### Añadir el MCP a Claude Desktop Conecta Claude Desktop a la documentación de Rhombus para tener una referencia instantánea de la API. 1. **Abre la configuración de Claude** Haz clic en tu icono de perfil en Claude Desktop y selecciona **Settings** 2. **Ve a Connectors** Ve a la sección **Connectors** en la configuración 3. **Añade un conector personalizado** Haz clic en **Add custom connector** y completa: - **Name**: Rhombus Documentation - **URL**: `https://developer.rhombus.com/mcp` - **Type**: Model Context Protocol (MCP) 4. **Guarda y prueba** Guarda el conector y pruébalo preguntando: ```text "What camera APIs does Rhombus provide?" ``` Claude ahora accederá a la documentación para responder tus preguntas. > **Tip**: El conector aparecerá con un pequeño icono junto a las respuestas que utilizaron el MCP de documentación. **Cursor** ### Añadir el MCP a Cursor Integra la documentación de Rhombus en Cursor para asistencia de programación con IA. 1. **Abre la paleta de comandos** Presiona `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux) 2. **Busca la configuración de MCP** Escribe "Open MCP settings" y selecciónalo en la lista 3. **Añade un servidor MCP personalizado** En el archivo de configuración de MCP, añade el servidor de documentación de Rhombus: ```json { "mcpServers": { "rhombus-docs": { "url": "https://developer.rhombus.com/mcp", "transport": "http" } } } ``` 4. **Reinicia Cursor** Reinicia Cursor para cargar la nueva configuración de MCP 5. **Verifica la integración** Usa las funciones de IA de Cursor y pregunta: ```text "Search Rhombus docs for authentication methods" ``` ### Usar en Cursor Composer Cuando usas Cursor Composer o Chat, el MCP permite: - Búsqueda automática de documentación durante la programación - Sugerencias en línea basadas en la documentación de la API - Generación de código usando ejemplos oficiales - Validación en tiempo real contra las especificaciones de la API **VS Code** ### Añadir el MCP a VS Code Configura el MCP de Rhombus para usarlo con extensiones de IA de VS Code. 1. **Crea la configuración del MCP** Crea un archivo `.vscode/mcp.json` en la raíz de tu workspace: ```bash mkdir -p .vscode touch .vscode/mcp.json ``` 2. **Añade la configuración del servidor** Añade lo siguiente a `.vscode/mcp.json`: ```json { "mcpServers": { "rhombus-docs": { "url": "https://developer.rhombus.com/mcp", "transport": "http", "description": "Rhombus API Documentation" } } } ``` 3. **Instala una extensión compatible con MCP** Instala una extensión de IA que admita MCP, como: - Continue - Cody - Otras extensiones de VS Code compatibles con MCP 4. **Úsalo en tu flujo de trabajo** El MCP estará disponible para tu asistente de IA. Haz preguntas como: ```text "How do I get a list of cameras from Rhombus API?" ``` **Otras herramientas** ### Configuración genérica del MCP La mayoría de las herramientas compatibles con MCP siguen un patrón similar: **Detalles de conexión:** - **Server URL**: `https://developer.rhombus.com/mcp` - **Transport**: HTTP - **Name**: rhombus-docs (o tu preferencia) **Ejemplo de configuración (JSON):** ```json { "name": "rhombus-docs", "url": "https://developer.rhombus.com/mcp", "transport": "http" } ``` **Herramientas compatibles:** - Goose AI - Cualquier asistente de IA compatible con MCP - Integraciones personalizadas usando el SDK de MCP Consulta la documentación de tu herramienta para ver instrucciones específicas de configuración del MCP. ## Herramientas disponibles El MCP de documentación de Rhombus proporciona las siguientes herramientas a los asistentes de IA: **search_rhombus_developer** **Busca en toda la documentación de Rhombus** Esta herramienta permite a los asistentes de IA buscar en todas las páginas de documentación, incluyendo: - Referencias de endpoints de API - Guías de autenticación - Ejemplos de implementación - Documentación del reproductor de video - Mejores prácticas y tutoriales **Ejemplo de uso:** ```text Tool: search_rhombus_developer Query: "camera video streaming endpoints" ``` **Resultados:** Devuelve fragmentos de documentación relevantes con enlaces a las páginas completas. Pasa un código de `language` opcional (por ejemplo `es`) para buscar en una versión traducida. **query_docs_filesystem_rhombus_developer** **Lee páginas de documentación y especificaciones OpenAPI directamente** Ejecuta comandos de solo lectura, similares a los de shell, sobre un sistema de archivos en memoria que contiene todas las páginas de documentación (como `.mdx`) y las especificaciones OpenAPI: - `ls` / `tree` para explorar la estructura de la documentación - `cat` / `head` para leer una página completa - `rg` para coincidencias exactas por palabra clave o expresión regular Así es como los asistentes de IA leen una página completa: no existe una herramienta independiente para "obtener la página". **Ejemplo de uso:** ```text Tool: query_docs_filesystem_rhombus_developer Command: head -200 /api-reference/overview.mdx ``` **Resultados:** Devuelve el contenido sin procesar de la página o las coincidencias de búsqueda del sistema de archivos de documentación. ## Flujos de trabajo de ejemplo ### Construir una integración de video 1. **Pregunta sobre los endpoints de video** ```text "What endpoints do I need to stream video from a Rhombus camera?" ``` El MCP buscará en la documentación y proporcionará los endpoints relevantes con descripciones. 2. **Obtén detalles de implementación** ```text "Show me how to implement the DashJS video player" ``` Recupera la guía completa de implementación del reproductor de video con ejemplos de código. 3. **Pregunta sobre autenticación** ```text "How do I authenticate for video streaming?" ``` Proporciona detalles de autenticación con tokens federados y muestras de código. 4. **Solicita ejemplos específicos** ```text "Give me a complete JavaScript example for streaming video" ``` Devuelve ejemplos de código funcionales tomados de la documentación. ### Explorar el control de acceso 1. **Descubre endpoints** ```text "List all access control endpoints in the Rhombus API" ``` El MCP busca y devuelve una lista completa de endpoints de control de acceso. 2. **Comprende los parámetros** ```text "What parameters does createAccessGrant accept?" ``` Recupera la documentación detallada de parámetros para el endpoint específico. 3. **Mira ejemplos** ```text "Show me an example of creating an access grant" ``` Proporciona ejemplos de código y patrones de uso de la documentación. ## Mejores prácticas - **Sé específico en tus consultas**: Haz preguntas concretas sobre endpoints o funciones específicas para obtener mejores resultados - **Refiere por nombre**: Menciona "Rhombus API" o nombres específicos de endpoints para obtener documentación enfocada - **Solicita ejemplos de código**: Pide explícitamente ejemplos de código cuando necesites ayuda con la implementación - **Preguntas de seguimiento**: Haz preguntas de seguimiento para profundizar en temas específicos ## Solución de problemas **El MCP no responde** **Posibles causas:** - La URL del servidor MCP es incorrecta - Problemas de conectividad de red - La herramienta necesita reiniciarse **Soluciones:** 1. Verifica la URL: `https://developer.rhombus.com/mcp` 2. Comprueba tu conexión a internet 3. Reinicia tu herramienta de IA 4. Vuelve a añadir la configuración del MCP **No se encuentran resultados** **Prueba estos enfoques:** - Reformula tu pregunta de forma más específica - Usa nombres exactos de endpoints o funciones - Divide preguntas complejas en consultas más simples - Verifica si estás preguntando por una función que existe en la API de Rhombus **Información desactualizada** El servidor MCP se sincroniza automáticamente con la última documentación. Si sospechas que la información está desactualizada: - La documentación pudo haberse actualizado recientemente - Intenta reformular para obtener resultados diferentes - Verifica contra la documentación en línea **La configuración no carga** **Para herramientas de línea de comandos:** ```bash # Remove and re-add the MCP claude mcp remove rhombus-docs claude mcp add --transport http rhombus-docs https://developer.rhombus.com/mcp ``` **Para herramientas con interfaz gráfica:** - Elimina la configuración del MCP - Reinicia la aplicación - Vuelve a añadir la configuración - Verifica que la URL sea exactamente: `https://developer.rhombus.com/mcp` ## Privacidad y seguridad > **Info**: **Privacidad de datos** > > El servidor MCP solo proporciona acceso a la documentación pública de la API de Rhombus. No se transmiten datos privados, claves de API ni información de usuarios a través del MCP. **Lo que el MCP proporciona:** - Documentación pública de la API - Ejemplos de código - Guías de integración - Mejores prácticas **Lo que el MCP NO proporciona:** - Tus claves de API o credenciales - Datos específicos de clientes - Información privada de cuenta - Funciones no lanzadas o documentación interna ## Recursos adicionales - **[Especificación de Model Context Protocol](https://modelcontextprotocol.io)**: Aprende más sobre el estándar MCP - **[Guía del reproductor de video](https://developer.rhombus.com/es/implementations/video-player)**: Ejemplos de implementación y tutoriales - **[Soporte de Rhombus](mailto:support@rhombus.com)**: Contacta al Soporte de Rhombus para obtener ayuda con tu integración. ## Comentarios ¿Tienes sugerencias para mejorar el MCP de documentación? - **Email**: Contáctanos en > **Note**: El MCP de documentación se mejora continuamente con base en los comentarios y patrones de uso de los desarrolladores. Vuelve a consultar para ver nuevas funciones y capacidades.