Ir al contenido

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.

En esta página

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.

Información

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:

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:

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

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:

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:

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
    "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
    "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
    "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
    "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
    "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
    "What parameters does createAccessGrant accept?"

    Recupera la documentación detallada de parámetros para el endpoint específico.

  3. Mira ejemplos
    "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

Información

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

Comentarios

¿Tienes sugerencias para mejorar el MCP de documentación?