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

# 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 fue traducida automáticamente. Si encuentra errores o tiene sugerencias, [contáctenos](mailto:support@rhombus.com).
</Note>

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://api-docs.rhombus.community/mcp`
</Info>

## ¿Por qué usar el MCP de documentación?

<CardGroup cols={2}>
  <Card icon="book-open" title="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
  </Card>

  <Card icon="arrows-rotate" title="Siempre actualizado">
    Sincronizado automáticamente con la última documentación de la API de Rhombus
  </Card>

  <Card icon="brain" title="Asistencia con contexto">
    Las herramientas de IA entienden tu API y proporcionan respuestas precisas respaldadas por documentación
  </Card>

  <Card icon="rocket" title="Desarrollo más rápido">
    Obtén respuestas sobre endpoints, parámetros y ejemplos al instante mientras programas
  </Card>
</CardGroup>

## 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 API keys 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:

<Tabs>
  <Tab title="Claude Code">
    ### Añadir el MCP a Claude Code

    Claude Code facilita añadir servidores MCP con un solo comando.

    <Steps>
      <Step title="Abre la terminal">
        Abre tu terminal o símbolo del sistema
      </Step>

      <Step title="Ejecuta el comando MCP Add">
        Ejecuta el siguiente comando:

        ```bash theme={null}
        claude mcp add --transport http rhombus-docs https://api-docs.rhombus.community/mcp
        ```

        Esto añade el MCP de documentación de Rhombus con el nombre `rhombus-docs`.
      </Step>

      <Step title="Verifica la instalación">
        El MCP estará disponible inmediatamente en Claude Code. Puedes verificarlo preguntando:

        ```text theme={null}
        "Search the Rhombus documentation for camera endpoints"
        ```

        Claude Code ahora usará el MCP para recuperar documentación precisa.
      </Step>
    </Steps>

    ### 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?"
  </Tab>

  <Tab title="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.

    <Steps>
      <Step title="Abre la configuración de Claude">
        Haz clic en tu icono de perfil en Claude Desktop y selecciona **Settings**
      </Step>

      <Step title="Ve a Connectors">
        Ve a la sección **Connectors** en la configuración
      </Step>

      <Step title="Añade un conector personalizado">
        Haz clic en **Add custom connector** y completa:

        * **Name**: Rhombus Documentation
        * **URL**: `https://api-docs.rhombus.community/mcp`
        * **Type**: Model Context Protocol (MCP)
      </Step>

      <Step title="Guarda y prueba">
        Guarda el conector y pruébalo preguntando:

        ```text theme={null}
        "What camera APIs does Rhombus provide?"
        ```

        Claude ahora accederá a la documentación para responder tus preguntas.
      </Step>
    </Steps>

    <Tip>
      El conector aparecerá con un pequeño icono junto a las respuestas que utilizaron el MCP de documentación.
    </Tip>
  </Tab>

  <Tab title="Cursor">
    ### Añadir el MCP a Cursor

    Integra la documentación de Rhombus en Cursor para asistencia de programación con IA.

    <Steps>
      <Step title="Abre la paleta de comandos">
        Presiona `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux)
      </Step>

      <Step title="Busca la configuración de MCP">
        Escribe "Open MCP settings" y selecciónalo en la lista
      </Step>

      <Step title="Añade un servidor MCP personalizado">
        En el archivo de configuración de MCP, añade el servidor de documentación de Rhombus:

        ```json theme={null}
        {
          "mcpServers": {
            "rhombus-docs": {
              "url": "https://api-docs.rhombus.community/mcp",
              "transport": "http"
            }
          }
        }
        ```
      </Step>

      <Step title="Reinicia Cursor">
        Reinicia Cursor para cargar la nueva configuración de MCP
      </Step>

      <Step title="Verifica la integración">
        Usa las funciones de IA de Cursor y pregunta:

        ```text theme={null}
        "Search Rhombus docs for authentication methods"
        ```
      </Step>
    </Steps>

    ### 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
  </Tab>

  <Tab title="VS Code">
    ### Añadir el MCP a VS Code

    Configura el MCP de Rhombus para usarlo con extensiones de IA de VS Code.

    <Steps>
      <Step title="Crea la configuración del MCP">
        Crea un archivo `.vscode/mcp.json` en la raíz de tu workspace:

        ```bash theme={null}
        mkdir -p .vscode
        touch .vscode/mcp.json
        ```
      </Step>

      <Step title="Añade la configuración del servidor">
        Añade lo siguiente a `.vscode/mcp.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "rhombus-docs": {
              "url": "https://api-docs.rhombus.community/mcp",
              "transport": "http",
              "description": "Rhombus API Documentation"
            }
          }
        }
        ```
      </Step>

      <Step title="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
      </Step>

      <Step title="Úsalo en tu flujo de trabajo">
        El MCP estará disponible para tu asistente de IA. Haz preguntas como:

        ```text theme={null}
        "How do I get a list of cameras from Rhombus API?"
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="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://api-docs.rhombus.community/mcp`
    * **Transport**: HTTP
    * **Name**: rhombus-docs (o tu preferencia)

    **Ejemplo de configuración (JSON):**

    ```json theme={null}
    {
      "name": "rhombus-docs",
      "url": "https://api-docs.rhombus.community/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.
  </Tab>
</Tabs>

## Herramientas disponibles

El MCP de documentación de Rhombus proporciona las siguientes herramientas a los asistentes de IA:

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="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 theme={null}
    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.
  </Accordion>

  <Accordion icon="folder-tree" title="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 theme={null}
    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.
  </Accordion>

  <Accordion icon="comment" title="submit_feedback">
    **Reporta un problema en la documentación**

    Permite a los asistentes de IA señalar una página que sea incorrecta, esté desactualizada, sea confusa o esté incompleta, para que el equipo de documentación de Rhombus la revise. Úsala cuando detectes un error mientras navegas por la documentación.
  </Accordion>
</AccordionGroup>

## Flujos de trabajo de ejemplo

### Construir una integración de video

<Steps>
  <Step title="Pregunta sobre los endpoints de video">
    ```text theme={null}
    "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.
  </Step>

  <Step title="Obtén detalles de implementación">
    ```text theme={null}
    "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.
  </Step>

  <Step title="Pregunta sobre autenticación">
    ```text theme={null}
    "How do I authenticate for video streaming?"
    ```

    Proporciona detalles de autenticación con tokens federados y muestras de código.
  </Step>

  <Step title="Solicita ejemplos específicos">
    ```text theme={null}
    "Give me a complete JavaScript example for streaming video"
    ```

    Devuelve ejemplos de código funcionales tomados de la documentación.
  </Step>
</Steps>

### Explorar el control de acceso

<Steps>
  <Step title="Descubre endpoints">
    ```text theme={null}
    "List all access control endpoints in the Rhombus API"
    ```

    El MCP busca y devuelve una lista completa de endpoints de control de acceso.
  </Step>

  <Step title="Comprende los parámetros">
    ```text theme={null}
    "What parameters does createAccessGrant accept?"
    ```

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

  <Step title="Mira ejemplos">
    ```text theme={null}
    "Show me an example of creating an access grant"
    ```

    Proporciona ejemplos de código y patrones de uso de la documentación.
  </Step>
</Steps>

## Mejores prácticas

<CardGroup cols={2}>
  <Card icon="bullseye" title="Sé específico en tus consultas">
    Haz preguntas concretas sobre endpoints o funciones específicas para obtener mejores resultados
  </Card>

  <Card icon="tag" title="Refiere por nombre">
    Menciona "Rhombus API" o nombres específicos de endpoints para obtener documentación enfocada
  </Card>

  <Card icon="code" title="Solicita ejemplos de código">
    Pide explícitamente ejemplos de código cuando necesites ayuda con la implementación
  </Card>

  <Card icon="comments" title="Preguntas de seguimiento">
    Haz preguntas de seguimiento para profundizar en temas específicos
  </Card>
</CardGroup>

## Solución de problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="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://api-docs.rhombus.community/mcp`
    2. Comprueba tu conexión a internet
    3. Reinicia tu herramienta de IA
    4. Vuelve a añadir la configuración del MCP
  </Accordion>

  <Accordion icon="circle-xmark" title="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
  </Accordion>

  <Accordion icon="clock-rotate-left" title="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
  </Accordion>

  <Accordion icon="gear" title="La configuración no carga">
    **Para herramientas de línea de comandos:**

    ```bash theme={null}
    # Remove and re-add the MCP
    claude mcp remove rhombus-docs
    claude mcp add --transport http rhombus-docs https://api-docs.rhombus.community/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://api-docs.rhombus.community/mcp`
  </Accordion>
</AccordionGroup>

## 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, API keys ni información de usuarios a través del MCP.
</Info>

**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 API keys o credenciales
* Datos específicos de clientes
* Información privada de cuenta
* Funciones no lanzadas o documentación interna

## Recursos adicionales

<CardGroup cols={2}>
  <Card icon="file-lines" href="https://modelcontextprotocol.io" title="Especificación de Model Context Protocol">
    Aprende más sobre el estándar MCP
  </Card>

  <Card icon="circle-play" href="/es/implementations/video-player" title="Guía del reproductor de video">
    Ejemplos de implementación y tutoriales
  </Card>

  <Card icon="users" href="https://rhombus.community" title="Comunidad de desarrolladores">
    Obtén ayuda y comparte experiencias
  </Card>
</CardGroup>

## Comentarios

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

* **Comunidad**: Comparte tus comentarios en [rhombus.community](https://rhombus.community)
* **Email**: Contáctanos en [support@rhombus.com](mailto:support@rhombus.com)

<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.
</Note>