SonarQube to narzędzie do automatycznej analizy jakości kodu. Nasz serwer działa pod adresem https://sonar.suncode.local i ocenia nowy kod projektu PlusWorkflow według bramki jakości, czyli zestawu progów, które muszą spełnić zmiany. Ta strona opisuje, jak podłączyć Sonara do asystenta AI, żeby sprawdzał zmieniony kod naszymi regułami przed oddaniem pracy.

Konfiguracja serwera MCP dla asystenta omp

MCP (Model Context Protocol) to protokół, przez który asystent korzysta z zewnętrznych narzędzi. Serwer MCP SonarQube udostępnia asystentowi narzędzia do analizy kodu, przeglądania zgłoszeń i stanu bramki jakości na naszym serwerze. Działa w kontenerze Dockera, który omp uruchamia automatycznie przy starcie sesji.

Wymagania

• Docker zainstalowany i dostępny dla Twojego użytkownika bez sudo (polecenie docker run hello-world działa).
• Konto na serwerze sonar.suncode.local z dostępem do projektu PlusWorkflow.
• Certyfikat naszego lokalnego urzędu certyfikacji (Caddy) w pliku /usr/local/share/ca-certificates/caddy-local-root-2023.crt. Jeśli przeglądarka otwiera Sonara bez ostrzeżenia o certyfikacie, plik zwykle już jest na miejscu.

Krok 1. Wygeneruj token

W Sonarze otwórz My Account → Security, wpisz nazwę tokena (np. omp-mcp), wybierz typ User Token i kliknij Generate. Skopiuj token — Sonar pokazuje go tylko raz.

Krok 2. Dodaj serwer do konfiguracji omp

Otwórz plik ~/.omp/agent/mcp.json. Jeśli plik nie istnieje, utwórz go z poniższą zawartością. Jeśli istnieje, dopisz sam wpis "sonarqube" do istniejącej sekcji "mcpServers". W miejsce TWOJ_TOKEN wstaw token z kroku 1.

{
  "mcpServers": {
    "sonarqube": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init", "--pull=always",
        "-e", "SONARQUBE_TOKEN",
        "-e", "SONARQUBE_URL",
        "--add-host", "sonar.suncode.local:192.168.1.99",
        "-v", "/usr/local/share/ca-certificates/caddy-local-root-2023.crt:/usr/local/share/ca-certificates/caddy-local-root-2023.crt:ro",
        "mcp/sonarqube"
      ],
      "env": {
        "SONARQUBE_TOKEN": "TWOJ_TOKEN",
        "SONARQUBE_URL": "https://sonar.suncode.local"
      }
    }
  }
}

Co oznaczają mniej oczywiste elementy:

• --add-host sonar.suncode.local:192.168.1.99 — kontener Dockera używa publicznych serwerów DNS i nie zna nazwy sonar.suncode.local. Ten wpis podaje mu adres serwera wprost.
• -v …caddy-local-root-2023.crt… — udostępnia kontenerowi certyfikat naszego urzędu certyfikacji. Bez niego kontener odrzuca połączenie z błędem certificate verify failed. Obraz mcp/sonarqube przy starcie instaluje certyfikaty z tego katalogu.
• --pull=always — przy każdym starcie pobiera najnowszą wersję obrazu serwera MCP.

Krok 3. Sprawdź połączenie

1. Uruchom nową sesję omp albo w trwającej sesji wpisz /mcp reload.
2. Poproś asystenta: „Sprawdź stan bramki jakości projektu PlusWorkflow w Sonarze”.
3. Asystent powinien zwrócić listę warunków bramki jakości z wartościami. Jeśli zamiast tego napisze, że nie ma narzędzi SonarQube, przejdź do sekcji „Rozwiązywanie problemów”.

Rozwiązywanie problemów