Coding agent integration

Connect cubic to your coding agent for AI code reviews, codebase documentation, and team review patterns directly in your editor.

Run the installer

npx @cubic-plugin/cubic-plugin install --to cursor

Get your API key

The installer opens the cubic dashboard in your browser. Generate a key and paste it back in your terminal when prompted.

Try it

Open Cursor and try these natural language commands:

“review my code”
“how does auth work?”

Manual MCP setup

Configure the MCP server manually if you prefer not to use the plugin installer.Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cubic": {
      "url": "https://www.cubic.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer cbk_your_api_key_here"
      }
    }
  }
}

The plugin installer handles this configuration automatically. Restart Cursor after adding the configuration.

Troubleshooting

Authentication errors

Verify your CUBIC_API_KEY is set correctly.
Check that your key starts with cbk_.
Ensure your key remains active in the cubic dashboard.
Restart your Cursor session.

/cubic-run-review not workingThis command requires the cubic CLI. Install it:

curl -fsSL https://cubic.dev/install | bash

MCP server not connecting

Restart Cursor after updating the configuration.
Check ~/.cursor/mcp.json for syntax errors.
Verify your API key is correct and valid.

Run the installer

npx @cubic-plugin/cubic-plugin install --to claude

Install via marketplace (Claude Code v1.0.33+)

/plugin marketplace add mrge-io/cubic-claude-plugin
/plugin install cubic@cubic

Get your API key

The installer opens the cubic dashboard in your browser. Generate a key and paste it back in your terminal when prompted.

Try it

Open Claude Code and try these commands:

“review my code”
“check cubic issues”
“how does auth work?”

Team installation

Set up cubic across your whole team by committing configuration to your repository.Add this to .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "cubic": {
      "source": {
        "source": "github",
        "repo": "mrge-io/cubic-claude-plugin"
      }
    }
  },
  "enabledPlugins": {
    "cubic@cubic": true
  }
}

Commit this file to your repository. Team members receive a prompt to install the plugin when they trust the repository.

Manual MCP setup

Configure the MCP server manually if you need a custom setup or prefer not to use the plugin installer.

claude mcp add --transport http cubic https://www.cubic.dev/api/mcp --header "Authorization: Bearer cbk_your_api_key_here"

Verify the connection:

/mcp

Troubleshooting

Authentication errors

Verify your CUBIC_API_KEY is set correctly.
Check that your key starts with cbk_.
Ensure your key remains active in the cubic dashboard.
Restart your Claude Code session.

/cubic-run-review not workingThis command requires the cubic CLI. Install it:

curl -fsSL https://cubic.dev/install | bash

Plugin not found (marketplace)

Confirm you use Claude Code v1.0.33 or later.
Run /plugin marketplace list to verify the marketplace is active.
Try reinstalling the plugin.

VS Code connects to cubic through the MCP server. Slash commands and skills are available in agents that support the Skills standard (Claude Code, Cursor, Codex, Gemini CLI). In VS Code, use the MCP tools directly through Copilot chat.

Get your API key

Navigate to Settings → Integrations → MCP Configuration at cubic.dev. Generate a new API key.

Add MCP server

Press Ctrl/Cmd + Shift + P to open the Command Palette.
Search for and select “MCP: Add Server”.
Select “HTTP” as the transport type.
Enter the URL: https://www.cubic.dev/api/mcp.
Add an Authorization header with the value: Bearer cbk_your_key.

Verify

Run “MCP: List Servers” from the Command Palette. The cubic server status shows as Running.

Through the MCP connection, VS Code’s AI features can query cubic data:

list_wikis / list_wiki_pages / get_wiki_page — Browse AI-generated codebase documentation.
list_scans / get_scan / get_issue — View codebase scan results and issue details.
list_learnings / get_learning — Access team-specific code review preferences.
get_pr_issues — Fetch all open AI review comments for a pull request.

Troubleshooting

Server not connecting

Check the configuration file path for your operating system.
Validate the JSON syntax in your configuration.
Restart VS Code to refresh the connection.

No tools available

Restart VS Code to reload the MCP server.
Verify that MCP support is enabled in your VS Code settings.

Run the installer

npx @cubic-plugin/cubic-plugin install --to codex

Get your API key

The installer opens the cubic dashboard. Generate a key and paste it back in the terminal.

Try it

Open Codex and try: “review my code” or “check cubic issues”

Troubleshooting

Authentication errorsVerify CUBIC_API_KEY is set in your environment. Ensure the key starts with cbk_ and restart your session./cubic-run-review not workingThis command requires the cubic CLI. Install it:

curl -fsSL https://cubic.dev/install | bash

Run the installer

npx @cubic-plugin/cubic-plugin install --to gemini

Get your API key

The installer opens the cubic dashboard. Generate a key and paste it back in the terminal.

Try it

Open Gemini CLI and try: “review my code” or “how does auth work?”

Troubleshooting

Authentication errorsConfirm your CUBIC_API_KEY is set correctly. The key must start with cbk_. Restart Gemini CLI after updating the environment./cubic-run-review not workingThe cubic CLI is required for local reviews. Install it:

curl -fsSL https://cubic.dev/install | bash

For agents with dedicated plugin support, run the relevant installation command.

OpenCode
Droid
Pi
Auto-detect

npx @cubic-plugin/cubic-plugin install --to opencode

npx @cubic-plugin/cubic-plugin install --to droid

npx @cubic-plugin/cubic-plugin install --to pi

npx @cubic-plugin/cubic-plugin install

This command attempts to identify and configure your active agent automatically.

Manual MCP setup

If your agent is not listed above, use these connection details to configure cubic as an MCP server.

Setting	Value
URL	`https://www.cubic.dev/api/mcp`
Transport	HTTP (Streamable)
Authentication	Bearer token in `Authorization` header

Example: OpenCode configAdd the following to ./opencode.json in your project root:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cubic": {
      "type": "remote",
      "url": "https://www.cubic.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer cbk_your_api_key_here"
      }
    }
  }
}

Generate your API key at Settings → Integrations → MCP Configuration on cubic.dev. Keys start with cbk_ and are unique to your account.

Troubleshooting

Connection errorsConfirm the URL is exactly https://www.cubic.dev/api/mcp. Verify your API key format and ensure your network allows HTTPS connections.Plugin installer does not detect my agentUse the --to flag to specify your agent, or configure the connection manually using the details in the Manual MCP setup section.

What you can do

cubic adds slash commands and skills to your agent. Your agent can query codebase documentation, fetch review issues, and apply fixes automatically. See the Skills page for full details.

Command	Description
`/cubic-comments [pr-number]`	Show cubic’s review comments on the current PR (auto-detects branch)
`/cubic-run-review [flags]`	Run a local cubic AI code review on uncommitted changes or branch diff
`/cubic-wiki [page-name]`	Browse AI-generated codebase documentation
`/cubic-scan [scan-id]`	View codebase security scan results and issues
`/cubic-learnings [learning-id]`	Show team code review patterns and preferences

The /cubic-run-review command requires the cubic CLI. See the Local CLI for installation.

Get started

AI code review

Agents & CLI

Analytics

Portal

Account & support

What you can do

Get started

AI code review

Agents & CLI

Analytics

Portal

Account & support

​What you can do

What you can do