SonarQube

SonarQube MCP Sunucusu

SonarQube MCP Sunucusu, kod kalitesi ve güvenliği için SonarQube Server veya Cloud ile sorunsuz entegrasyon sağlayan bir Model Context Protocol (MCP) sunucusudur. Ayrıca, aracı bağlamında doğrudan kod parçacıklarının analizini de destekler.

Hızlı kurulum

🚀 Yapılandırmanızı oluşturun

Başlamanın en hızlı yolu SonarQube MCP Sunucusu Yapılandırma Oluşturucu – tercih ettiğiniz AI aracı istemcisi için kullanıma hazır bir yapılandırma üreten etkileşimli bir araçtır.

Manuel kurulum

Kendiniz yapılandırmayı tercih ediyorsanız, en basit yöntem sonarsource/sonarqube-mcp konteyner görüntümüzü kullanmaktır. Otomatik güncellemeler için sonarsource/sonarqube-mcp kullanın (--pull=always ile) veya tekrarlanabilir dağıtımlar için bir sürüm etiketine sabitleyin (örn. sonarsource/sonarqube-mcp:1.19.0.2785). Yerel olarak oluşturmak istiyorsanız aşağıyı okuyun.

Not: Aşağıdaki örnekler docker kullanırken, OCI uyumlu herhangi bir konteyner çalışma zamanı çalışır (örn. Podman, nerdctl). docker öğesini tercih ettiğiniz araçla değiştirmeniz yeterlidir.

{
  "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"
}

💡 İpucu: En güncel özelliklere ve düzeltmelere sahip olduğunuzdan emin olmak için en son görüntüyü düzenli olarak çekmenizi veya sorun bildirmeden önce çekmenizi öneririz.

Manuel kurulum

SonarQube MCP sunucusunu, MCP sunucuları yapılandırma dosyasına aşağıdaki parçacığı kopyalayarak manuel olarak kurabilirsiniz:

• SonarQube Cloud'a bağlanmak için:

{
  "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'a bağlanmak için:

{
  "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 ile entegrasyon

SonarQube MCP Sunucusu, geliştirme iş akışınızı daha da geliştirmek için SonarQube for IDE ile entegre olabilir ve IDE'nizde doğrudan daha iyi kod analizi ve içgörüler sağlar.

{
  "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>"
    }
  }
}

Yapılandırma

Ortamınıza bağlı olarak, belirli ortam değişkenlerini sağlamalısınız.

Temel

MCP Sunucusunu çalıştırırken aşağıdaki değişkeni eklemelisiniz:

Çalışma Alanı Bağlama (Bağlam Şişkinliğini Azaltma)

Varsayılan olarak, analyze_code_snippet analiz aracı, aracının tam dosya içeriğini bir fileContent argümanı olarak geçirmesini gerektirir. Büyük dosyalar veya bir oturumda birçok dosyayı analiz ederken, bu bağlam penceresi kullanımını ve maliyeti önemli ölçüde artırır. Çözüm: Proje dizininizi kapsayıcıya /app/mcp-workspace konumunda bağlayın. Bu bağlama algılandığında, sunucu dosyaları doğrudan diskten proje-göreli filePath bağımsız değişkenini kullanarak okur — dosya içeriği asla aracı bağlamından geçmez.

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

Bağlama etkin olduğunda:

• Kuruluşunuz buna yetkiliyse run_advanced_code_analysis kullanılabilir hale gelir
• analyze_code_snippet: filePath gereklidir ve fileContent kullanılmaz — sunucu dosyayı aynı şekilde çözer

Seçici Araç Seti Etkinleştirme

Varsayılan olarak, bağlam yükünü azaltmak için yalnızca önemli araç setleri etkinleştirilir. Gerektiğinde ek araç setlerini etkinleştirebilirsiniz.

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

Tam işlevselliği etkinleştirmek için, sunucuyu başlatmadan önce aşağıdaki ortam değişkenleri ayarlanmalıdır:

Örnekler:

• SonarQube Cloud: Yalnızca SONARQUBE_TOKEN ve SONARQUBE_ORG gereklidir
• SonarQube Cloud US: SONARQUBE_TOKEN, SONARQUBE_ORG ve SONARQUBE_URL=https://sonarqube.us ayarlayın

SonarQube Server

Sürüm gereksinimi: SonarQube Server 2025.1 (SQS) veya 25.1 (SonarQube Community Build) veya sonrası gereklidir. Başlangıçta, MCP sunucusu bağlı örnek sürümünü okur ve çok eskiyse bir hata ile çıkar (örneğin, eski 9.x/10.x Server sürümleri ve Community Build 24.x desteklenmez). SonarQube Cloud bu kontrole tabi değildir.

⚠️ SonarQube Server'a bağlantı, USER türünde bir token gerektirir ve proje tokenları veya global tokenlar kullanılırsa düzgün çalışmaz.

💡 Yapılandırma İpucu (stdio modu): SONARQUBE_ORG varlığı, SonarQube Cloud'a mı yoksa Server'a mı bağlandığınızı belirler. SONARQUBE_ORG ayarlanmışsa SonarQube Cloud kullanılır; aksi takdirde SonarQube Server kullanılır.

Taşıma Modları

MCP spesifikasyonu iki taşıma mekanizması tanımlar: Stdio ve Streamable HTTP. SonarQube MCP Sunucusu her ikisini de destekler:

Not: Streamable HTTP, güncel MCP ağ taşımasıdır. Önceki MCP sürümlerindeki yalnızca SSE tabanlı eski HTTP taşıması kullanımdan kaldırılmıştır ve desteklenmez.

1. Stdio (Varsayılan - Yerel Geliştirme için Önerilir)

Yerel geliştirme ve tek kullanıcılı kurulumlar için önerilen moddur; çoğu MCP istemcisi tarafından kullanılır.

Örnek - SonarQube Cloud ile 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)

Şifrelenmemiş Streamable HTTP taşıması. Çok kullanıcılı dağıtımlar için bunun yerine HTTPS kullanın.

⚠️ Önerilmez: Yerel geliştirme için Stdio veya çok kullanıcılı üretim dağıtımları için HTTPS (Streamable HTTP) kullanın.

Not: Streamable HTTP modunda (HTTP veya HTTPS), sunucu durumsuzdur — her istemci isteği, kullanıcının kendi SonarQube tokenını taşıyan bir Authorization: Bearer <token> başlığı içermelidir. SonarQube Cloud için kuruluş şu şekilde çözümlenir:

• Sunucu başlangıcında SONARQUBE_ORG ayarlanmışsa, tüm istekler o kuruluşa yönlendirilir. İstemciler bir SONARQUBE_ORG başlığı göndermemelidir — gönderilirse hata oluşur.
• Sunucu başlangıcında SONARQUBE_ORG ayarlanmamışsa, her istemci her istekte bir SONARQUBE_ORG başlığı sağlamalıdır. İstemciler ayrıca SONARQUBE_TOOLSETS ve/veya SONARQUBE_READ_ONLY başlıklarını sağlayarak istek başına görünür araçları daraltabilir; bunlar sunucu düzeyindeki yapılandırmanın üzerine ek filtreleme uygular — kapsamı yalnızca azaltabilir, asla genişletemez. İstekler arasında oturum durumu korunmaz.

Kullanımdan kaldırıldı: SONARQUBE_TOKEN istek başlığı geriye dönük uyumluluk için hâlâ kabul edilir, ancak gelecekteki bir sürümde kaldırılacaktır. Authorization: Bearer <token> öğesine geçin.

3. HTTPS (TLS üzerinden Streamable HTTP) (Çok Kullanıcılı Üretim Dağıtımları için Önerilir)

TLS şifrelemesiyle güvenli Streamable HTTP taşıması. SSL sertifikaları gerektirir.

✅ Üretim için Önerilir: MCP sunucusunu Streamable HTTP üzerinden birden çok kullanıcı için dağıtırken HTTPS kullanın. Sunucu, güvenlik için varsayılan olarak 127.0.0.1 (localhost) adresine bağlanır.

SSL Sertifika Yapılandırması (İsteğe Bağlı):

Örnek - SonarQube Cloud ile Docker:

Not: Bir kapsayıcıda çalışırken, kapsayıcının tüm arabirimlerde dinlemesi ve çalışma zamanının bağlantı noktası eşlemesinin çalışması için SONARQUBE_HTTP_HOST=0.0.0.0 ayarlayın ve sunucuya bir kapsayıcı içinde olduğunu söylemek için SONARQUBE_MCP_IN_CONTAINER=true ayarlayın. Resmi Docker görüntüsü ikincisini otomatik ayarlar; diğer OCI çalışma zamanlarını (Podman, Kubernetes, Nomad, vb.) kullanırken kendiniz ayarlayın. Ana bilgisayar tarafındaki bağlantı noktası bayrağı, sunucuya kapsayıcı dışından kimlerin erişebileceğini kontrol eder. SONARQUBE_HTTP_HOST=0.0.0.0 yalnızca sunucunun kapsayıcı içinde nerede dinlediğini kontrol eder — tarayıcı CORS'u varsayılan olarak localhost kaynaklarına hâlâ izin verir.

Makinenizde yerel olarak çalışan bir sunucu için (yalnızca localhost'tan erişilebilir):

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

Ağdan erişilebilen bir sunucu için (uzak dağıtımlar):

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

İstemci Yapılandırması (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"
      }
    }
  }
}

İstemci Yapılandırması (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"
      }
    }
  }
}

Not: SONARQUBE_TOOLSETS ve SONARQUBE_READ_ONLY, bu belirli istek için sunucu düzeyindeki araç setini daraltan isteğe bağlı istek başına başlıklardır. Yalnızca kapsamı azaltabilirler — sunucunun başlatıldığı kapsamın ötesinde araç setlerini etkinleştiremez veya kısıtlamaları kaldıramazlar.

Not: Yerel geliştirme için bunun yerine Stdio taşımasını kullanın (varsayılan). HTTPS Streamable HTTP, uygun SSL sertifikalarıyla çok kullanıcılı üretim dağıtımları için tasarlanmıştır.

Hizmet Uç Noktaları

Streamable HTTP modunda (http veya https) çalışırken, sunucu /mcp adresindeki MCP uç noktasına ek olarak birkaç kimlik doğrulamasız hizmet uç noktası sunar. Bunlar hizmetten hizmete kullanım (izleme, orkestrasyon, istemci uyumluluk kontrolleri) için tasarlanmıştır ve bir Authorization başlığı gerektirmez.

Bu uç noktalar Stdio taşımasıyla çalışırken kullanılamaz.

Özel Sertifikalar

SonarQube Server'ınız kendi kendine imzalanmış bir sertifika veya özel bir Sertifika Yetkilisi'nden (CA) bir sertifika kullanıyorsa, kapsayıcıya otomatik olarak yüklenecek özel sertifikalar ekleyebilirsiniz.

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>"
    }
  }
}

Proxy

SonarQube MCP Sunucusu, standart Java proxy sistem özellikleri aracılığıyla HTTP ve SOCKS5 proxy'lerini destekler.

İstemci Sertifikası (Karşılıklı TLS)

SonQube Sunucunuz, TLS el sıkışması sırasında istemcilerin bir sertifika sunmasını gerektiriyorsa (karşılıklı TLS), kapsayıcıya bir PKCS12 anahtar deposu bağlayarak ve konumunu JAVA_OPTS aracılığıyla ileterek bunu sağlayabilirsiniz.

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>"
    }
  }
}

Araçlar

Analiz

• analyze_code_snippet - Kod kalitesi ve güvenlik sorunlarını belirlemek için SonarQube çözümleyicileriyle dosya içeriğini analiz edin. Doğruluk için her zaman dosya içeriğinin tamamını analiz eder. İsteğe bağlı olarak sonuçları belirli bir kod parçacığına göre filtreleyin.

  Kullanımdan kaldırıldı: analyze_code_snippet gelecekteki bir sürümde kaldırılacaktır. analyze_file_list kullanmak için SonarQube for IDE'yi bağlayın veya run_advanced_code_analysis kullanmak için kuruluşunuz için Vortex analizini etkinleştirin (aşağıya bakın).

  Kullanım:

  • Çalışma alanı bağlıyken (önerilir): filePath (projeye göreli) iletin — sunucu dosyayı doğrudan okur ve dosya içeriğini aracı bağlam penceresinin dışında tutar
  • Çalışma alanı bağlantısı olmadan: tam dosya analizi için eksiksiz fileContent iletin (tüm sorunları bildirir)
  • Sonuçları filtrelemek için isteğe bağlı codeSnippet ekleyin - yalnızca parçacık içindeki sorunlar bildirilir (parçacık konumu otomatik algılanır)

  Parametreler:

  • projectKey - SonarQube proje anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • filePath - Analiz edilecek dosyanın projeye göreli yolu (ör. src/main/java/MyClass.java). Çalışma alanı /app/mcp-workspace konumuna bağlandığında kullanılır - Dize
  • fileContent - Dize olarak eksiksiz dosya içeriği. Çalışma alanı bağlı olmadığında gereklidir - Dize
  • codeSnippet - Sorunları filtrelemek için kod parçacığı (fileContent içindeki içerikle eşleşmelidir) - Dize
  • language - Kodun dili (ör. 'java', 'python', 'js', 'ts', 'tsx', 'jsx') - Dize
  • scope - Dosyanın kapsamı: MAIN veya TEST (varsayılan: MAIN) - Dize

  Desteklenen Diller: 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 algılama

SonarQube for IDE ile entegrasyon etkinleştirildiğinde: (bu iki araç hem analysis hem de ide araç setlerinde etiketlenir)

• analyze_file_list - SonarQube for IDE kullanarak geçerli çalışma dizinindeki dosyaları analiz edin. Bu araç, bir dosya listesinde kod kalitesi analizi gerçekleştirmek için çalışan bir SonarQube for IDE örneğine bağlanır.

  • file_absolute_paths - Analiz edilecek mutlak dosya yollarının listesi - Zorunlu Dize[]

• toggle_automatic_analysis - SonarQube for IDE otomatik analizini etkinleştirin veya devre dışı bırakın. Etkinleştirildiğinde, SonarQube for IDE çalışma dizininde değiştirildikçe dosyaları otomatik olarak analiz eder. Devre dışı bırakıldığında otomatik analiz kapatılır.

  • enabled - Otomatik analizi etkinleştirin veya devre dışı bırakın - Zorunlu Boole

SonarQube Server'da, hem CAG hem de A3S hub'ları yetkilendirildiğinde stdio, Vortex bağlam araçlarını ve run_advanced_code_analysis öğesini listeler.

Vortex analizi etkinleştirildiğinde:

Çalışma alanının /app/mcp-workspace konumuna bağlanmasını gerektirir

• run_advanced_code_analysis - Tek bir dosyada Vortex analizi çalıştırın. Kuruluş, MCP yapılandırmasından çıkarılır (SonarQube Server nil UUID yer tutucusunu kullanır).
  • projectKey - Projenin anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - En son analiz bağlamını almak için kullanılan dal adı - Zorunlu Dize
  • filePath - Analiz edilecek dosyanın projeye göreli yolu (ör. src/main/java/MyClass.java). - Zorunlu Dize
  • fileScope - Dosyanın hangi kapsamdan geldiğini tanımlar: 'MAIN' veya 'TEST' (varsayılan: MAIN) - Dize

Kapsam

• search_files_by_coverage - Kapsama göre sıralanmış bir projedeki dosyaları arayın (artan - en kötü kapsam ilk). Bu araç, test kapsamı iyileştirmeleri gerektiren dosyaları belirlemeye yardımcı olur.

  • projectKey - Aranacak proje anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - Dize
  • pullRequest - İsteğe bağlı çekme isteği anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - Dize
  • maxCoverage - Maksimum kapsam eşiği (0-100). Yalnızca kapsamı bu değere eşit veya daha düşük olan dosyaları döndürün - Sayı
  • pageIndex - Sayfa dizini (1 tabanlı, varsayılan: 1) - Sayı
  • pageSize - Sayfa boyutu (varsayılan: 100, maks: 500) - Sayı

• get_file_coverage_details - Belirli bir dosya için satır satır kapsam bilgisi alın; hangi satırların kapsanmadığını ve hangilerinin kısmen kapsanan dallara sahip olduğunu içerir. Bu araç, test kapsamının tam olarak nereye ekleneceğini belirlemeye yardımcı olur. search_files_by_coverage ile düşük kapsamlı dosyaları belirledikten sonra kullanın.

  • key - Dosya anahtarı (ör. my_project:src/foo/Bar.java) - Zorunlu Dize
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - Dize
  • pullRequest - İsteğe bağlı çekme isteği anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - Dize
  • from - Analiz edilecek ilk satır (1 tabanlı, varsayılan: 1) - Sayı
  • to - Analiz edilecek son satır (dahil). Belirtilmezse tüm satırlar döndürülür - Sayı

Bağımlılık Riskleri

Not: Bağımlılık riskleri yalnızca SonarQube Advanced Security etkinleştirilmiş SonarQube Server 2025.4 Enterprise veya üstüne bağlanırken kullanılabilir.

• search_dependency_risks - Analiz edilen projede, uygulamada veya portföyde görünen sürümlerle eşleştirilmiş bir SonarQube projesinin yazılım kompozisyonu analizi sorunlarını (bağımlılık riskleri) arayın.
  • projectKey - Proje anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - Dize
  • pullRequest - İsteğe bağlı çekme isteği anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - Dize
  • pageIndex - İsteğe bağlı sayfa dizini (1 tabanlı, varsayılan: 1) - Tamsayı
  • pageSize - İsteğe bağlı sayfa boyutu. 0'dan büyük ve 500'e eşit veya daha küçük olmalıdır (varsayılan: 100) - Tamsayı

Kuruluşlar

Not: Kuruluşlar yalnızca SonarQube Cloud'a bağlanırken kullanılabilir.

• list_enterprises - Erişiminiz olan SonarQube Cloud'da bulunan kuruluşları listeleyin. Diğer araçlarla kullanılabilecek kuruluş kimliklerini keşfetmek için bu aracı kullanın.
  • enterpriseKey - Sonuçları filtrelemek için isteğe bağlı kuruluş anahtarı - Dize

Sorunlar

• change_sonar_issue_status - Bir SonarQube sorununun durumunu "accept", "falsepositive" olarak değiştirin veya bir sorunu "reopen" edin.

  • key - Sorun anahtarı - Zorunlu Dize
  • status - Yeni sorunun durumu - Zorunlu Enum {"accept", "falsepositive", "reopen"}
  • comment - Durum değişikliğini açıklayan isteğe bağlı yorum - Dize

• search_sonar_issues_in_projects - Kuruluşumun projelerindeki SonarQube sorunlarını arayın.

  • projectKeys - İsteğe bağlı SonarQube proje anahtarları listesi - Dize[]
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - Dize
  • pullRequest - İsteğe bağlı çekme isteği anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - Dize
  • severities - Filtrelemek için isteğe bağlı önem düzeyleri listesi. Olası değerler: INFO, LOW, MEDIUM, HIGH, BLOCKER - Dize[]
  • impactSoftwareQualities - Filtrelemek için isteğe bağlı yazılım kaliteleri listesi. Olası değerler: MAINTAINABILITY, RELIABILITY, SECURITY - Dize[]
  • issueStatuses - Filtrelemek için isteğe bağlı sorun durumları listesi. Olası değerler: OPEN, CONFIRMED, FALSE_POSITIVE, ACCEPTED, FIXED, IN_SANDBOX - Dize[]
  • tags - Filtrelemek için isteğe bağlı sorun etiketleri listesi. Etiketler küçük harflidir - Dize[]
  • inNewCodePeriod - Yalnızca yeni kod dönemindeki sorunları döndürün. projectKeys ve files genelinde tam olarak bir giriş gerektirir - Boole
  • issueKey - Belirli bir sorunu getirmek için isteğe bağlı sorun anahtarı - Dize
  • pageIndex - İsteğe bağlı 1 tabanlı sayfa dizini (varsayılan: 1) - Tamsayı
  • pageSize - İsteğe bağlı sayfa boyutu. 0'dan büyük ve 500'e eşit veya daha küçük olmalıdır (varsayılan: 100) - Tamsayı

Güvenlik Noktaları

• search_security_hotspots - Bir SonarQube projesinde Güvenlik Noktalarını arayın.

  • projectKey - Proje veya uygulama anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • hotspotKeys - Alınacak belirli Güvenlik Noktası anahtarlarının virgülle ayrılmış listesi - Dize[]
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - Dize
  • pullRequest - İsteğe bağlı çekme isteği anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - Dize
  • files - Filtrelemek için isteğe bağlı dosya yolları listesi - Dize[]
  • status - İsteğe bağlı durum filtresi: TO_REVIEW, REVIEWED - Dize
  • resolution - İsteğe bağlı çözüm filtresi: FIXED, SAFE, ACKNOWLEDGED - Dize
  • sinceLeakPeriod - Sızıntı döneminden (yeni kod) bu yana oluşturulan noktaları filtreleyin - Boole
  • onlyMine - Yalnızca bana atanan noktaları göster - Boole
  • pageIndex - İsteğe bağlı 1 tabanlı sayfa dizini (varsayılan: 1) - Tamsayı
  • pageSize - İsteğe bağlı sayfa boyutu. 0'dan büyük ve 500'e eşit veya daha küçük olmalıdır (varsayılan: 100) - Tamsayı

• show_security_hotspot - Kural ayrıntıları, kod bağlamı, akışlar ve yorumlar dahil olmak üzere belirli bir Güvenlik Noktası hakkında ayrıntılı bilgi alın.

  • hotspotKey - Güvenlik Noktası anahtarı - Zorunlu Dize

- change_security_hotspot_status - Bir Security Hotspot'u durumunu değiştirerek inceleyin. REVIEWED olarak işaretlerken bir çözüm belirtmelisiniz (FIXED, SAFE veya ACKNOWLEDGED).

• hotspotKey - Security Hotspot anahtarı - Zorunlu String
• status - Yeni durum - Zorunlu Enum {"TO_REVIEW", "REVIEWED"}
• resolution - Durum REVIEWED olduğunda çözüm - Enum {"FIXED", "SAFE", "ACKNOWLEDGED"}
• comment - İsteğe bağlı inceleme yorumu - String

Diller

• list_languages - Bu SonarQube örneğinde desteklenen tüm programlama dillerini listeler.
  • q - Dil anahtarlarını/adlarını eşleştirmek için isteğe bağlı desen - String

Ölçümler

• get_component_measures - Bir bileşen (proje, dizin, dosya) için SonarQube ölçümlerini alır.
  • projectKey - Proje anahtarı - SONARQUBE_PROJECT_KEY yapılandırılmadığında Zorunlu String
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - String
  • metricKeys - Alınacak isteğe bağlı metrik anahtarları (örn. ncloc, complexity, violations, coverage) - String[]
  • pullRequest - İsteğe bağlı pull request anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - String

Metrikler

• search_metrics - SonarQube metriklerini arar.
  • pageIndex - İsteğe bağlı 1 tabanlı sayfa dizini (varsayılan: 1) - Integer
  • pageSize - İsteğe bağlı sayfa boyutu. 0'dan büyük ve 500'e eşit veya küçük olmalıdır (varsayılan: 100) - Integer

Portföyler

• list_portfolios - SonarQube'de bulunan kurumsal portföyleri filtreleme ve sayfalama seçenekleriyle listeler.

  SonarQube Server için:

  • q - Portföyleri ada veya anahtara göre filtrelemek için isteğe bağlı arama sorgusu - String
  • favorite - true ise yalnızca favori portföyleri döndürür - Boolean
  • pageIndex - İsteğe bağlı 1 tabanlı sayfa numarası (varsayılan: 1) - Integer
  • pageSize - İsteğe bağlı sayfa boyutu, maksimum 500 (varsayılan: 100) - Integer

  SonarQube Cloud için:

  • enterpriseId - Kurumsal uuid. Yalnızca 'favorite' parametresi true değeriyle sağlanmışsa atlanabilir - String
  • q - Portföyleri ada göre filtrelemek için isteğe bağlı arama sorgusu - String
  • favorite - 'enterpriseId' parametresi atlanmışsa true olması zorunludur. true ise yalnızca oturum açmış kullanıcının favorilediği portföyleri döndürür. 'draft' true olduğunda true olamaz - Boolean
  • draft - true ise yalnızca oturum açmış kullanıcının oluşturduğu taslakları döndürür. 'favorite' true olduğunda true olamaz - Boolean
  • pageIndex - Getirilecek sayfanın isteğe bağlı dizini (varsayılan: 1) - Integer
  • pageSize - Getirilecek sayfanın isteğe bağlı boyutu (varsayılan: 50) - Integer

Projeler

• search_my_sonarqube_projects - SonarQube projelerini bulur. Yanıt sayfalanmıştır.

  • pageIndex - İsteğe bağlı 1 tabanlı sayfa dizini (varsayılan: 1) - Integer
  • pageSize - İsteğe bağlı sayfa boyutu. 0'dan büyük ve 500'e eşit veya küçük olmalıdır (varsayılan: 500) - Integer
  • q - Projeleri ada (kısmi eşleşme) veya anahtara (tam eşleşme) göre filtrelemek için isteğe bağlı arama sorgusu - String

• list_branches - Bir proje için analiz edilen dalları listeler.

  • SonarQube Cloud: type ve mergeBranch alanlarıyla uzun ömürlü (LONG) ve kısa ömürlü (SHORT) dalları döndürür. İsteğe bağlı branchTypes filtresi: ALL (varsayılan), LONG veya SHORT.
  • SonarQube Server: analiz edilen tüm dalları (ad, kalite kapısı, analiz tarihi) döndürür. type, mergeBranch veya branchTypes filtresi yoktur.
  • Döndürülen dal adlarını diğer araçlarda branch parametresi olarak kullanın. Pull request analizi için bunun yerine list_pull_requests kullanın.
  • projectKey - Proje anahtarı (örn. my_project) - Zorunlu String (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branchTypes - (Yalnızca SonarQube Cloud) İsteğe bağlı filtre: ALL (varsayılan), LONG veya SHORT - Enum {"ALL", "LONG", "SHORT"}

• list_pull_requests - Bir proje için tüm pull request'leri listeler. PR ile dekore edilmiş analiz (kapsam, sorunlar, kalite kapısı) için pull request'leri keşfetmek amacıyla bu aracı kullanın. Diğer araçlarla kullanılabilen pull request anahtarını/ID'sini döndürür. Pull request'siz dal tabanlı analiz için bunun yerine list_branches kullanın.

  • projectKey - Proje anahtarı (örn. my_project) - Zorunlu String (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)

Kalite Kapıları

• get_project_quality_gate_status - SonarQube projesi için Kalite Kapısı Durumunu alır.

  • analysisId - İsteğe bağlı analiz ID'si - String
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - String
  • projectId - İsteğe bağlı proje ID'si - String
  • projectKey - İsteğe bağlı proje anahtarı - String
  • pullRequest - İsteğe bağlı pull request anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - String

• list_quality_gates - SonarQube'deki tüm kalite kapılarını listeler.

Kurallar

• show_rule - Bir SonarQube kuralı hakkında ayrıntılı bilgi gösterir.
  • key - Kural anahtarı - Zorunlu String

Kopyalar

• search_duplicated_files - Bir SonarQube projesinde kod kopyası olan dosyaları arar. Varsayılan olarak, tüm sayfalardaki kopyalanmış dosyaları otomatik olarak getirir (maksimum 10.000 dosya). Yalnızca kopya içeren dosyaları döndürür.

  • projectKey - Proje anahtarı - Zorunlu String (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - String
  • pullRequest - İsteğe bağlı pull request anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - String
  • pageSize - Manuel sayfalama için sayfa başına isteğe bağlı sonuç sayısı (maks: 500). Belirtilmezse, tüm kopyalanmış dosyaları otomatik getirir - Integer
  • pageIndex - Manuel sayfalama için isteğe bağlı sayfa numarası (1'den başlar). Belirtilmezse, tüm kopyalanmış dosyaları otomatik getirir - Integer

• get_duplications - Bir dosya için kopyaları alır. Dosyanın projesinde Browse izni gerektirir.

  • key - Dosya anahtarı - Zorunlu String
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - String
  • pullRequest - İsteğe bağlı pull request anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - String

Kaynaklar

• get_raw_source - SonarQube'den kaynak kodunu ham metin olarak alır. Dosyada 'Kaynak Kodunu Gör' izni gerektirir.

  • key - Dosya anahtarı - Zorunlu String
  • branch - Dal tabanlı analiz için isteğe bağlı dal adı. Geçerli adları keşfetmek için list_branches kullanın - String
  • pullRequest - İsteğe bağlı pull request anahtarı/ID'si. Geçerli anahtarları keşfetmek için list_pull_requests kullanın - String

• get_scm_info - SonarQube kaynak dosyalarının SCM bilgilerini alır. Dosyanın projesinde Kaynak Kodunu Gör izni gerektirir.

  • key - Dosya anahtarı - Zorunlu String
  • commits_by_line - Değer false ise satırları SCM commit'ine göre grupla, aksi halde her satır için commit'leri göster - String
  • from - Döndürülecek ilk satır. 1'den başlar - Number
  • to - Döndürülecek son satır (dahil) - Number

Sistem

Not: Sistem araçları yalnızca SonarQube Server'a bağlanırken kullanılabilir.

• get_system_health - SonarQube Server örneğinin sağlık durumunu alır. GREEN (tamamen çalışır), YELLOW (kullanılabilir ancak dikkat gerektirir) veya RED (çalışmıyor) döndürür.

• get_system_info - JVM durumu, veritabanı, arama dizinleri ve ayarlar dahil SonarQube Server sistem yapılandırması hakkında ayrıntılı bilgi alır. 'Yönet' izinleri gerektirir.

• get_system_logs - SonarQube Server sistem günlüklerini düz metin biçiminde alır. Sistem yönetim izni gerektirir.

  • name - Alınacak günlüklerin isteğe bağlı adı. Olası değerler: access, app, ce, deprecation, es, web. Varsayılan: app - String

• ping_system - SonarQube Server sisteminin canlı olup olmadığını kontrol etmek için ping atar. Düz metin olarak 'pong' döndürür.

• get_system_status - SonarQube Server hakkında durum bilgisi alır. Durum (STARTING, UP, DOWN, RESTARTING, DB_MIGRATION_NEEDED, DB_MIGRATION_RUNNING), sürüm ve kimlik döndürür.

Webhook'lar

• create_webhook - SonarQube organizasyonu veya projesi için yeni bir webhook oluşturur. Belirtilen projede 'Yönet' izni veya genel 'Yönet' izni gerektirir.

  • name - Webhook adı - Zorunlu String
  • url - Webhook URL'si - Zorunlu String
  • projectKey - Projeye özel webhook için isteğe bağlı proje anahtarı - String
  • secret - Webhook yükünü güvence altına almak için isteğe bağlı webhook sırrı - String

• list_webhooks - SonarQube organizasyonu veya projesi için tüm webhook'ları listeler. Belirtilen projede 'Yönet' izni veya genel 'Yönet' izni gerektirir.

  • projectKey - Projeye özel webhook'ları listelemek için isteğe bağlı proje anahtarı - String

Bağlam Genişletme

# 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"
      }
    }
  }
}

Aracısal Hazırlık

Not: Aracısal Hazırlık araçları yalnızca SonarQube Cloud'da kullanılabilir ve özelliğin kuruluşunuz için etkinleştirilmesini gerektirir.

• start_agentic_readiness_assessment - Bir proje için aracısal hazırlık değerlendirmesi başlatın. PENDING durumu ve bir assessmentId ile hemen döner. Sonuçları yoklamak için get_agentic_readiness_assessment kullanın.

  • projectKey - Proje anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - Değerlendirilecek dal. Projenin varsayılan dalını kullanmak için atlayın - Dize

• get_agentic_readiness_assessment - Bir değerlendirmenin sonucunu alın. Durum COMPLETED, FAILED veya INTERRUPTED olana kadar aynı assessmentId ile yeniden çağırın. Tamamlandığında, genel düzeyi ve önerilen eylemler ve kanıtlarla birlikte sütun bazında bir dökümü döndürür.

  • assessmentId - start_agentic_readiness_assessment tarafından döndürülen değerlendirme kimliği - Zorunlu Dize

• list_agentic_readiness_assessments - Bir proje için tüm değerlendirmeleri en yeniden en eskiye doğru listeleyin. Tam sütun düzeyinde sonuçlar için get_agentic_readiness_assessment kullanın.

  • projectKey - Değerlendirmelerin listeleneceği proje anahtarı - Zorunlu Dize (SONARQUBE_PROJECT_KEY tanımlandığında yok sayılır)
  • branch - Değerlendirmeleri dal adına göre filtreleyin. Tüm dallar için değerlendirmeleri listelemek üzere atlayın - Dize
  • pageIndex - 1 tabanlı sayfa dizini (varsayılan: 1) - Sayı
  • pageSize - Sayfa başına öğe sayısı, maksimum 100 (varsayılan: 50) - Sayı

Örnek Komutlar

SonarQube MCP Sunucusunu kurduktan sonra, yaygın gerçek dünya senaryoları için bazı örnek komutlar:

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?

Derleme

sonarsource/sonarqube-mcp kapsayıcı görüntüsünü tercih edin.

Sunucuyu Docker olmadan bağımsız bir JAR olarak çalıştırmak için, SonarSource ikili dosyalar deposundan önceden derlenmiş bir sürüm indirin. Yayınlanan her sürüm orada sonarqube-mcp-server-<version>.jar olarak yayınlanır (örneğin, 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

Sorun Giderme

Uygulama günlükleri varsayılan olarak STORAGE_PATH/logs/mcp.log dosyasına yazılır. Dosya günlüğünü tamamen devre dışı bırakmak için SONARQUBE_LOG_TO_FILE_DISABLED=true ayarlayın.

Yaygın Sorunlar

"SonarQube sunucu sürümü desteklenmiyor"

MCP sunucusu, başlangıç sırasında bağlı SonarQube Server sürümünü kontrol eder. Örnek 2025.1 (SQS) veya 25.1 (SQCB) sürümünden eskiyse, başlangıç şu hatayla başarısız olur:

SonarQube server version is not supported, minimal version is SQS 2025.1 or SQCB 25.1

Çözüm: SonarQube Server'ı desteklenen bir sürüme yükseltin. Bu kontrol yalnızca SonarQube Server'a bağlanırken geçerlidir (SONARQUBE_URL olmadan SONARQUBE_ORG), SonarQube Cloud için geçerli değildir.

"Özellik çalışmıyor" veya "Eksik araçlar/işlevsellik"

Güncel olmayan bir Docker görüntüsü çalıştırıyor olabilirsiniz. Docker görüntüleri yerel olarak önbelleğe alır, bu nedenle güncellemeleri otomatik olarak almazsınız.

Çözüm: En son sürüme güncelleyin:

docker pull sonarsource/sonarqube-mcp

En son görüntüyü çektikten sonra, güncellenmiş sürümü kullanmak için MCP istemcinizi yeniden başlatın.

İsteğe bağlı olarak, her zaman en son sürümü kontrol etmek ve çekmek için docker run komutunuza --pull=always bayrağını ekleyin:

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

"Belirli bir sürüme sabitlemek istiyorum"

sonarsource/sonarqube-mcp adresindeki mevcut etiketlere göz atın ve istediğiniz sürüme başvurun:

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 istemci yapılandırmanızda, sonarsource/sonarqube-mcp yerine sonarsource/sonarqube-mcp:<version> kullanın ve Docker'ın görüntüyü sessizce yükseltmemesi için --pull=always öğesini kaldırın.

Veri ve telemetri

Bu sunucu anonim kullanım verileri toplar ve ürünü iyileştirmeye yardımcı olmak için SonarSource'a gönderir. Kaynak kodu veya IP adresi toplanmaz ve SonarSource verileri başka kimseyle paylaşmaz. Telemetri toplama, aşağıdaki sistem özelliği veya ortam değişkeniyle devre dışı bırakılabilir: TELEMETRY_DISABLED=true. Toplanan verilerin bir örneğini görmek için buraya tıklayın.

Lisans

Telif Hakkı 2025 SonarSource.

SONAR Kaynak Kullanılabilir Lisansı v1.0 altında lisanslanmıştır. SonarQube MCP Sunucusunu bu belgelere uygun olarak kullanmak Rekabetçi Olmayan Bir Amaçtır ve bu nedenle SSAL kapsamında izin verilir.

SonarQube'u MCP aracılığıyla kullanımınız, SonarQube Cloud Hizmet Şartları veya SonarQube Server Şartlar ve Koşulları tarafından yönetilir; Sonuç Verilerinin yalnızca dahili yazılım geliştirme amaçlarınız için kullanımı dahildir.