• STATUS
  • LIST
  • CODE
  • HUMAN

How to troubleshoot failed quality gates with your AI

Connect SonarQube or SonarCloud to your AI client to turn cryptic build failures into clear, actionable fixes.

Ask AI about this page

Short answer

Why did my quality gate fail?

Your AI pulls the current gate status and identifies the specific issues blocking your merge. It then reads the offending code to explain the violation and suggest a fix. You get a direct path from a red build to a passing one.

Where every issue lands.

The outcomes of a failed gate

Once you connect, your AI organizes the failure data into these specific results.

STATUS

Gate status check

The AI confirms if the project is currently passing or failing. You'll know immediately if the gate is the reason your pipeline stopped.

LIST

Violation breakdown

The AI pulls a list of every issue that triggered the failure. It separates critical blockers from minor warnings.

CODE

Contextual analysis

The AI reads the actual source files where the errors live. This allows it to explain the logic error, not just the rule name.

HUMAN

Final code fix

The AI provides the corrected code snippet. You review the change and apply it to your repository.

The workflow

What your AI does when the gate fails.

The AI handles the heavy lifting of digging through Sonar logs so you don't have to.

  1. Check the gate

    The AI checks the current state of your project to confirm the failure.

    get_quality_gate_status

  2. Find the blockers

    It identifies the specific code issues that caused the gate to turn red.

    search_issues

  3. Read the source

    The AI pulls the relevant files to see the code in its original context.

    get_source_code

  4. Explain the fix

    By combining the issue details and the source code, the AI explains the violation and how to fix it.

    search_issuesget_source_code

Try it

Copy these to start.

Use these prompts to kick off the troubleshooting process.

Starting points

Swap out the project names or repository identifiers for your own.

SonarQube Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_65ij3kQdNIdLxz6QrHqXvdxjl6hvRUXIu2uwF792/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — SonarQube capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "sonarqube-sonarcloud-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_65ij3kQdNIdLxz6QrHqXvdxjl6hvRUXIu2uwF792/mcp"
    }
  }
}
Copy into chat04

  • Check the quality gate status for my 'auth-service' project.

  • Why did the quality gate fail for the 'payment-gateway' repo?

  • Find the issues in 'frontend-app' that are blocking the quality gate.

  • Read the source code for the issues found in 'data-processor' and suggest a fix.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect SonarQube & SonarCloud once, then ask.

Just link your account via the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start asking your AI about your code quality.

Connect SonarQube & SonarCloud to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix the code automatically?

    No. The AI identifies the problem and suggests the fix, but you must manually apply the changes to your code.

  • 02

    Can the AI change my SonarQube settings?

    No. The AI can only read status, issues, and source code. It cannot modify your quality gate rules or project configurations.

  • 03

    Does the AI need my SonarQube login?

    You provide the connection once through Vinkius. Your AI client uses that secure connection to pull data without needing your password every time.

  • 04

    Can it see all my projects?

    The AI can see any project that your connected account has permission to access.

  • 05

    Will it report issues that didn't fail the gate?

    Yes, if you ask it to search for all issues, it will find them, even if they aren't currently blocking the gate.

  • More questions about SonarQube & SonarCloud? The Connector page answers them. See everything the SonarQube & SonarCloud Connector can do

Connect SonarQube to Claude, Cursor, ChatGPT & more