SonarQube

SonarQube MCP 서버

SonarQube MCP 서버는 코드 품질과 보안을 위해 SonarQube Server 또는 Cloud와 원활하게 통합할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. 또한 에이전트 컨텍스트 내에서 코드 스니펫을 직접 분석하는 기능도 지원합니다.

빠른 설정

🚀 구성 생성하기

시작하는 가장 빠른 방법은 SonarQube MCP Server Configuration Generator 입니다. 선호하는 AI 에이전트 클라이언트에 바로 사용할 수 있는 구성을 생성해 주는 대화형 도구입니다.

수동 설정

직접 구성하는 것을 선호한다면 sonarsource/sonarqube-mcp 컨테이너 이미지를 사용하는 것이 가장 간단한 방법입니다. 자동 업데이트를 위해 sonarsource/sonarqube-mcp를 사용하거나(--pull=always 사용), 재현 가능한 배포를 위해 버전 태그(예: sonarsource/sonarqube-mcp:1.19.0.2785)로 고정하세요. 로컬에서 빌드하려면 아래를 읽어보세요.

참고: 아래 예제는 docker를 사용하지만, OCI 호환 컨테이너 런타임(예: Podman, nerdctl)이면 모두 작동합니다. docker를 선호하는 도구로 바꾸기만 하면 됩니다.

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": ["run", "--init", "--pull=always", "-i", "--rm", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", "sonarsource/sonarqube-mcp"],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_TOKEN>",
        "SONARQUBE_ORG": "<YOUR_ORG>"
      }
    }
  }
}

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": ["run", "--init", "--pull=always", "-i", "--rm", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_URL", "sonarsource/sonarqube-mcp"],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_USER_TOKEN>",
        "SONARQUBE_URL": "<YOUR_SERVER_URL>"
      }
    }
  }
}

claude mcp add sonarqube \
  --env SONARQUBE_TOKEN=$SONAR_TOKEN \
  --env SONARQUBE_ORG=$SONAR_ORG \
  -- docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp

claude mcp add sonarqube \
  --env SONARQUBE_TOKEN=$SONAR_USER_TOKEN \
  --env SONARQUBE_URL=$SONAR_URL \
  -- docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_URL sonarsource/sonarqube-mcp

[mcp_servers.sonarqube]
command = "docker"
args = ["run", "--init", "--pull=always", "--rm", "-i", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", "sonarsource/sonarqube-mcp"]
env = { "SONARQUBE_TOKEN" = "<YOUR_USER_TOKEN>", "SONARQUBE_ORG" = "<YOUR_ORG>" }

[mcp_servers.sonarqube]
command = "docker"
args = ["run", "--init", "--pull=always", "--rm", "-i", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_URL", "sonarsource/sonarqube-mcp"]
env = { "SONARQUBE_TOKEN" = "<YOUR_TOKEN>", "SONARQUBE_URL" = "<YOUR_SERVER_URL>" }

gemini extensions install https://github.com/SonarSource/sonarqube-agent-plugins

/mcp add

Server Name: sonarqube
Server Type: Local (Press 1)
Command: docker
Arguments: run, --init, --pull=always, --rm, -i, -e, SONARQUBE_TOKEN, -e, SONARQUBE_ORG, sonarsource/sonarqube-mcp
Environment Variables: SONARQUBE_TOKEN=<YOUR_TOKEN>,SONARQUBE_ORG=<YOUR_ORG>
Tools: *

Server Name: sonarqube
Server Type: Local (Press 1)
Command: docker
Arguments: run, --init, --pull=always, --rm, -i, -e, SONARQUBE_TOKEN, -e, SONARQUBE_URL, sonarsource/sonarqube-mcp
Environment Variables: SONARQUBE_TOKEN=<YOUR_USER_TOKEN>,SONARQUBE_URL=<YOUR_SERVER_URL>
Tools: *

{
  "mcpServers": {
    "sonarqube": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "--rm",
        "-i",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "COPILOT_MCP_SONARQUBE_TOKEN",
        "SONARQUBE_ORG": "COPILOT_MCP_SONARQUBE_ORG"
      },
      "tools": ["*"]
    }
  }
}

{
  "mcpServers": {
    "sonarqube": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "--rm",
        "-i",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_URL",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "COPILOT_MCP_SONARQUBE_USER_TOKEN",
        "SONARQUBE_URL": "COPILOT_MCP_SONARQUBE_URL"
      },
      "tools": ["*"]
    }
  }
}

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e", 
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_TOKEN>",
        "SONARQUBE_ORG": "<YOUR_ORG>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e", 
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_URL",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_USER_TOKEN>",
        "SONARQUBE_URL": "<YOUR_SERVER_URL>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

{
  "sonarqube_token": "YOUR_SONARQUBE_TOKEN",
  "sonarqube_org": "SONARQUBE_ORGANIZATION_KEY",
  "docker_path": "DOCKER_PATH"
}

{
  "sonarqube_token": "YOUR_SONARQUBE_USER_TOKEN",
  "sonarqube_url": "YOUR_SONARQUBE_SERVER_URL",
  "docker_path": "DOCKER_PATH"
}

💡 팁: 최신 기능과 수정 사항을 확보하려면 최신 이미지를 정기적으로 가져오거나 문제를 보고하기 전에 가져오는 것을 권장합니다.

수동 설치

MCP 서버 구성 파일에 다음 스니펫을 복사하여 SonarQube MCP 서버를 수동으로 설치할 수 있습니다:

• SonarQube Cloud에 연결하려면:

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_ORG",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_ORG": "<org>"
    }
  }
}

• SonarQube Server에 연결하려면:

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_URL",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

SonarQube for IDE와의 통합

SonarQube MCP Server는 SonarQube for IDE와 통합하여 개발 워크플로를 더욱 향상시키고 IDE 내에서 더 나은 코드 분석과 인사이트를 제공할 수 있습니다.

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_ORG",
      "-e",
      "SONARQUBE_IDE_PORT",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_ORG": "<org>",
      "SONARQUBE_IDE_PORT": "<64120-64130>"
    }
  }
}

구성

환경에 따라 특정 환경 변수를 제공해야 합니다.

기본

MCP 서버를 실행할 때 다음 변수를 추가해야 합니다:

작업 공간 마운트(컨텍스트 증가 줄이기)

기본적으로 분석 도구 analyze_code_snippet는 에이전트가 전체 파일 내용을 fileContent 인수로 전달해야 합니다. 대용량 파일이거나 세션에서 많은 파일을 분석할 때 이는 컨텍스트 창 사용량과 비용을 크게 증가시킵니다. 해결 방법: 프로젝트 디렉터리를 /app/mcp-workspace의 컨테이너에 마운트합니다. 이 마운트가 감지되면 서버는 프로젝트 상대 경로 filePath 인수를 사용하여 디스크에서 직접 파일을 읽습니다. 파일 콘텐츠는 에이전트 컨텍스트를 거치지 않습니다.

{
  "args": [
    "run", "-i", "--rm", "--init", "--pull=always",
    "-e", "SONARQUBE_TOKEN",
    "-e", "SONARQUBE_ORG",
    "-v", "/path/to/your/project:/app/mcp-workspace",
    "sonarsource/sonarqube-mcp"
  ]
}

마운트가 활성화되면:

• run_advanced_code_analysis는 조직에 권한이 부여된 경우 사용할 수 있습니다.
• analyze_code_snippet: filePath가 필요하며 fileContent는 사용되지 않습니다. 서버는 동일한 방식으로 파일을 해석합니다.

선택적 도구 세트 활성화

기본적으로 컨텍스트 오버헤드를 줄이기 위해 중요한 도구 세트만 활성화됩니다. 필요에 따라 추가 도구 세트를 활성화할 수 있습니다.

docker run --init --pull=always -i --rm \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_ORG="<org>" \
  -e SONARQUBE_TOOLSETS="analysis,issues,quality-gates" \
  sonarsource/sonarqube-mcp

docker run --init --pull=always -i --rm \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_ORG="<org>" \
  -e SONARQUBE_READ_ONLY="true" \
  sonarsource/sonarqube-mcp

SonarQube Cloud

전체 기능을 활성화하려면 서버를 시작하기 전에 다음 환경 변수를 설정해야 합니다:

예시:

• SonarQube Cloud: SONARQUBE_TOKEN 및 SONARQUBE_ORG만 필요합니다.
• SonarQube Cloud US: SONARQUBE_TOKEN, SONARQUBE_ORG 및 SONARQUBE_URL=https://sonarqube.us를 설정합니다.

SonarQube Server

⚠️ SonarQube Server에 연결하려면 USER 유형의 토큰이 필요하며, 프로젝트 토큰이나 전역 토큰을 사용하면 제대로 작동하지 않습니다. 💡 구성 팁 (stdio 모드): SONARQUBE_ORG의 존재 여부에 따라 SonarQube Cloud에 연결할지 SonarQube Server에 연결할지가 결정됩니다. SONARQUBE_ORG이 설정되어 있으면 SonarQube Cloud가 사용되고, 그렇지 않으면 SonarQube Server가 사용됩니다.

전송 모드

MCP 사양은 두 가지 전송 메커니즘을 정의합니다: Stdio와 Streamable HTTP. SonarQube MCP Server는 둘 다 지원합니다:

참고: Streamable HTTP는 현재 MCP 네트워크 전송 방식입니다. 이전 MCP 버전의 SSE 전용 HTTP 전송 방식은 더 이상 사용되지 않으며(deprecated) 지원되지 않습니다.

1. Stdio (기본값 - 로컬 개발에 권장)

로컬 개발 및 단일 사용자 환경에 권장되는 모드로, 대부분의 MCP 클라이언트에서 사용됩니다.

예시 - SonarQube Cloud와 Docker:

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": ["run", "--init", "--pull=always", "-i", "--rm", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", "sonarsource/sonarqube-mcp"],
      "env": {
        "SONARQUBE_TOKEN": "<your-token>",
        "SONARQUBE_ORG": "<your-org>"
      }
    }
  }
}

2. HTTP (Streamable HTTP)

암호화되지 않은 Streamable HTTP 전송 방식입니다. 다중 사용자 배포에는 HTTPS를 대신 사용하세요.

⚠️ 권장하지 않음: 로컬 개발에는 Stdio를, 다중 사용자 프로덕션 배포에는 **HTTPS(Streamable HTTP)**를 사용하세요.

참고: Streamable HTTP 모드(HTTP 또는 HTTPS)에서 서버는 상태 비저장(stateless)입니다 — 각 클라이언트 요청에는 사용자 자신의 SonarQube 토큰을 담은 Authorization: Bearer <token> 헤더가 포함되어야 합니다. SonarQube Cloud의 경우 조직은 다음과 같이 결정됩니다:

• 서버 시작 시 SONARQUBE_ORG이 설정되어 있으면 모든 요청이 해당 조직으로 라우팅됩니다. 클라이언트는 SONARQUBE_ORG 헤더를 보내면 안 되며, 보낼 경우 오류가 발생합니다.
• 서버 시작 시 SONARQUBE_ORG가 설정되어 있지 않으면 각 클라이언트는 모든 요청에 SONARQUBE_ORG 헤더를 반드시 제공해야 합니다. 또한 클라이언트는 SONARQUBE_TOOLSETS 및/또는 SONARQUBE_READ_ONLY 헤더를 제공하여 요청별로 표시되는 도구를 좁힐 수 있습니다. 이러한 헤더는 서버 수준 구성 위에 추가 필터링을 적용합니다 — 범위를 줄일 수만 있고 확장할 수는 없습니다. 요청 간 세션 상태는 유지되지 않습니다.

더 이상 사용되지 않음(deprecated): SONARQUBE_TOKEN 요청 헤더는 이전 버전과의 호환성을 위해 계속 허용되지만 향후 버전에서 제거될 예정입니다. Authorization: Bearer <token>로 마이그레이션하세요.

3. HTTPS (TLS를 통한 Streamable HTTP) (다중 사용자 프로덕션 배포에 권장)

TLS 암호화를 사용하는 보안 Streamable HTTP 전송 방식입니다. SSL 인증서가 필요합니다.

✅ 프로덕션 권장: 여러 사용자가 Streamable HTTP를 통해 MCP 서버에 접속할 때는 HTTPS를 사용하세요. 서버는 보안상 기본적으로 127.0.0.1 (localhost)에 바인딩됩니다.

SSL 인증서 구성 (선택 사항):

예시 - SonarQube Cloud와 Docker:

참고: 컨테이너에서 실행할 때는 SONARQUBE_HTTP_HOST=0.0.0.0를 설정하여 컨테이너가 모든 인터페이스에서 수신 대기하고 런타임의 포트 매핑이 작동하도록 하고, SONARQUBE_MCP_IN_CONTAINER=true를 설정하여 서버가 컨테이너 내부에 있음을 알리세요. 공식 Docker 이미지는 후자를 자동으로 설정하며, 다른 OCI 런타임(Podman, Kubernetes, Nomad 등)을 사용할 때는 직접 설정하세요. 호스트 측 포트 플래그는 외부에서 컨테이너에 접근할 수 있는 대상을 제어합니다. SONARQUBE_HTTP_HOST=0.0.0.0은 서버가 컨테이너 내부에서 수신 대기하는 위치만 제어합니다 — 브라우저 CORS는 기본적으로 localhost 출처를 계속 허용합니다.

로컬 머신에서 실행되는 서버의 경우 (localhost에서만 접근 가능):

docker run --init --pull=always -p 127.0.0.1:8443:8443 \
  -v $(pwd)/keystore.p12:/etc/ssl/mcp/keystore.p12:ro \
  -e SONARQUBE_TRANSPORT=https \
  -e SONARQUBE_HTTP_HOST=0.0.0.0 \
  -e SONARQUBE_HTTP_PORT=8443 \
  -e SONARQUBE_TOKEN="<init-token>" \
  -e SONARQUBE_ORG="<your-org>" \
  sonarsource/sonarqube-mcp

네트워크에서 접근 가능한 서버의 경우 (원격 배포):

docker run --init --pull=always -p 8443:8443 \
  -v $(pwd)/keystore.p12:/etc/ssl/mcp/keystore.p12:ro \
  -e SONARQUBE_TRANSPORT=https \
  -e SONARQUBE_HTTP_HOST=0.0.0.0 \
  -e SONARQUBE_HTTP_PORT=8443 \
  -e SONARQUBE_TOKEN="<init-token>" \
  -e SONARQUBE_ORG="<your-org>" \
  sonarsource/sonarqube-mcp

클라이언트 구성 (SonarQube Cloud):

{
  "mcpServers": {
    "sonarqube-https": {
      "url": "https://your-server:8443/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>",
        "SONARQUBE_ORG": "<your-org>",
        "SONARQUBE_TOOLSETS": "issues,quality-gates",
        "SONARQUBE_READ_ONLY": "true"
      }
    }
  }
}

클라이언트 구성 (SonarQube Server):

{
  "mcpServers": {
    "sonarqube-https": {
      "url": "https://your-server:8443/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>",
        "SONARQUBE_TOOLSETS": "issues,quality-gates",
        "SONARQUBE_READ_ONLY": "true"
      }
    }
  }
}

참고: SONARQUBE_TOOLSETS 및 SONARQUBE_READ_ONLY은 해당 특정 요청에 대해 서버 수준 도구 집합을 좁히는 선택적 요청별 헤더입니다. 범위를 줄일 수만 있을 뿐 — 서버가 시작될 때 허용된 범위를 넘어 도구 집합을 활성화하거나 제한을 해제할 수 없습니다.

참고: 로컬 개발에는 기본값인 Stdio 전송을 대신 사용하세요. HTTPS Streamable HTTP는 적절한 SSL 인증서를 갖춘 다중 사용자 프로덕션 배포를 위한 것입니다.

서비스 엔드포인트

Streamable HTTP 모드(http 또는 https)로 실행할 때 서버는 /mcp의 MCP 엔드포인트 외에 인증이 필요 없는 서비스 엔드포인트 몇 개를 노출합니다. 이러한 엔드포인트는 서비스 간 사용(모니터링, 오케스트레이션, 클라이언트 호환성 확인)을 위한 것이며 Authorization 헤더가 필요하지 않습니다.

이 엔드포인트는 Stdio 전송으로 실행할 때는 사용할 수 없습니다.

사용자 정의 인증서

SonarQube Server가 자체 서명 인증서 또는 사설 인증 기관(CA)의 인증서를 사용하는 경우, 컨테이너에 사용자 정의 인증서를 추가하여 자동으로 설치되도록 할 수 있습니다.

docker run --init --pull=always -i --rm \
  -v /path/to/your/certificates/:/usr/local/share/ca-certificates/:ro \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_URL="<url>" \
  sonarsource/sonarqube-mcp

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-v",
      "/path/to/your/certificates/:/usr/local/share/ca-certificates/:ro",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_URL",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

프록시

SonarQube MCP Server는 표준 Java 프록시 시스템 속성을 통해 HTTP 및 SOCKS5 프록시를 지원합니다.

클라이언트 인증서 (상호 TLS)

SonarQube Server가 TLS 핸드셰이크 중에 클라이언트가 인증서를 제시하도록 요구하는 경우(상호 TLS), PKCS12 키스토어를 컨테이너에 마운트하고 JAVA_OPTS를 통해 해당 위치를 전달할 수 있습니다.

docker run --init --pull=always -i --rm \
  -v /path/to/client.p12:/etc/ssl/mcp/client.p12:ro \
  -e JAVA_OPTS="-Djavax.net.ssl.keyStore=/etc/ssl/mcp/client.p12 -Djavax.net.ssl.keyStoreType=PKCS12 -Djavax.net.ssl.keyStorePassword=<passphrase>" \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_URL="<url>" \
  sonarsource/sonarqube-mcp

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run", "--init", "--pull=always", "-i", "--rm",
      "-v", "/path/to/client.p12:/etc/ssl/mcp/client.p12:ro",
      "-e", "JAVA_OPTS",
      "-e", "SONARQUBE_TOKEN",
      "-e", "SONARQUBE_URL",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "JAVA_OPTS": "-Djavax.net.ssl.keyStore=/etc/ssl/mcp/client.p12 -Djavax.net.ssl.keyStoreType=PKCS12 -Djavax.net.ssl.keyStorePassword=<passphrase>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

java \
  -Djavax.net.ssl.keyStore=/path/to/client.p12 \
  -Djavax.net.ssl.keyStoreType=PKCS12 \
  -Djavax.net.ssl.keyStorePassword=<passphrase> \
  -jar <path_to_sonarqube_mcp_server_jar>

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-Djavax.net.ssl.keyStore=/path/to/client.p12",
      "-Djavax.net.ssl.keyStoreType=PKCS12",
      "-Djavax.net.ssl.keyStorePassword=<passphrase>",
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

도구

분석

• analyze_code_snippet - SonarQube 분석기로 파일 콘텐츠를 분석하여 코드 품질 및 보안 문제를 식별합니다. 정확성을 위해 항상 전체 파일 콘텐츠를 분석합니다. 선택적으로 특정 코드 스니펫으로 결과를 필터링할 수 있습니다.

  더 이상 사용되지 않음: analyze_code_snippet는 향후 릴리스에서 제거될 예정입니다. SonarQube for IDE를 연결하여 analyze_file_list을 사용하거나, 조직에서 Vortex 분석을 활성화하여 run_advanced_code_analysis을 사용하세요(아래 참조).

  사용법:

  • 작업 공간이 마운트된 경우 (권장): filePath을 전달합니다(프로젝트 기준 경로) — 서버가 파일을 직접 읽어 에이전트 컨텍스트 창에서 파일 콘텐츠를 제외합니다
  • 작업 공간이 마운트되지 않은 경우: 전체 파일 분석을 위해 완전한 fileContent을 전달합니다(모든 이슈 보고)
  • 선택적 codeSnippet을 추가하여 결과를 필터링합니다 — 스니펫 내의 이슈만 보고됩니다(스니펫 위치 자동 감지)

  매개변수:

  • projectKey - SonarQube 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • filePath - 분석할 파일의 프로젝트 기준 경로(예: src/main/java/MyClass.java). 작업 공간이 /app/mcp-workspace에 마운트된 경우 사용 - 문자열
  • fileContent - 문자열로 된 전체 파일 콘텐츠. 작업 공간이 마운트되지 않은 경우 필수 - 문자열
  • codeSnippet - 이슈를 필터링할 코드 스니펫(fileContent의 콘텐츠와 일치해야 함) - 문자열
  • language - 코드 언어(예: 'java', 'python', 'js', 'ts', 'tsx', 'jsx') - 문자열
  • scope - 파일 범위: MAIN 또는 TEST(기본값: MAIN) - 문자열

  지원 언어: Java, Kotlin, Python, Ruby, Go, JavaScript (js, jsx), TypeScript (ts, tsx), JSP, PHP, XML, HTML, CSS, CloudFormation, Kubernetes, Terraform, Azure Resource Manager, Ansible, Docker, Secrets 감지

SonarQube for IDE 통합이 활성화된 경우: (이 두 도구는 analysis 및 ide 도구 세트 모두에 태그됩니다)

• analyze_file_list - SonarQube for IDE를 사용하여 현재 작업 디렉터리의 파일을 분석합니다. 이 도구는 실행 중인 SonarQube for IDE 인스턴스에 연결하여 파일 목록에 대한 코드 품질 분석을 수행합니다.

  • file_absolute_paths - 분석할 절대 파일 경로 목록 - 필수 String[]

• toggle_automatic_analysis - SonarQube for IDE 자동 분석을 활성화 또는 비활성화합니다. 활성화하면 SonarQube for IDE가 작업 디렉터리에서 파일이 수정될 때 자동으로 분석합니다. 비활성화하면 자동 분석이 꺼집니다.

  • enabled - 자동 분석 활성화 또는 비활성화 - 필수 Boolean

SonarQube Cloud 조직에서 Vortex 분석이 활성화된 경우:

작업 공간이 /app/mcp-workspace에 마운트되어 있어야 합니다

• run_advanced_code_analysis - 단일 파일에 대해 SonarQube Cloud에서 Vortex 분석을 실행합니다. 조직은 MCP 구성에서 유추됩니다.
  • projectKey - 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • branch - 최신 분석 컨텍스트를 검색하는 데 사용되는 브랜치 이름 - 필수 문자열
  • filePath - 분석할 파일의 프로젝트 기준 경로(예: src/main/java/MyClass.java). - 필수 문자열
  • fileScope - 파일이 시작된 범위 정의: 'MAIN' 또는 'TEST'(기본값: MAIN) - 문자열

커버리지

• search_files_by_coverage - 커버리지(오름차순 - 최저 커버리지 우선)로 정렬된 프로젝트의 파일을 검색합니다. 이 도구는 테스트 커버리지 개선이 필요한 파일을 식별하는 데 도움이 됩니다.

  • projectKey - 검색할 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열
  • maxCoverage - 최대 커버리지 임계값(0-100). 커버리지가 이 값 이하인 파일만 반환 - Number
  • pageIndex - 페이지 인덱스(1부터 시작, 기본값: 1) - Number
  • pageSize - 페이지 크기(기본값: 100, 최대: 500) - Number

• get_file_coverage_details - 특정 파일에 대한 줄 단위 커버리지 정보를 가져옵니다. 정확히 어떤 줄이 커버되지 않았고 어떤 줄에 부분적으로 커버된 브랜치가 있는지 포함합니다. 이 도구는 테스트 커버리지를 추가할 위치를 정확히 식별하는 데 도움이 됩니다. search_files_by_coverage로 커버리지가 낮은 파일을 식별한 후 사용하세요.

  • key - 파일 키(예: my_project:src/foo/Bar.java) - 필수 문자열
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열
  • from - 분석할 첫 번째 줄(1부터 시작, 기본값: 1) - Number
  • to - 분석할 마지막 줄(포함). 지정하지 않으면 모든 줄이 반환됩니다 - Number

종속성 위험

참고: 종속성 위험은 SonarQube Advanced Security가 활성화된 SonarQube Server 2025.4 Enterprise 이상에 연결할 때만 사용할 수 있습니다.

• search_dependency_risks - 분석된 프로젝트, 애플리케이션 또는 포트폴리오에 나타나는 릴리스와 함께 SonarQube 프로젝트의 소프트웨어 구성 분석 이슈(종속성 위험)를 검색합니다.
  • projectKey - 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열
  • pageIndex - 선택적 페이지 인덱스(1부터 시작, 기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기. 0보다 크고 500 이하여야 함(기본값: 100) - Integer

엔터프라이즈

참고: 엔터프라이즈는 SonarQube Cloud에 연결할 때만 사용할 수 있습니다.

• list_enterprises - 액세스 권한이 있는 SonarQube Cloud에서 사용 가능한 엔터프라이즈를 나열합니다. 이 도구를 사용하여 다른 도구와 함께 사용할 수 있는 엔터프라이즈 ID를 찾으세요.
  • enterpriseKey - 결과를 필터링할 선택적 엔터프라이즈 키 - 문자열

이슈

• change_sonar_issue_status - SonarQube 이슈의 상태를 "accept", "falsepositive"로 변경하거나 이슈를 "reopen"합니다.

  • key - 이슈 키 - 필수 문자열
  • status - 새 이슈 상태 - 필수 Enum {"accept", "falsepositive", "reopen"}

• search_sonar_issues_in_projects - 내 조직의 프로젝트에서 SonarQube 이슈를 검색합니다.

  • projectKeys - 선택적 SonarQube 프로젝트 키 목록 - String[]
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열
  • severities - 필터링할 선택적 심각도 목록. 가능한 값: INFO, LOW, MEDIUM, HIGH, BLOCKER - String[]
  • impactSoftwareQualities - 필터링할 선택적 소프트웨어 품질 목록. 가능한 값: MAINTAINABILITY, RELIABILITY, SECURITY - String[]
  • issueStatuses - 필터링할 선택적 이슈 상태 목록. 가능한 값: OPEN, CONFIRMED, FALSE_POSITIVE, ACCEPTED, FIXED, IN_SANDBOX - String[]
  • issueKey - 특정 이슈를 가져오기 위한 선택적 이슈 키 - 문자열
  • pageIndex - 선택적 1부터 시작하는 페이지 인덱스(기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기. 0보다 크고 500 이하여야 함(기본값: 100) - Integer

보안 핫스팟

• search_security_hotspots - SonarQube 프로젝트에서 보안 핫스팟을 검색합니다.

  • projectKey - 프로젝트 또는 애플리케이션 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • hotspotKeys - 검색할 특정 보안 핫스팟 키의 쉼표로 구분된 목록 - String[]
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열
  • files - 필터링할 선택적 파일 경로 목록 - String[]
  • status - 선택적 상태 필터: TO_REVIEW, REVIEWED - 문자열
  • resolution - 선택적 해결 필터: FIXED, SAFE, ACKNOWLEDGED - 문자열
  • sinceLeakPeriod - 누수 기간(새 코드) 이후 생성된 핫스팟 필터링 - Boolean
  • onlyMine - 나에게 할당된 핫스팟만 표시 - Boolean
  • pageIndex - 선택적 1부터 시작하는 페이지 인덱스(기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기. 0보다 크고 500 이하여야 함(기본값: 100) - Integer

• show_security_hotspot - 규칙 세부 정보, 코드 컨텍스트, 흐름 및 주석을 포함한 특정 보안 핫스팟에 대한 자세한 정보를 가져옵니다.

  • hotspotKey - 보안 핫스팟 키 - 필수 문자열

• change_security_hotspot_status - 상태를 변경하여 보안 핫스팟을 검토합니다. REVIEWED로 표시할 때는 해결 방법(FIXED, SAFE 또는 ACKNOWLEDGED)을 지정해야 합니다.

  • hotspotKey - 보안 핫스팟 키 - 필수 문자열
  • status - 새 상태 - 필수 Enum {"TO_REVIEW", "REVIEWED"}
  • resolution - 상태가 REVIEWED인 경우의 해결 방법 - Enum {"FIXED", "SAFE", "ACKNOWLEDGED"}
  • comment - 선택적 검토 주석 - 문자열

언어

• list_languages - 이 SonarQube 인스턴스에서 지원되는 모든 프로그래밍 언어를 나열합니다.
  • q - 언어 키/이름을 매칭할 선택적 패턴 - 문자열

측정값

• get_component_measures - 구성 요소(프로젝트, 디렉터리, 파일)에 대한 SonarQube 측정값을 가져옵니다.
  • projectKey - 프로젝트 키 - SONARQUBE_PROJECT_KEY가 구성되지 않은 경우 필수 문자열
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches을 사용하세요 - 문자열
  • metricKeys - 검색할 선택적 메트릭 키(예: ncloc, complexity, violations, coverage) - String[]
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests을 사용하세요 - 문자열

메트릭

• search_metrics - SonarQube 메트릭을 검색합니다.
  • pageIndex - 선택적 1부터 시작하는 페이지 인덱스(기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기. 0보다 크고 500 이하여야 함(기본값: 100) - Integer

포트폴리오

• list_portfolios - SonarQube에서 사용 가능한 엔터프라이즈 포트폴리오를 필터링 및 페이지네이션 옵션과 함께 나열합니다.

  SonarQube Server용:

  • q - 이름 또는 키로 포트폴리오를 필터링하는 선택적 검색어 - String
  • favorite - true인 경우 즐겨찾는 포트폴리오만 반환 - Boolean
  • pageIndex - 선택적 1부터 시작하는 페이지 번호 (기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기, 최대 500 (기본값: 100) - Integer

  SonarQube Cloud용:

  • enterpriseId - 엔터프라이즈 UUID. 'favorite' 매개변수가 true로 제공된 경우에만 생략 가능 - String
  • q - 이름으로 포트폴리오를 필터링하는 선택적 검색어 - String
  • favorite - 'enterpriseId' 매개변수가 생략된 경우 true여야 합니다. true인 경우 로그인한 사용자가 즐겨찾기한 포트폴리오만 반환합니다. 'draft'가 true인 경우 true일 수 없습니다 - Boolean
  • draft - true인 경우 로그인한 사용자가 생성한 초안만 반환합니다. 'favorite'가 true인 경우 true일 수 없습니다 - Boolean
  • pageIndex - 가져올 페이지의 선택적 인덱스 (기본값: 1) - Integer
  • pageSize - 가져올 페이지의 선택적 크기 (기본값: 50) - Integer

프로젝트

• search_my_sonarqube_projects - SonarQube 프로젝트를 찾습니다. 응답은 페이지네이션됩니다.

  • pageIndex - 선택적 1부터 시작하는 페이지 인덱스 (기본값: 1) - Integer
  • pageSize - 선택적 페이지 크기. 0보다 크고 500보다 작거나 같아야 합니다 (기본값: 500) - Integer
  • q - 이름(부분 일치) 또는 키(정확히 일치)로 프로젝트를 필터링하는 선택적 검색어 - String

• list_branches - 프로젝트에 대해 분석된 브랜치를 나열합니다.

  • SonarQube Cloud: LONG 및 SHORT 브랜치를 type 및 mergeBranch 필드와 함께 반환합니다. 선택적 branchTypes 필터: ALL (기본값), LONG, 또는 SHORT.
  • SonarQube Server: 분석된 모든 브랜치(이름, 품질 게이트, 분석 날짜)를 반환합니다. type, mergeBranch, 또는 branchTypes 필터는 없습니다.
  • 반환된 브랜치 이름을 다른 도구의 branch 매개변수로 사용하세요. 풀 리퀘스트 분석의 경우 대신 list_pull_requests를 사용하세요.
  • projectKey - 프로젝트 키 (예: my_project) - 필수 String (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • branchTypes - (SonarQube Cloud 전용) 선택적 필터: ALL (기본값), LONG, 또는 SHORT - Enum {"ALL", "LONG", "SHORT"}

• list_pull_requests - 프로젝트의 모든 풀 리퀘스트를 나열합니다. 이 도구를 사용하여 PR 데코레이션 분석(커버리지, 이슈, 품질 게이트)을 위한 풀 리퀘스트를 찾으세요. 다른 도구와 함께 사용할 수 있는 풀 리퀘스트 키/ID를 반환합니다. 풀 리퀘스트 없는 브랜치 기반 분석의 경우 list_branches를 대신 사용하세요.

  • projectKey - 프로젝트 키 (예: my_project) - 필수 String (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)

품질 게이트

• get_project_quality_gate_status - SonarQube 프로젝트의 품질 게이트 상태를 가져옵니다.

  • analysisId - 선택적 분석 ID - String
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches를 사용하세요 - String
  • projectId - 선택적 프로젝트 ID - String
  • projectKey - 선택적 프로젝트 키 - String
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests를 사용하세요 - String

• list_quality_gates - 내 SonarQube의 모든 품질 게이트를 나열합니다.

규칙

• show_rule - SonarQube 규칙에 대한 상세 정보를 표시합니다.
  • key - 규칙 키 - 필수 String

중복

• search_duplicated_files - SonarQube 프로젝트에서 코드 중복이 있는 파일을 검색합니다. 기본적으로 모든 페이지의 중복 파일을 자동으로 가져옵니다(최대 10,000개 파일). 중복이 있는 파일만 반환합니다.

  • projectKey - 프로젝트 키 - 필수 String (SONARQUBE_PROJECT_KEY가 정의된 경우 무시됨)
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches를 사용하세요 - String
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests를 사용하세요 - String
  • pageSize - 수동 페이지네이션을 위한 페이지당 결과 수 (최대: 500). 지정하지 않으면 모든 중복 파일을 자동으로 가져옵니다 - Integer
  • pageIndex - 수동 페이지네이션을 위한 선택적 페이지 번호 (1부터 시작). 지정하지 않으면 모든 중복 파일을 자동으로 가져옵니다 - Integer

• get_duplications - 파일의 중복을 가져옵니다. 파일의 프로젝트에 대한 Browse 권한이 필요합니다.

  • key - 파일 키 - 필수 String
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches를 사용하세요 - String
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests를 사용하세요 - String

소스

• get_raw_source - SonarQube에서 소스 코드를 원시 텍스트로 가져옵니다. 파일에 대한 'See Source Code' 권한이 필요합니다.

  • key - 파일 키 - 필수 String
  • branch - 브랜치 기반 분석을 위한 선택적 브랜치 이름. 유효한 이름을 찾으려면 list_branches를 사용하세요 - String
  • pullRequest - 선택적 풀 리퀘스트 키/ID. 유효한 키를 찾으려면 list_pull_requests를 사용하세요 - String

• get_scm_info - SonarQube 소스 파일의 SCM 정보를 가져옵니다. 파일의 프로젝트에 대한 See Source Code 권한이 필요합니다.

  • key - 파일 키 - 필수 String
  • commits_by_line - 값이 false이면 SCM 커밋별로 줄을 그룹화하고, 그렇지 않으면 각 줄에 커밋을 표시합니다 - String
  • from - 반환할 첫 번째 줄. 1부터 시작합니다 - Number
  • to - 반환할 마지막 줄(포함) - Number

시스템

참고: 시스템 도구는 SonarQube Server에 연결할 때만 사용할 수 있습니다.

• get_system_health - SonarQube Server 인스턴스의 상태를 가져옵니다. GREEN(완전 작동), YELLOW(사용 가능하지만 주의 필요), 또는 RED(작동하지 않음)를 반환합니다.

• get_system_info - JVM 상태, 데이터베이스, 검색 인덱스 및 설정을 포함한 SonarQube Server 시스템 구성에 대한 상세 정보를 가져옵니다. 'Administer' 권한이 필요합니다.

• get_system_logs - SonarQube Server 시스템 로그를 일반 텍스트 형식으로 가져옵니다. 시스템 관리 권한이 필요합니다.

  • name - 가져올 로그의 선택적 이름. 가능한 값: access, app, ce, deprecation, es, web. 기본값: app - String

• ping_system - SonarQube Server 시스템이 활성 상태인지 확인하기 위해 ping을 보냅니다. 일반 텍스트로 'pong'을 반환합니다.

• get_system_status - SonarQube Server의 상태 정보를 가져옵니다. 상태(STARTING, UP, DOWN, RESTARTING, DB_MIGRATION_NEEDED, DB_MIGRATION_RUNNING), 버전 및 ID를 반환합니다.

웹훅

• create_webhook - SonarQube 조직 또는 프로젝트에 대한 새 웹훅을 생성합니다. 지정된 프로젝트에 대한 'Administer' 권한 또는 전역 'Administer' 권한이 필요합니다.

  • name - 웹훅 이름 - 필수 String
  • url - 웹훅 URL - 필수 String
  • projectKey - 프로젝트별 웹훅을 위한 선택적 프로젝트 키 - String
  • secret - 웹훅 페이로드 보안을 위한 선택적 웹훅 시크릿 - String

• list_webhooks - SonarQube 조직 또는 프로젝트의 모든 웹훅을 나열합니다. 지정된 프로젝트에 대한 'Administer' 권한 또는 전역 'Administer' 권한이 필요합니다.

  • projectKey - 프로젝트별 웹훅을 나열하기 위한 선택적 프로젝트 키 - String

컨텍스트 증강

# macOS/Linux (Bash/Zsh)
export SONARQUBE_TOKEN="{<YourUserToken>}"

{
  "mcpServers": {
    "sonarqube-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--pull=always",
        "-e", "SONARQUBE_URL",
        "-e", "SONARQUBE_TOKEN",
        "-e", "SONARQUBE_ORG",
        "-e", "SONARQUBE_PROJECT_KEY",
        "-e", "SONARQUBE_TOOLSETS",
        "-v", "/ABSOLUTE/PATH/TO/YOUR/PROJECT:/app/mcp-workspace:rw",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_URL": "https://sonarcloud.io",
        "SONARQUBE_ORG": "<YourOrganizationKey>",
        "SONARQUBE_PROJECT_KEY": "<YourProjectKey>",
        "SONARQUBE_TOOLSETS": "cag"
      }
    }
  }
}

에이전트 준비성(Agentic Readiness)

참고: 에이전트 준비성 도구는 SonarQube Cloud에서만 사용할 수 있으며 조직에 해당 기능이 활성화되어 있어야 합니다.

• start_agentic_readiness_assessment - 프로젝트에 대한 에이전트 준비성 평가를 시작합니다. PENDING 상태와 assessmentId을(를) 즉시 반환합니다. 결과를 폴링하려면 get_agentic_readiness_assessment을(를) 사용하십시오.

  • projectKey - 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY이(가) 정의된 경우 무시됨)
  • branch - 평가할 브랜치. 생략하면 프로젝트의 기본 브랜치를 사용합니다 - String

• get_agentic_readiness_assessment - 평가 결과를 검색합니다. 상태가 COMPLETED, FAILED 또는 INTERRUPTED이(가) 될 때까지 동일한 assessmentId으로 다시 호출하십시오. 완료되면 전체 수준과 권장 조치 및 증거가 포함된 기둥별 분석을 반환합니다.

  • assessmentId - start_agentic_readiness_assessment이(가) 반환한 평가 ID - 필수 문자열

• list_agentic_readiness_assessments - 프로젝트의 모든 평가를 최신순으로 나열합니다. 전체 기둥 수준 결과를 보려면 get_agentic_readiness_assessment을(를) 사용하십시오.

  • projectKey - 평가를 나열할 프로젝트 키 - 필수 문자열 (SONARQUBE_PROJECT_KEY이(가) 정의된 경우 무시됨)
  • branch - 브랜치 이름으로 평가를 필터링합니다. 생략하면 모든 브랜치의 평가를 나열합니다 - String
  • pageIndex - 1부터 시작하는 페이지 인덱스(기본값: 1) - Number
  • pageSize - 페이지당 항목 수, 최대 100(기본값: 50) - Number

예시 프롬프트

SonarQube MCP 서버를 설정한 후 일반적인 실제 시나리오에 대한 몇 가지 예시 프롬프트는 다음과 같습니다:

My quality gate is failing for my project. Can you help me understand why and fix the most critical issues?

The quality gate on my feature branch is red. What do I need to fix to get it passing before I can merge to main?

I'm about to merge my pull request <#247> for the <web-app> project. Can you check if there are any quality issues I should address first?

We're deploying to production tomorrow. Can you check the quality gate status and alert me to any critical issues in this branch?

I want to reduce technical debt in my project. What are the top issues I should prioritize?

Our code coverage dropped below 70%. Can you identify which files have the lowest coverage and help me improve it?

I have 15 new code smells in my latest commit. Can you explain what they are and help me fix them?

SonarQube flagged a critical security vulnerability in <AuthController.java>. What's the issue and how do I fix it?

We need to pass a security audit. Can you check all our projects for security vulnerabilities and create a prioritized list of what needs to be fixed?

Are there any known vulnerabilities in our dependencies? Check this project for dependency risks.

I just wrote this authentication function. Can you analyze it for security issues and code quality problems before I commit?

Review the changes in <src/database/migrations> for any potential bugs or security issues.

Give me a health report for my project: quality gate status, number of bugs, Security Hotspots, and code coverage.

Compare code quality between our main branch and the develop branch. Are we introducing new issues?

What are the most common rule violations across all our projects? We might need to update our coding standards.

Show me all the issues that were marked as false positives in the last month. Are we seeing patterns that suggest our rules need adjustment?

빌드

sonarsource/sonarqube-mcp 컨테이너 이미지를 사용하는 것을 권장합니다.

Docker 없이 독립 실행형 JAR로 서버를 실행하려면 SonarSource 바이너리 저장소에서 사전 빌드된 릴리스를 다운로드하십시오. 모든 릴리스 버전은 sonarqube-mcp-server-<version>.jar(으)로 게시됩니다(예: sonarqube-mcp-server-1.19.0.2785.jar).

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "STORAGE_PATH": "<path_to_your_mcp_storage>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_ORG": "<org>"
    }
  }
}

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "STORAGE_PATH": "<path_to_your_mcp_storage>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

./gradlew clean build -x test

./gradlew :dependencies --write-locks
./gradlew :its:dependencies --write-locks

문제 해결

애플리케이션 로그는 기본적으로 STORAGE_PATH/logs/mcp.log 파일에 기록됩니다. 파일 로깅을 완전히 비활성화하려면 SONARQUBE_LOG_TO_FILE_DISABLED=true을(를) 설정하십시오.

일반적인 문제

"기능이 작동하지 않습니다" 또는 "도구/기능이 없습니다"

오래된 Docker 이미지를 실행 중일 수 있습니다. Docker는 이미지를 로컬에 캐시하므로 업데이트를 자동으로 받지 못합니다.

해결 방법: 최신 버전으로 업데이트하십시오:

docker pull sonarsource/sonarqube-mcp

최신 이미지를 가져온 후 MCP 클라이언트를 다시 시작하여 업데이트된 버전을 사용하십시오.

선택적으로 docker run 명령에 --pull=always 플래그를 추가하여 항상 최신 버전을 확인하고 가져오도록 할 수 있습니다:

docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp

"특정 버전으로 고정하고 싶습니다"

sonarsource/sonarqube-mcp에서 사용 가능한 태그를 찾아보고 원하는 버전을 참조하십시오:

docker pull sonarsource/sonarqube-mcp:1.19.0.2785

docker run --init -i --rm \
  -e SONARQUBE_TOKEN -e SONARQUBE_ORG \
  sonarsource/sonarqube-mcp:1.19.0.2785

MCP 클라이언트 구성에서 sonarsource/sonarqube-mcp 대신 sonarsource/sonarqube-mcp:<version>을(를) 사용하고 --pull=always을(를) 제거하여 Docker가 이미지를 자동으로 업그레이드하지 않도록 하십시오.

데이터 및 원격 측정

이 서버는 익명 사용 데이터를 수집하여 제품 개선을 위해 SonarSource로 전송합니다. 소스 코드나 IP 주소는 수집되지 않으며 SonarSource는 데이터를 다른 사람과 공유하지 않습니다. 원격 측정 수집은 다음 시스템 속성 또는 환경 변수로 비활성화할 수 있습니다: TELEMETRY_DISABLED=true. 수집되는 데이터의 샘플을 보려면 여기를 클릭하십시오.

라이선스

저작권 2025 SonarSource.

SONAR 소스 제공 가능 라이선스 v1.0에 따라 사용 허가됩니다. 이 문서를 준수하여 SonarQube MCP 서버를 사용하는 것은 비경쟁 목적이므로 SSAL에 따라 허용됩니다.

MCP를 통한 SonarQube 사용은 SonarQube Cloud 서비스 약관 또는 SonarQube Server 이용 약관의 적용을 받으며, 결과 데이터를 내부 소프트웨어 개발 목적으로만 사용하는 것을 포함합니다.