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

# Connect cubic to your IDE

> Install and connect cubic in Cursor, Claude Code, VS Code, Codex, Gemini CLI, or another coding tool.

Connect cubic's MCP server to your coding agent to read review findings and codebase context,
request PR reviews, and triage PR or codebase scan issues.

<Warning>
  Use the exact endpoint `https://www.cubic.dev/api/mcp`. Some OAuth clients reject
  `https://cubic.dev/api/mcp` because the protected resource origin does not match.
</Warning>

<Tabs>
  <Tab title="Cursor">
    <Steps>
      <Step title="Add the server">
        Add cubic to `~/.cursor/mcp.json` for all projects, or `.cursor/mcp.json` for one project.
        If the file already has servers, add the `cubic` entry inside its `mcpServers` object:

        ```json theme={null}
        {
          "mcpServers": {
            "cubic": {
              "url": "https://www.cubic.dev/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Connect">
        Open Cursor's MCP settings, connect cubic, and complete the browser sign-in flow.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor Agent">
    <Steps>
      <Step title="Add the MCP server">
        Add this to `~/.cursor/mcp.json` or project `.cursor/mcp.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "cubic": {
              "type": "http",
              "url": "https://www.cubic.dev/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Log in">
        Run these commands from the project where you use Cursor Agent:

        ```bash theme={null}
        agent mcp enable cubic
        agent mcp login cubic
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        agent mcp list-tools cubic
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Add the MCP server">
        ```bash theme={null}
        claude mcp add --transport http --scope user cubic https://www.cubic.dev/api/mcp
        ```
      </Step>

      <Step title="Log in">
        Open Claude Code and run:

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

        Choose cubic and complete the browser OAuth flow.
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        claude mcp list
        ```
      </Step>
    </Steps>

    <Accordion title="Optional skills and slash commands">
      Install the cubic plugin to add skills and namespaced slash commands:

      ```text theme={null}
      /plugin marketplace add mrge-io/skills
      /plugin install cubic@cubic
      ```
    </Accordion>
  </Tab>

  <Tab title="Codex">
    <Steps>
      <Step title="Add the MCP server">
        ```bash theme={null}
        codex mcp add cubic --url https://www.cubic.dev/api/mcp
        ```
      </Step>

      <Step title="Log in">
        ```bash theme={null}
        codex mcp login cubic
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        codex mcp list
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Gemini CLI">
    <Steps>
      <Step title="Add the MCP server">
        ```bash theme={null}
        gemini mcp add --transport http --scope user cubic https://www.cubic.dev/api/mcp
        ```
      </Step>

      <Step title="Log in">
        Open Gemini CLI and run:

        ```text theme={null}
        /mcp auth cubic
        ```
      </Step>

      <Step title="Verify">
        ```text theme={null}
        /mcp
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode">
    <Steps>
      <Step title="Add the MCP server">
        Add this to `~/.config/opencode/opencode.json`:

        ```json theme={null}
        {
          "$schema": "https://opencode.ai/config.json",
          "mcp": {
            "cubic": {
              "type": "remote",
              "url": "https://www.cubic.dev/api/mcp",
              "enabled": true
            }
          }
        }
        ```
      </Step>

      <Step title="Log in">
        ```bash theme={null}
        opencode mcp auth cubic
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        opencode mcp list
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Droid">
    <Steps>
      <Step title="Add the MCP server">
        ```bash theme={null}
        droid mcp add cubic https://www.cubic.dev/api/mcp --type http
        ```
      </Step>

      <Step title="Log in">
        Open Droid, run `/mcp`, choose cubic, and complete the browser OAuth flow.
      </Step>

      <Step title="Verify">
        The `/mcp` panel should show cubic as connected.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Pi">
    <Steps>
      <Step title="Install cubic's Pi target">
        ```bash theme={null}
        npx @cubic-plugin/cubic-plugin install --to pi
        ```

        The installer writes Pi's MCP config to `~/.config/mcp/mcp.json`.
      </Step>

      <Step title="Install the MCP adapter (if needed)">
        ```bash theme={null}
        pi install npm:pi-mcp-adapter
        ```

        Skip this step if `pi-mcp-adapter` is already installed.
      </Step>

      <Step title="Check the MCP config">
        The adapter reads `~/.config/mcp/mcp.json` automatically. Confirm the config contains:

        ```json theme={null}
        {
          "mcpServers": {
            "cubic": {
              "auth": "oauth",
              "url": "https://www.cubic.dev/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Log in">
        ```text theme={null}
        /mcp-auth cubic
        ```
      </Step>

      <Step title="Verify">
        ```text theme={null}
        /mcp reconnect cubic
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Add the MCP server">
        Open the Command Palette, run **MCP: Add Server**, choose HTTP, and enter:

        ```text theme={null}
        https://www.cubic.dev/api/mcp
        ```

        Name the server `cubic` and choose **Global** or **Workspace** for the configuration.
      </Step>

      <Step title="Log in">
        Run **MCP: List Servers**, start cubic, and complete OAuth when prompted.
      </Step>

      <Step title="Verify">
        Run **MCP: List Servers** and confirm cubic is running.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What you can ask

Try "use cubic to show open review issues on this PR". The agent should retrieve the findings
with file locations and descriptions. See [MCP tools and examples](/ide/mcp-server#try-your-first-prompt)
for a prompt using an explicit PR URL.

* "start a cubic review of this PR"
* "list wiki pages for this repo"
* "what review learnings apply here?"
* "show scan findings with severity at least 7"

## Skills and slash commands

MCP gives your agent access to cubic tools. For agents that also support skills or slash commands, install those separately:

```bash theme={null}
npx @cubic-plugin/cubic-plugin install --skills-only
```

The installer detects supported agents in your home directory. Add `--to codex`, for example,
to choose one target. See [Skills](/ide/skills) for prerequisites, verification, and
[command names for each installation](/ide/skills#slash-commands).

<Tip>
  To ask your agent to "review my code" locally, install and sign in to the [cubic
  CLI](/ide/cli-review). MCP setup alone does not install the CLI.
</Tip>