SonarQube MCP Server의 개요
SonarQube MCP Server는 AI 에이전트를 SonarQube Cloud와 SonarQube Server에 연결하는 SonarSource의 공식 서버입니다. 저장소는 SonarSource/sonarqube-mcp-server이며(별도의 sonar-mcp-server는 없습니다), 1.31.0 버전이 2026년 11월 2일에 나왔습니다. 에이전트는 이를 통해 이슈와 Security Hotspot을 검색하고, 프로젝트의 품질 게이트를 확인하고, 커버리지·중복·의존성 위험 데이터를 읽고, 커밋 전에 파일에 Sonar 분석기를 돌릴 수 있습니다.
sonarsource/sonarqube-mcp 컨테이너를 stdio나 Streamable HTTP로 직접 실행하거나, 2026년 3월부터는 SonarQube Cloud에 내장된 호스팅 엔드포인트 https://api.sonarcloud.io/mcp에 HTTP 클라이언트를 연결할 수 있습니다. 서버 자체는 무료이고 SONAR Source-Available License(소스는 공개되지만 오픈소스는 아님)로 배포되지만, 쓸모는 뒤에 있는 SonarQube 요금제만큼입니다.
SonarQube MCP Server 설치 방법
docker run --init -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp (or https://api.sonarcloud.io/mcp)SonarQube MCP Server, 쓸 만한 가치가 있습니까?
SonarQube MCP Server는 이미 SonarQube로 풀 리퀘스트를 통과시키는 팀이라면 설치할 가치가 있고, 그렇지 않은 팀에는 거의 쓸모가 없습니다. 핵심 가치는 에이전트가 CI가 적용할 것과 똑같은 이슈, 규칙, 품질 게이트 판정을 보고, 풀 리퀘스트를 열기 전에 실패하는 게이트를 고칠 수 있다는 점입니다. README에는 20개 도구 세트에 걸친 51개 도구가 정리되어 있으며, search_sonar_issues_in_projects와 get_project_quality_gate_status부터 커버되지 않은 줄을 정확히 짚어 주는 커버리지 조회까지 있습니다.
분석 방식은 알고 써야 합니다. 기본 도구인 analyze_code_snippet은 파일에 Sonar 분석기를 돌리지만, 에이전트가 파일 전체를 인수로 넘겨야 해서 호출할 때마다 컨텍스트를 씁니다. 프로젝트를 컨테이너의 /app/mcp-workspace에 마운트하면 서버가 디스크에서 직접 파일을 읽습니다. 더 깊은 Vortex 분석과 코드 컨텍스트 도구(호출 그래프, 타입 계층, 의존성 검사)는 stdio에서만 동작하고, 워크스페이스 마운트와 Vortex 애드온 권한이 있는 조직이 필요하며, Sonar 요금표는 이를 Enterprise 고객용으로 둡니다.
Cloud 호스팅 엔드포인트는 Docker가 필요 없지만 도구가 줄어듭니다. Sonar 문서에 따르면 "더 작고 고정된 도구 하위 집합"만 노출하고, 공유 인프라를 보호하려고 무거운 분석을 끄며, Vortex를 돌릴 수 없습니다. 그곳에서는 Claude Code, Codex, Cursor, VS Code, ChatGPT 등 승인된 클라이언트가 OAuth로 로그인할 수 있습니다. 직접 운영하는 서버는 여전히 SonarQube 사용자 토큰이 필요하고, SonarQube Server는 2025.1 이상이어야 합니다.
주의할 점: SONARQUBE_READ_ONLY=true를 설정하지 않으면 쓰기 도구가 켜져 있습니다. 그래서 에이전트가 이슈를 오탐으로 표시하거나 Security Hotspot을 수락할 수 있는데, 게이트를 통과해야 한다는 압박을 받는 모델이 택할 법한 바로 그 지름길입니다. 직접 운영하는 서버는 기본적으로 익명 사용 텔레메트리를 SonarSource에 보내며(README에 따르면 소스 코드는 포함하지 않음), TELEMETRY_DISABLED=true로 끌 수 있습니다. 또 연결된 SonarQube 인스턴스가 재시작되면 서버를 재시작할 때까지 모든 호출이 실패한다는 미해결 이슈가 있습니다.
우리의 판단: 읽기 전용으로 돌리고 최종 판정은 CI의 품질 게이트에 맡기세요. Sonar와 계약이 없는 팀에는 무료 엔진만으로 돌아가는 Semgrep 서버가 더 잘 맞습니다.
제 역할을 하는 곳
SonarQube Cloud Team을 쓰는 15명 규모의 Java 팀
에이전트가 작성한 풀 리퀘스트가 품질 게이트에서 떨어지지 않게 하기
에이전트가 자기 브랜치에서 get_project_quality_gate_status와 search_sonar_issues_in_projects를 호출해 찾은 문제를 고친 뒤 풀 리퀘스트를 엽니다. SONARQUBE_READ_ONLY=true로 돌리면 이슈를 닫는 대신 코드를 고칩니다. Team 요금제(10만 줄에 월 34달러부터) 외에 비용이 들지 않습니다.
레거시 모듈의 커버리지를 올리라는 요청을 받은 엔지니어
아무도 테스트하지 않은 줄에 테스트 쓰기
search_files_by_coverage가 커버리지가 가장 낮은 파일을 보여 주고, get_file_coverage_details가 커버되지 않은 줄과 분기를 정확히 알려 주므로 에이전트가 짐작 대신 겨냥한 테스트를 씁니다.
로컬 Docker를 금지하는 은행의 엔지니어링 매니저
아무것도 설치하지 않고 개발자의 AI 어시스턴트에서 Sonar 발견 사항을 보게 하기
Claude Code나 VS Code를 https://api.sonarcloud.io/mcp에 연결하고 OAuth로 로그인합니다. 호스팅 서버는 도구가 적고 무거운 분석이 없지만, 노트북에 배포하거나 토큰을 관리할 필요가 없습니다.
도입 전 확인할 점
- 설정
- docker run --init -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp. Claude Code, Codex, Cursor, Copilot, Gemini CLI, Kiro, VS Code, Windsurf, Zed용 설정이 문서화되어 있고 mcp.sonarqube.com에 설정 생성기가 있습니다. 또는 호스팅 엔드포인트 https://api.sonarcloud.io/mcp(미국 리전은 https://api.sonarqube.us/mcp)를 씁니다.
- 연동
- 20개 도구 세트에 51개 도구: 이슈, Security Hotspot, 품질 게이트, 규칙, 측정값, 커버리지, 중복, 의존성 위험, 소스, 웹훅, 포트폴리오, Server 관리, 그리고 Vortex 컨텍스트 도구와 아키텍처 도구. 쓰기 도구로 change_sonar_issue_status, change_security_hotspot_status, create_webhook이 있으며 SONARQUBE_TOOLSETS와 SONARQUBE_READ_ONLY로 목록을 줄일 수 있습니다.
- 데이터와 개인정보
- 사용자 토큰은 그 사용자가 볼 수 있는 모든 것을 읽으며, sources 도구 세트가 켜져 있으면 get_raw_source로 원본 소스 코드도 읽습니다. 호스팅 엔드포인트는 Sonar 인프라에서 돌아가고, OAuth 스코프 mcp:tools:read와 mcp:tools:write가 읽기와 쓰기를 나눕니다. 직접 운영하는 서버는 TELEMETRY_DISABLED=true가 아니면 익명 텔레메트리를 보냅니다. 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 서버는 무료이고 비용은 SonarQube에서 나옵니다. Cloud Team은 비공개 코드 10만 줄에 월 34달러부터이며 5만 줄까지는 무료입니다. Server는 인스턴스당 연 단위로 코드 줄 수에 따라 견적을 받고, 라이선스 줄 수를 넘으면 새 분석이 거부됩니다. Vortex, Advanced Security(의존성 위험), Sonar의 에이전트는 별도 구독입니다. Sonar는 MCP 엔드포인트의 속도 제한을 공개하지 않습니다.
- 제한
- 호스팅 엔드포인트는 고정된 작은 도구 세트이며 Vortex가 없음. SonarQube Server의 OAuth는 아직 미지원. 최소 Server 2025.1 또는 Community Build 25.1. Server 연결에는 프로젝트 토큰이나 전역 토큰이 아닌 USER 토큰이 필요. SonarQube 인스턴스 재시작 후 호출이 계속 실패한다는 미해결 이슈가 있음.
좋은 점
- SonarQube CI와 같은 이슈, 규칙, 품질 게이트
- OAuth를 지원하는 호스팅 Cloud 엔드포인트, Docker 불필요
- 읽기 전용 모드와 도구 세트별 필터로 컨텍스트 절약
- 빠진 테스트를 쓰기 위한 줄 단위 커버리지 도구
- SonarSource가 직접 내는 잦은 릴리스
아쉬운 점
- SonarQube Cloud나 Server 구독 없이는 쓸모가 적음
- 쓰기 도구가 기본으로 켜져 있어 에이전트가 발견 사항을 오탐으로 표시할 수 있음
- 워크스페이스를 마운트하지 않으면 스니펫 분석이 파일 전체를 컨텍스트로 보냄
- Vortex 분석은 유료 Enterprise 애드온과 stdio가 필요
- 텔레메트리가 기본으로 켜짐. 소스 공개형 라이선스로 오픈소스가 아님
추천 대상
이미 SonarQube로 머지를 관리하며, 풀 리퀘스트를 열기 전에 코딩 에이전트가 그 게이트를 통과하기를 원하는 팀.
SonarQube MCP Server 대안
SonarQube MCP Server: 자주 묻는 질문
- SonarQube MCP Server, 쓸 만한 가치가 있습니까?
- 머지가 이미 SonarQube 품질 게이트를 기다린다면, 에이전트 가 그 게이트를 당신보다 먼저 읽어 줍니다. SonarQube 구독이 없다면 얻을 게 별로 없습니다. 평점은 5점 만점에 4.1점입니다.
- SonarQube MCP Server의 가격은 얼마입니까?
- 서버는 무료(SONAR Source-Available License). SonarQube Cloud는 비공개 프로젝트 5만 줄(50k)까지 무료, Team은 10만 줄(100k)에 월 34달러부터. Server 에디션은 인스턴스당 연 단위로 코드 줄 수에 따라 견적만 제공. Vortex는 별도 애드온.
- SonarQube MCP Server의 단점은 무엇입니까?
- SonarQube Cloud나 Server 구독 없이는 쓸모가 적음; 쓰기 도구가 기본으로 켜져 있어 에이전트가 발견 사항을 오탐으로 표시할 수 있음; 워크스페이스를 마운트하지 않으면 스니펫 분석이 파일 전체를 컨텍스트로 보냄; Vortex 분석은 유료 Enterprise 애드온과 stdio가 필요; 텔레메트리가 기본으로 켜짐. 소스 공개형 라이선스로 오픈소스가 아님.
- SonarQube MCP Server에 적합한 사람은 누구입니까?
- 이미 SonarQube로 머지를 관리하며, 풀 리퀘스트를 열기 전에 코딩 에이전트가 그 게이트를 통과하기를 원하는 팀.
- 팀이나 프로덕션 환경에서 SonarQube MCP Server의 비용은 얼마입니까?
- 서버는 무료이고 비용은 SonarQube에서 나옵니다. Cloud Team은 비공개 코드 10만 줄에 월 34달러부터이며 5만 줄까지는 무료입니다. Server는 인스턴스당 연 단위로 코드 줄 수에 따라 견적을 받고, 라이선스 줄 수를 넘으면 새 분석이 거부됩니다. Vortex, Advanced Security(의존성 위험), Sonar의 에이전트는 별도 구독입니다. Sonar는 MCP 엔드포인트의 속도 제한을 공개하지 않습니다.
- SonarQube MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 사용자 토큰은 그 사용자가 볼 수 있는 모든 것을 읽으며, sources 도구 세트가 켜져 있으면 get_raw_source로 원본 소스 코드도 읽습니다. 호스팅 엔드포인트는 Sonar 인프라에서 돌아가고, OAuth 스코프 mcp:tools:read와 mcp:tools:write가 읽기와 쓰기를 나눕니다. 직접 운영하는 서버는 TELEMETRY_DISABLED=true가 아니면 익명 텔레메트리를 보냅니다. 공개된 보안 권고는 없습니다.
- SonarQube MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Semgrep MCP, Snyk MCP Server (Snyk Studio) 및 GitHub MCP Server입니다.
답변 확인일: 2026년 11월 9일.
SonarQube MCP Server 개발사입니까? 이 평점을 사이트에 표시하십시오
