> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userplane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentation MCP

> Connect AI tools like Claude, Codex, Cursor, and VS Code directly to Userplane documentation via MCP

<Note>
  This is the **documentation** MCP server — for AI tools to search Userplane docs inline while you
  integrate the SDK. To connect AI agents to your workspace for recording analysis and debugging,
  see [Userplane MCP](/integrations/mcp-workspace) instead.
</Note>

Userplane's Documentation MCP server gives AI tools like Claude, Codex, Cursor, Goose, and ChatGPT direct access to the Userplane docs — so they can search them inline while generating responses, rather than relying on web search.

## Connect to your AI tool

The Documentation MCP server is available at:

```
https://docs.userplane.io/mcp
```

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Open Connectors">
        Navigate to the **Connectors** page in your [Claude settings](https://claude.ai/settings).
      </Step>

      <Step title="Add a custom connector">
        Select **Add custom connector**.
      </Step>

      <Step title="Enter server details">
        Enter a name (e.g., `userplane-docs`) and the MCP server URL:

        ```
        https://docs.userplane.io/mcp
        ```

        Select **Add**.
      </Step>

      <Step title="Use it in a conversation">
        Open a new conversation, select the attachments button (the **+** icon), then select your Userplane connector.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Run the following command in your terminal:

    ```bash theme={null}
    claude mcp add --transport http userplane-docs https://docs.userplane.io/mcp
    ```

    Verify the connection:

    ```bash theme={null}
    claude mcp list
    ```

    The `userplane-docs` server should appear in the list.

    <Note>
      See the [Claude Code documentation](https://code.claude.com/docs/en/mcp#installing-mcp-servers) for more details.
    </Note>
  </Tab>

  <Tab title="Codex">
    The [Userplane Codex plugin](/integrations/codex) installs the documentation MCP server automatically alongside the workspace server.

    ```bash theme={null}
    codex marketplace add userplanehq/userplane-agent
    ```

    Then open `/plugins` in Codex and install `userplane`. Verify with:

    ```text theme={null}
    /mcp
    ```

    You should see `userplane-docs`.
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Open the command palette">
        Press `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows).
      </Step>

      <Step title="Open MCP settings">
        Search for **Open MCP settings** and select it. This opens `mcp.json`.
      </Step>

      <Step title="Configure the server">
        Add Userplane to the `mcpServers` object:

        ```json theme={null}
        {
          "mcpServers": {
            "userplane-docs": {
              "url": "https://docs.userplane.io/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Test the connection">
        In Cursor's chat, ask *"What tools do you have available?"* — Cursor should list the Userplane Documentation MCP server.
      </Step>
    </Steps>

    <Note>
      See [Installing MCP servers](https://cursor.com/docs#installing-mcp-servers) in the Cursor documentation for more details.
    </Note>

    <Tip>
      The [Userplane Cursor plugin](/integrations/cursor) installs `userplane-docs` automatically
      alongside the workspace MCP server.
    </Tip>
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Create the config file">
        Create a `.vscode/mcp.json` file in your project root.
      </Step>

      <Step title="Configure the server">
        Add Userplane as a server:

        ```json theme={null}
        {
          "servers": {
            "userplane-docs": {
              "type": "http",
              "url": "https://docs.userplane.io/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>

    <Note>
      See the [VS Code documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for more details.
    </Note>
  </Tab>
</Tabs>

## MCP vs web search

AI tools can search the web, but MCP provides distinct advantages for documentation access.

|                    | Web search                                       | MCP                                              |
| ------------------ | ------------------------------------------------ | ------------------------------------------------ |
| **Source**         | Search engine index — may be stale or incomplete | Your current indexed documentation, directly     |
| **Workflow**       | Separate search step before or after a response  | Searches inline during response generation       |
| **Signal quality** | SEO and ranking algorithms influence results     | Straight to your documentation content, no noise |

## Rate limits

To protect availability, Userplane applies the following rate limits to MCP requests.

| Scope                  | Limit                 |
| ---------------------- | --------------------- |
| Per user (IP address)  | 5,000 requests / hour |
| Per documentation site | 1,000 requests / hour |

## Related articles

* [Userplane MCP](/integrations/mcp-workspace) — connect AI agents to your workspace for debugging and root cause analysis.
* [Codex Plugin](/integrations/codex) — bundled skills and MCP servers for Codex.
* [Cursor Plugin](/integrations/cursor) — bundled commands, rules, skills, and MCP servers for Cursor.
* [Agent Skills](/developer/agent-skills) — install Userplane Agent Skills for SDK integration guidance.
* [Claude Code Plugin](/integrations/claude-code) — the full Userplane plugin with skills, commands, and MCP servers.
* [Installation](/developer/installation) — install the Userplane SDK in your app.