> ## 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 so it can read PR review issues, codebase wikis, scan results, and team review learnings while you work.

<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="Open settings">
        Open Cursor **Settings**.
      </Step>

      <Step title="Open Tools and MCP">
        Go to **Tools and MCP**.
      </Step>

      <Step title="Choose MCP section">
        In MCP, use **Home MCP Servers** or your project-specific MCP section.
      </Step>

      <Step title="Create a server">
        Click **New MCP server**.
      </Step>

      <Step title="Save the config">
        Add this to the config and save:

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

      <Step title="Connect">
        Click **Connect**.
      </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}
        cursor-agent mcp enable cubic
        cursor-agent mcp login cubic
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={null}
        cursor-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 cubic's Claude Code skills separately:

      ```bash 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="Initialize and verify the MCP server">
        Run Pi's guided setup:

        ```bash theme={null}
        pi-mcp-adapter init
        ```

        Confirm the MCP 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
        ```
      </Step>

      <Step title="Log in">
        Follow VS Code's OAuth prompt for the cubic MCP server.
      </Step>

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

## What you can ask

* "show cubic issues on 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
```

| Command                                    | Description                                                                |
| :----------------------------------------- | :------------------------------------------------------------------------- |
| `/cubic-run-review` or `/cubic:run-review` | Run a local cubic AI code review from your editor. Requires the cubic CLI. |

<Tip>
  The `/cubic-run-review` and `/cubic:run-review` commands require the cubic CLI. See [Local CLI review](/ide/cli-review)
  for installation.
</Tip>