Collegare SonarQube MCP a Gemini CLI

💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → SonarQube, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

SonarQube + Gemini

Permetti alla tua AI di leggere SonarQube: progetti, stato del quality gate, misure come la coverage e il loro storico, issue aperte per severità e qualità del software, analisi e branch. SonarQube Server o SonarQube Cloud, sola lettura, con un token utente.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

SONARQUBE_URL, SONARQUBE_TOKEN

Passaggio 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti servono un SonarQube Server (va bene anche la Community Build gratuita) o un account SonarQube Cloud con almeno un progetto analizzato, e un token utente.

1. Imposta SONARQUBE_URL, senza /api e senza slash finale: https://sonarcloud.io per SonarQube Cloud nella regione UE, https://sonarqube.us per SonarQube Cloud nella regione US, oppure l'indirizzo del tuo SonarQube Server così come lo apri nel browser, incluso l'eventuale context path (ad esempio https://sonar.example.com oppure https://example.com/sonarqube).
2. Crea un token utente e incollalo in SONARQUBE_TOKEN, senza la parola Bearer. Su Server: avatar → My Account → Security, poi genera un token di tipo User. Su Cloud: avatar → My Account → Access tokens → Personal Tokens, poi genera un token. I token di analisi di progetto e globali servono per eseguire le scansioni e non funzionano con la Web API.
3. Su SonarQube Cloud, imposta SONARQUBE_ORGANIZATION con la chiave della tua organizzazione, mostrata nell'URL sonarcloud.io/organizations/<key>. Cloud ne ha bisogno per elencare i progetti e cercare le issue. Su Server, lascialo vuoto.
4. Installa il connettore ed esegui sonarqube_list_projects: elenca i progetti che il token può consultare, con le chiavi di progetto richieste dagli altri strumenti.

Cosa legge: se un progetto ha superato il quality gate (OK o ERROR, con ogni condizione non soddisfatta), le misure attuali come coverage, duplicated_lines_density, ncloc e i conteggi di issue software_quality_*, come queste misure sono cambiate da un'analisi all'altra, le issue filtrate per qualità del software (SECURITY, RELIABILITY, MAINTAINABILITY), severità e stato, le analisi del progetto con i relativi eventi e i suoi branch con ultima analisi e stato del gate. Tutti i 7 strumenti sono in sola lettura e il token decide quali progetti vede l'AI.

Progetti e branch: gli strumenti accettano la chiave del progetto (ad esempio payments-api, oppure my-org_payments-api su Cloud), non il nome visualizzato. Senza branch o pullRequest leggono il branch principale. La Community Build analizza solo il branch principale.

Rete privata: con AnythingMCP self-hosted, un SonarQube Server su un host interno o con IP privato richiede che quell'host sia incluso in SSRF_ALLOWED_HOSTS, altrimenti la protezione in uscita rifiuta la chiamata. AnythingMCP Cloud può raggiungere solo SonarQube Cloud o un SonarQube Server raggiungibile da internet pubblico.

Limiti: gli strumenti di elenco restituiscono fino a 500 elementi per pagina (1.000 per sonarqube_get_measures_history). La ricerca delle issue restituisce al massimo 10.000 risultati in totale, quindi restringi i filtri invece di scorrere ulteriormente le pagine. SonarQube Cloud risponde 429 quando un token invia troppe richieste: attendi qualche minuto e riprova. SonarQube Server non ha limiti di frequenza per impostazione predefinita.

Errori comuni: 401 significa che il token è errato, scaduto o revocato, oppure che è un token di analisi invece di un token utente. 403 significa che l'utente del token non ha il permesso Browse sul progetto. 404 significa che la chiave del progetto, il branch o la pull request non esistono, oppure che SONARQUBE_URL è errato. 400 indica il parametro mancante o non valido, ad esempio un'organizzazione mancante su Cloud.

Il connettore non modifica nulla in SonarQube (nessuna transizione, assegnazione o commento sulle issue, nessuna modifica a quality gate, quality profile, progetti o token), e non copre security hotspot, portfolio e applicazioni, Web API v2, endpoint di amministrazione e di sistema, né i filtri delle issue solo sul nuovo codice.

Passaggio 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Passaggio 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SonarQube.

Strumenti disponibili

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT