SonarQube MCPでChatGPTと連携

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

SonarQube + ChatGPT

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

前提条件

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

SONARQUBE_URL, SONARQUBE_TOKEN

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

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

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 — ChatGPT にコネクターを追加する

サーバー URL: AnythingMCP で MCP Servers → このコネクターが載っているサーバーを開き、その URL(https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所には、この URL を使ってください。

ChatGPT では、Web 版の有料プランで、Plugins ページから MCP サーバーをプラグインとして追加します。開発者モードは不要になりました。Business ワークスペースでは、管理者とオーナーのみ追加できます。Enterprise と Edu では、管理者が Create plugins with MCPs 権限を付与できます。

1. chatgpt.com/plugins にアクセスし、Add、Add custom MCP server の順にクリックします。
2. 名前を入力します(例: Name: SonarQube)。
3. Connection で、Server URL に https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Authentication は OAuth のままにします。
4. I understand and want to continue を選択し、Create as a plugin をクリックします。ChatGPT から求められたら、AnythingMCP にサインインしてアクセスを許可します。
5. 作成したプラグインを個人用プラグインからインストールし、チャットで @ を入力して選択します。

利用可能なツール

FAQ

無料の ChatGPT プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランのみで、Free プランは対象に含まれていません。

次のステップ

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