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

# Documentation MCP

> Connect Claude, Cursor, VS Code, and other AI tools directly to Rhombus API documentation using the Model Context Protocol (MCP) server.

The **Model Context Protocol (MCP)** is an open standard that creates standardized connections between AI applications and external services. Rhombus provides an MCP server that gives AI tools like Claude Code, Cursor, and Claude Desktop instant access to our complete API documentation.

<Info>
  **Quick Access**

  Rhombus Developer Documentation MCP Server: `https://api-docs.rhombus.community/mcp`
</Info>

## Why Use the Documentation MCP?

<CardGroup cols={2}>
  <Card icon="book-open" title="Instant Documentation Access">
    AI assistants can search and retrieve relevant documentation without leaving your workflow
  </Card>

  <Card icon="arrows-rotate" title="Always Up-to-Date">
    Automatically synced with the latest Rhombus API documentation
  </Card>

  <Card icon="brain" title="Context-Aware Assistance">
    AI tools understand your API and provide accurate, documentation-backed responses
  </Card>

  <Card icon="rocket" title="Faster Development">
    Get answers about endpoints, parameters, and examples instantly while coding
  </Card>
</CardGroup>

## What's Included

The Rhombus Documentation MCP provides:

* **Search Tool**: Query the complete Rhombus API documentation
* **Endpoint Information**: Details about all available API endpoints
* **Code Examples**: Access to implementation examples and best practices
* **Authentication Guide**: Information about API keys and authentication methods
* **Integration Patterns**: Video player implementations and advanced use cases

## Setup Instructions

Choose your AI tool below for setup instructions:

<Tabs>
  <Tab title="Claude Code">
    ### Add MCP to Claude Code

    Claude Code makes it simple to add MCP servers with a single command.

    <Steps>
      <Step title="Open Terminal">
        Open your terminal or command prompt
      </Step>

      <Step title="Run MCP Add Command">
        Execute the following command:

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

        This adds the Rhombus documentation MCP with the name `rhombus-docs`.
      </Step>

      <Step title="Verify Installation">
        The MCP will be immediately available in Claude Code. You can verify by asking:

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

        Claude Code will now use the MCP to retrieve accurate documentation.
      </Step>
    </Steps>

    ### Using the MCP in Claude Code

    Once configured, Claude Code will automatically:

    * Search documentation when you ask API-related questions
    * Reference specific endpoints when building integrations
    * Provide code examples from the documentation
    * Suggest best practices based on official guides

    **Example queries:**

    * "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">
    ### Add MCP to Claude Desktop

    Connect Claude Desktop to Rhombus documentation for instant API reference.

    <Steps>
      <Step title="Open Claude Settings">
        Click on your profile icon in Claude Desktop and select **Settings**
      </Step>

      <Step title="Navigate to Connectors">
        Go to the **Connectors** section in settings
      </Step>

      <Step title="Add Custom Connector">
        Click **Add custom connector** and fill in:

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

      <Step title="Save and Test">
        Save the connector and test it by asking:

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

        Claude will now access the documentation to answer your questions.
      </Step>
    </Steps>

    <Tip>
      The connector will appear with a small icon next to responses that used the documentation MCP.
    </Tip>
  </Tab>

  <Tab title="Cursor">
    ### Add MCP to Cursor

    Integrate Rhombus documentation into Cursor for AI-powered coding assistance.

    <Steps>
      <Step title="Open Command Palette">
        Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux)
      </Step>

      <Step title="Search for MCP Settings">
        Type "Open MCP settings" and select it from the list
      </Step>

      <Step title="Add Custom MCP Server">
        In the MCP settings file, add the Rhombus documentation server:

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

      <Step title="Restart Cursor">
        Restart Cursor to load the new MCP configuration
      </Step>

      <Step title="Verify Integration">
        Use Cursor's AI features and ask:

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

    ### Using in Cursor Composer

    When using Cursor Composer or Chat, the MCP enables:

    * Automatic documentation lookup during coding
    * Inline suggestions based on API documentation
    * Code generation using official examples
    * Real-time validation against API specifications
  </Tab>

  <Tab title="VS Code">
    ### Add MCP to VS Code

    Configure the Rhombus MCP for use with VS Code AI extensions.

    <Steps>
      <Step title="Create MCP Configuration">
        Create a `.vscode/mcp.json` file in your workspace root:

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

      <Step title="Add Server Configuration">
        Add the following to `.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="Install MCP-Compatible Extension">
        Install an AI extension that supports MCP, such as:

        * Continue
        * Cody
        * Other MCP-compatible VS Code extensions
      </Step>

      <Step title="Use in Your Workflow">
        The MCP will be available to your AI assistant. Ask questions like:

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

  <Tab title="Other Tools">
    ### Generic MCP Configuration

    Most MCP-compatible tools follow a similar pattern:

    **Connection Details:**

    * **Server URL**: `https://api-docs.rhombus.community/mcp`
    * **Transport**: HTTP
    * **Name**: rhombus-docs (or your preference)

    **Configuration Example (JSON):**

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

    **Supported Tools:**

    * Goose AI
    * Any MCP-compatible AI assistant
    * Custom integrations using MCP SDK

    Check your tool's documentation for specific MCP configuration instructions.
  </Tab>
</Tabs>

## Available Tools

The Rhombus Documentation MCP provides the following tools to AI assistants:

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="search-documentation">
    **Search the complete Rhombus documentation**

    This tool allows AI assistants to search through all documentation pages, including:

    * API endpoint references
    * Authentication guides
    * Implementation examples
    * Video player documentation
    * Best practices and tutorials

    **Example Usage:**

    ```text theme={null}
    Tool: search-documentation
    Query: "camera video streaming endpoints"
    ```

    **Results:** Returns relevant documentation snippets with links to full pages.
  </Accordion>

  <Accordion icon="route" title="get-endpoint-details">
    **Retrieve detailed information about specific API endpoints**

    Get comprehensive details about Rhombus API endpoints including:

    * Request parameters
    * Response schemas
    * Authentication requirements
    * Code examples
    * Error codes

    **Example Usage:**

    ```text theme={null}
    Tool: get-endpoint-details
    Endpoint: "/api/camera/getMediaUris"
    ```

    **Results:** Complete endpoint documentation with examples and parameters.
  </Accordion>

  <Accordion icon="code" title="search-code-examples">
    **Find implementation examples and code snippets**

    Search through code examples for:

    * Video player implementations
    * Authentication flows
    * API integration patterns
    * Multi-camera synchronization
    * Timestamp extraction

    **Example Usage:**

    ```text theme={null}
    Tool: search-code-examples
    Topic: "DashJS player setup"
    ```

    **Results:** Relevant code examples with context and explanations.
  </Accordion>
</AccordionGroup>

## Example Workflows

### Building a Video Integration

<Steps>
  <Step title="Ask About Video Endpoints">
    ```text theme={null}
    "What endpoints do I need to stream video from a Rhombus camera?"
    ```

    The MCP will search documentation and provide relevant endpoints with descriptions.
  </Step>

  <Step title="Get Implementation Details">
    ```text theme={null}
    "Show me how to implement the DashJS video player"
    ```

    Retrieves the complete video player implementation guide with code examples.
  </Step>

  <Step title="Ask About Authentication">
    ```text theme={null}
    "How do I authenticate for video streaming?"
    ```

    Provides federated token authentication details and code samples.
  </Step>

  <Step title="Request Specific Examples">
    ```text theme={null}
    "Give me a complete JavaScript example for streaming video"
    ```

    Returns working code examples from the documentation.
  </Step>
</Steps>

### Exploring Access Control

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

    MCP searches and returns comprehensive list of access control endpoints.
  </Step>

  <Step title="Understand Parameters">
    ```text theme={null}
    "What parameters does createAccessGrant accept?"
    ```

    Retrieves detailed parameter documentation for the specific endpoint.
  </Step>

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

    Provides code examples and usage patterns from documentation.
  </Step>
</Steps>

## Best Practices

<CardGroup cols={2}>
  <Card icon="bullseye" title="Be Specific in Queries">
    Ask targeted questions about specific endpoints or features for better results
  </Card>

  <Card icon="tag" title="Reference by Name">
    Mention "Rhombus API" or specific endpoint names to get focused documentation
  </Card>

  <Card icon="code" title="Request Code Examples">
    Explicitly ask for code examples when you need implementation help
  </Card>

  <Card icon="comments" title="Follow Up Questions">
    Ask follow-up questions to drill deeper into specific topics
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="MCP Not Responding">
    **Possible causes:**

    * MCP server URL is incorrect
    * Network connectivity issues
    * Tool needs to be restarted

    **Solutions:**

    1. Verify the URL: `https://api-docs.rhombus.community/mcp`
    2. Check your internet connection
    3. Restart your AI tool
    4. Re-add the MCP configuration
  </Accordion>

  <Accordion icon="circle-xmark" title="No Results Found">
    **Try these approaches:**

    * Rephrase your question more specifically
    * Use exact endpoint names or feature names
    * Break complex questions into simpler queries
    * Check if you're asking about a feature that exists in Rhombus API
  </Accordion>

  <Accordion icon="clock-rotate-left" title="Outdated Information">
    The MCP server automatically syncs with the latest documentation. If you suspect outdated information:

    * The documentation may have been recently updated
    * Try rephrasing to get different results
    * Verify against the online documentation
  </Accordion>

  <Accordion icon="gear" title="Configuration Not Loading">
    **For command-line tools:**

    ```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
    ```

    **For GUI tools:**

    * Remove the MCP configuration
    * Restart the application
    * Re-add the configuration
    * Verify the URL is exactly: `https://api-docs.rhombus.community/mcp`
  </Accordion>
</AccordionGroup>

## Privacy & Security

<Info>
  **Data Privacy**

  The MCP server only provides access to public Rhombus API documentation. No private data, API keys, or user information is transmitted through the MCP.
</Info>

**What the MCP provides:**

* Public API documentation
* Code examples
* Integration guides
* Best practices

**What the MCP does NOT provide:**

* Your API keys or credentials
* Customer-specific data
* Private account information
* Unreleased features or internal documentation

## Additional Resources

<CardGroup cols={2}>
  <Card icon="file-lines" href="https://modelcontextprotocol.io" title="Model Context Protocol Spec">
    Learn more about the MCP standard
  </Card>

  <Card icon="circle-play" href="/implementations/video-player" title="Video Player Guide">
    Implementation examples and tutorials
  </Card>

  <Card icon="users" href="https://rhombus.community" title="Developer Community">
    Get help and share experiences
  </Card>
</CardGroup>

## Feedback

Have suggestions for improving the Documentation MCP?

* **Community**: Share feedback at [rhombus.community](https://rhombus.community)
* **Email**: Reach out to [support@rhombus.com](mailto:support@rhombus.com)

<Note>
  The Documentation MCP is continuously improved based on developer feedback and usage patterns. Check back for new features and capabilities.
</Note>
