> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-mcp-server/setup/prerequisites.md).

# Prerequisites

Prerequisites for setting up the SonarQube MCP Server.

To set up the SonarQube MCP Server, you'll need the following:

* A supported MCP client. A list of tested clients is in the [Quickstart guides](/sonarqube-mcp-server/setup/quickstart-guides.md) section.
* One of the following:
  * A SonarQube Cloud organization. Both the EU and US region organizations are supported.
  * SonarQube Server 2025.1 or newer.
    * SonarQube Server 2026.1 or newer is recommended for optimal performance.
  * SonarQube Community Build 25.1 or newer.
* The latest release of the SonarQube MCP Server receives support. Each release is compatible with SonarQube Cloud and with the SonarQube Server versions that receive patches under the [Release cycle model](/sonarqube-server/server-update-and-maintenance/update/release-cycle-model.md#sonarqube-server-patch-policy) at the time of that release: the latest SonarQube Server version and each LTA (Long-Term Active) version. Staying on the latest release keeps the SonarQube MCP Server compatible.
* For self-hosted deployment: a container management tool to run the container image (for example, Docker), or JDK 21+ to run the standalone JAR.

When you connect to SonarQube Server or SonarQube Community Build, the server checks the instance version at startup and stops if it's older than SonarQube Server 2025.1 or SonarQube Community Build 25.1. SonarQube Server 9.x and 10.x, and SonarQube Community Build 24.x, are not supported. This check does not apply to SonarQube Cloud. If startup fails, see [Troubleshooting](/sonarqube-mcp-server/resources/troubleshooting.md).

## Next steps

Review [Environment considerations](/sonarqube-mcp-server/setup/environment-considerations.md) and follow the [Quickstart guides](/sonarqube-mcp-server/setup/quickstart-guides.md). To quickly generate a working configuration for your IDE or CLI, use the official [SonarQube MCP Server configuration generator](https://mcp.sonarqube.com/config-generator.html).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sonarsource.com/sonarqube-mcp-server/setup/prerequisites.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.