SonarQube mcp server with TLS error

Environment

  • SonarQube Server or Cloud? Server
  • Deployment type (STDIO/HTTP, Docker/JAR): STDIO Docker
  • Client / AI tool using MCP (if applicable): Claude Code

Description

The SonarQube server is hosted within the company network. When I try to start the MCP server, I encounter a TLS-related error.

I’m not sure which certificate is required and which certificate store it should be installed in (linux or java). Any guidance or instructions on how to resolve this would be greatly appreciated.

Thank you!

2026-04-28 11:17:06 Exception in thread "main" java.util.concurrent.CompletionException: javax.net.ssl.SSLHandshakeException: TLS handshake failed
2026-04-28 11:17:06     at java.base/java.util.concurrent.CompletableFuture.reportJoin(Unknown Source)
2026-04-28 11:17:06     at java.base/java.util.concurrent.CompletableFuture.join(Unknown Source)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.serverapi.ServerApiHelper.rawGet(ServerApiHelper.java:85)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.serverapi.ServerApiHelper.get(ServerApiHelper.java:58)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.serverapi.features.FeaturesApi.listFeatures(FeaturesApi.java:36)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.SonarQubeMcpServer.loadBackendIndependentTools(SonarQubeMcpServer.java:386)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.SonarQubeMcpServer.initializeBasicServicesAndTools(SonarQubeMcpServer.java:239)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.SonarQubeMcpServer.(SonarQubeMcpServer.java:180)
2026-04-28 11:17:06     at org.sonarsource.sonarqube.mcp.SonarQubeMcpServer.main(SonarQubeMcpServer.java:151)
2026-04-28 11:17:06 Caused by: javax.net.ssl.SSLHandshakeException: TLS handshake failed"

Hi,

It looks like you’ll want to set some envvars for this.

There’s also guidance on custom certs.

 
HTH,
Ann