SonarQube MCPでGemini CLIと連携

💡 インストール不要です。cloud.anythingmcp.com をそのままご利用ください。 サインインして Connectors → SonarQube をクリックし、認証情報を貼り付けて MCP APIキーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

SonarQube + Gemini

AIにSonarQubeを読み取らせましょう。プロジェクト、クオリティゲートのステータス、カバレッジなどのメジャーとその履歴、重大度とソフトウェア品質別の未解決の課題、解析とブランチを扱えます。SonarQube ServerでもSonarQube Cloudでも利用でき、ユーザートークンによる読み取り専用です。

前提条件

コネクターに組み込まれているセットアップ手順の全文をご覧ください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

SONARQUBE_URL, SONARQUBE_TOKEN

ステップ1 — 認証情報を取得する

セットアップには約3分かかります。SonarQube Server(無料のCommunity Buildで動作します)または解析済みプロジェクトが1つ以上あるSonarQube Cloudアカウントと、ユーザートークンが必要です。

1. SONARQUBE_URL を設定します。/api や末尾のスラッシュは付けません。EUリージョンのSonarQube Cloudなら https://sonarcloud.io、USリージョンのSonarQube Cloudなら https://sonarqube.us、SonarQube Serverならブラウザで開くときのアドレスを、コンテキストパスがあればそれも含めて指定します(例: https://sonar.example.com や https://example.com/sonarqube)。
2. ユーザートークンを作成し、Bearerという語を付けずに SONARQUBE_TOKEN に貼り付けます。Serverの場合: アバター → My Account → Security で、タイプ User のトークンを生成します。Cloudの場合: アバター → My Account → Access tokens → Personal Tokens でトークンを生成します。プロジェクト用およびグローバルの解析トークンはスキャンの実行用であり、Web APIでは使えません。
3. SonarQube Cloudでは、SONARQUBE_ORGANIZATION に組織キーを設定します。組織キーはURL sonarcloud.io/organizations/<key> に表示されます。Cloudではプロジェクトの一覧取得と課題の検索にこの値が必要です。Serverでは空のままにします。
4. コネクターをインストールして sonarqube_list_projects を実行します。トークンで閲覧できるプロジェクトと、他のツールが受け取るプロジェクトキーが一覧表示されます。

読み取れる内容: プロジェクトがクオリティゲートに合格したかどうか(OKまたはERROR、不合格の各条件を含む)、coverage、duplicated_lines_density、ncloc、software_quality_* の課題数などの現在のメジャー、そのメジャーが解析ごとにどう変化したか、ソフトウェア品質(SECURITY、RELIABILITY、MAINTAINABILITY)・重大度・ステータスで絞り込んだ課題、イベント付きのプロジェクトの解析、最後の解析とゲートのステータス付きのブランチです。7つのツールはすべて読み取り専用で、AIが参照できるプロジェクトはトークンによって決まります。

プロジェクトとブランチ: ツールが受け取るのは表示名ではなくプロジェクトキーです(例: payments-api、Cloudでは my-org_payments-api)。branch や pullRequest を指定しない場合はメインブランチを読み取ります。Community Buildで解析されるのはメインブランチのみです。

プライベートネットワーク: セルフホストのAnythingMCPで、内部ホストやプライベートIP上のSonarQube Serverを使う場合は、そのホストを SSRF_ALLOWED_HOSTS に追加する必要があります。追加しないと、送信ガードが呼び出しを拒否します。AnythingMCP Cloudが接続できるのは、SonarQube Cloud、またはパブリックインターネットから到達可能なSonarQube Serverのみです。

制限: 一覧系のツールは1ページあたり最大500件を返します(sonarqube_get_measures_history は1,000件)。課題の検索は合計で最大10,000件までしか返さないため、ページを進めるのではなくフィルターを絞り込んでください。SonarQube Cloudは、トークンから送信されるリクエストが多すぎると429を返します。数分待ってから再試行してください。SonarQube Serverにはデフォルトでレート制限がありません。

よくあるエラー: 401は、トークンが間違っている、期限切れ、失効している、またはユーザートークンではなく解析トークンであることを意味します。403は、トークンのユーザーにプロジェクトの Browse 権限がないことを意味します。404は、プロジェクトキー、ブランチ、プルリクエストが存在しないか、SONARQUBE_URL が間違っていることを意味します。400は、不足している、または無効なパラメーターを示します。たとえばCloudで組織が指定されていない場合です。

このコネクターはSonarQube上の何も変更しません(課題の遷移、担当者の割り当て、コメントの追加、クオリティゲート・クオリティプロファイル・プロジェクト・トークンの変更はできません)。また、セキュリティホットスポット、ポートフォリオとアプリケーション、Web API v2、管理およびシステムのエンドポイント、新規コードのみを対象とした課題フィルターには対応していません。

ステップ2 — アダプターをインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ3 — Geminiにコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が SonarQube のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクターのランディングページ
• Claudeに接続する
• ChatGPTに接続する