cubic

cubic MCP サーバー

cubic は、GitHub のプルリクエスト向け AI コードレビュー ツールです。cubic がホストする MCP サーバーを使用すると、AI エージェントから cubic のレビュー結果、リポジトリのドキュメント、コードベースのスキャン結果、チームのナレッジに接続できます。

できること

• プルリクエストの未解決のレビュー結果を、ファイルの場所、重大度、レビュー状況とともに読み取ります。
• プルリクエストのクラウドレビューを開始します。
• レビュー結果を解決、再オープン、または却下し、GitHub のレビュースレッドに結果を記録します。
• リポジトリの Wiki と個々の Wiki ページを読み取ります。
• コードベースのスキャン結果を確認し、問題を調べ、トリアージ状況を更新します。
• リポジトリに関するチームのレビュー時のナレッジを読み取ります。
• 組織のサブスクリプションとメンバーを確認します。組織の管理者は、シート、ロール、および対応している請求設定も管理できます。

MCP は cubic アカウントの権限を使用します。該当するリポジトリまたは組織へのアクセス権が必要です。サーバーに接続しても、追加のアクセス権は付与されません。利用できるツールは、権限とサブスクリプションによって異なります。

接続

設定	値
サーバー名	cubic
URL	https://www.cubic.dev/api/mcp
トランスポート	Streamable HTTP
認証	OAuth（推奨）または個人用 API キー

www を含め、表示どおりの URL をそのまま使用してください。サーバーは cubic がホストしているため、ローカルサーバーをインストールする必要はありません。

VS Code の GitHub Copilot

1. コマンド パレットを開き、MCP: Add Server を実行します。
2. HTTP を選択し、https://www.cubic.dev/api/mcp を入力します。
3. サーバーに cubic という名前を付け、ユーザーまたはワークスペースの設定を選択します。
4. MCP: List Servers を実行して cubic を起動し、ブラウザーで OAuth サインインを完了します。
5. cubic のツールを有効にして、Copilot のエージェントモードを使用します。

このポータブルな設定を、プロジェクトの .mcp.json に追加することもできます。ファイルがすでに存在する場合は、mcpServers オブジェクト内に cubic のエントリを追加します。

{
  "mcpServers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Cursor

すべてのプロジェクトに適用するには ~/.cursor/mcp.json に、1 つのプロジェクトに適用するには .cursor/mcp.json に次の内容を追加します。その後、MCP 設定で cubic に接続し、OAuth を完了します。

{
  "mcpServers": {
    "cubic": {
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http --scope user cubic https://www.cubic.dev/api/mcp

Claude Code を開き、/mcp を実行して cubic を選択し、ブラウザーで OAuth フローを完了します。

Codex CLI

codex mcp add cubic --url https://www.cubic.dev/api/mcp
codex mcp login cubic
codex mcp list

OAuth を使用しないスクリプト、CI、クライアント

Settings > Integrations > MCP で個人用 API キーを生成します。このキーを Authorization ヘッダーのベアラートークンとして送信し、クライアントの OAuth ログイン手順は省略します。

VS Code の拡張ホストセッションでは、キーがワークスペースの設定に書き込まれないように、.vscode/mcp.json に入力を使用してください。Agent Host セッションでは、OAuth または環境変数を使ったシークレットを含むポータブルな設定を使用します。VS Code は、対話形式の入力が必要なサーバーを転送しません。

{
  "inputs": [
    {
      "id": "cubic-api-key",
      "type": "promptString",
      "description": "cubic personal API key",
      "password": true
    }
  ],
  "servers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cubic-api-key}"
      }
    }
  }
}

スクリプトや CI では、シークレットストアからキーを読み込んでください。キーは個人用で、作成したユーザーの権限を引き継ぎます。同じ設定ページからキーを取り消すか、再生成できます。

使用方法

接続したら、アクセスできるリポジトリと PR に置き換えて、次のプロンプトを試してください。

• 「cubic を使って、https://github.com/OWNER/REPO/pull/NUMBER の未解決のレビュー指摘を一覧表示してください。」
• 「acme/backend の PR #42 の cubic レビューを開始してください。」
• 「acme/backend の Wiki ページを一覧表示して、認証システムのページを表示してください。」
• 「acme/backend のコードベーススキャンの指摘のうち、重大度が 7 以上のものを表示してください。」
• 「acme/backend に適用されるレビューの学びを教えてください。」

get_pr_issues は指摘とレビュー状況を取得します。レビューは開始しません。指摘の一覧が空でも、現在のコミットに未解決の指摘がないと言えるのは、そのレビューが完了していて、それ以降に新しいコミットがない場合に限られます。クラウドレビューを開始するには、trigger_pr_review を使用してください。

get_pr_issues で取得した PR の指摘 ID を update_pr_issue_status で使用してください。これにより GitHub のレビューコメントスレッドが更新され、投稿者情報が付与された返信がキューに追加されます。コードベーススキャンの指摘 ID は、get_scan で取得し、get_issue または update_issue_status で使用してください。

ローカルコードレビューには、cubic CLI を使用してください。cubic skills を使うと、エージェントが指摘を調査して修正するためのワークフローが追加されます。

ドキュメントとサポート

• MCP の全ドキュメント、利用可能なツール、トラブルシューティング
• VS Code の MCP セットアップと構成
• cubic のウェブサイト
• 公式 MCP Registry のエントリー
• cubic サポートへのお問い合わせ

このリポジトリには、cubic のホスト型 MCP サービスに関する公開ドキュメントとレジストリのメタデータが含まれています。レジストリ名は dev.cubic/cubic で、メタデータは server.json にあります。