# Cursor [Cursor](https://cursor.com/) is an AI-powered code editor built on VS Code. Use this MCP server setup when you want Sonar tools available inside the Cursor chat while you code. If you prefer using the [SonarQube Cloud-hosted MCP server](#sonarqube-cloud-hosted-mcp-server) instead, see below. ## Use the configuration generator Use the official [SonarQube MCP Server configuration generator](https://mcp.sonarqube.com/config-generator.html) to get a configuration code snippet for your setup: 1. Identify the target MCP Client. 2. Find your [#common-variables](/sonarqube-developer-tools/sonarqube-mcp-server/reference/environment-variables.md#common-variables). 3. Choose a [hosting method](/sonarqube-developer-tools/sonarqube-mcp-server/setup/environment-considerations.md#hosting-method). 4. Enter the information into the configuration generator. 5. Paste the generated configuration into your configuration file. ## Manual setup ### Environment variables The following [common variables](/sonarqube-developer-tools/sonarqube-mcp-server/reference/environment-variables.md#common-variables) are required. `SONARQUBE_TOKEN` applies to stdio transport only. For HTTP, HTTPS, or the embedded SonarQube Cloud MCP server, use the `Authorization: Bearer ` header instead. * `SONARQUBE_TOKEN`: Your SonarQube user token (stdio transport). * `SONARQUBE_ORG`: Your SonarQube Cloud organization key. Required for SonarQube Cloud only. * `SONARQUBE_URL`: Your SonarQube Server or Community Build URL. Also required for SonarQube Cloud in the US region (`https://sonarqube.us`). Not needed for SonarQube Cloud in the EU region. > **Important:** Your SonarQube token is a sensitive credential. Use environment variables to pass tokens rather than hardcoding them in configuration files. Never commit tokens to version control. ### Transport options The SonarQube MCP Server supports three transport modes. Use [Stdio](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#local-server-stdio) for local development and most use cases, [HTTPS](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#https) for production and team deployments, and [HTTP](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#http) only on trusted internal networks. #### Stdio (recommended) Use [Stdio](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#local-server-stdio) for local development or when you're the only user. It's also the transport mode used in your [Agentic Analysis](/agent-centric-development-cycle/features/agentic-analysis.md) and [Context Augmentation](/agent-centric-development-cycle/features/context-augmentation.md) workflows. **Automatic configuration** When you're using an AI-enabled IDE such as Cursor, Windsurf, or VS Code with Copilot enabled, and have already completed your [Connected mode setup](/sonarqube-developer-tools/sonarqube-for-vs-code/connect-your-ide/setup.md) in SonarQube for IDE with SonarQube Server or SonarQube Cloud, a quick select button is available. * Select the ![Configure MCP Server button](/spaces/6LPRABg3ubAJhpfR5K0Y/files/19YscUCoGrEOOSWBKSDl) icon, **Configure MCP Server** from the **CONNECTED MODE** view window to use your connected mode credentials to start using the SonarQube MCP Server. The same workflow is available in the **AI AGENTS CONFIGURATION** view. If you've connected to a SonarQube Cloud organization in the US region, the configuration details will be shared. **Quick configuration** Use the following links to quickly set up the SonarQube MCP Server in Cursor. This generates a configuration file and automatically fills it with your environment variables. Make sure your environment variables are configured first. * [Connect to SonarQube Cloud](cursor://anysphere.cursor-deeplink/mcp/install?name=sonarqube-mcp-server\&config=eyJlbnYiOnsiU09OQVJRVUJFX1RPS0VOIjoiWU9VUl9UT0tFTiIsIlNPTkFSUVVCRV9PUkciOiJZT1VSX09SRyJ9LCJjb21tYW5kIjoiZG9ja2VyIHJ1biAtLW5hbWUgc29uYXJxdWJlLW1jcC1zZXJ2ZXIgLS1ybSAtaSAtZSBTT05BUlFVQkVfVE9LRU4gLWUgU09OQVJRVUJFX09SRyBtY3Avc29uYXJxdWJlIn0%3D) * [Connect to SonarQube Server](cursor://anysphere.cursor-deeplink/mcp/install?name=sonarqube-mcp-server\&config=eyJlbnYiOnsiU09OQVJRVUJFX1RPS0VOIjoiWU9VUl9VU0VSX1RPS0VOIiwiU09OQVJRVUJFX1VSTCI6IllPVVJfU0VSVkVSX1VSTCJ9LCJjb21tYW5kIjoiZG9ja2VyIHJ1biAtLW5hbWUgc29uYXJxdWJlLW1jcC1zZXJ2ZXIgLS1ybSAtaSAtZSBTT05BUlFVQkVfVE9LRU4gLWUgU09OQVJRVUJFX1VSTCBtY3Avc29uYXJxdWJlIn0%3D) Watch the [Cursor and SonarQube MCP Server integration](https://www.youtube.com/watch?v=RO5c-g6aOY4) demo on YouTube. **Manual configuration** For a manual configuration, add this MCP configuration to your `mcp.json` file, at the location specified in the [Cursor documentation](https://docs.cursor.com/context/model-context-protocol#configuration-locations). For more information on the environment variables and how to retrieve the token and organization information, see the [environment variables](/sonarqube-developer-tools/sonarqube-mcp-server/reference/environment-variables.md) page. > **Warning:** *User tokens* are required when setting up connected mode or an MCP server between SonarQube Server and SonarQube for IDE. Your binding won't function properly if you use *project tokens*, *global tokens*, or *scoped organization tokens* during setup. > **Note:** This code sample configures the MCP server using [Stdio](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#local-server-stdio) transport, where `SONARQUBE_TOKEN` is passed as an environment variable. > > For [HTTPS](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#https), [HTTP](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#http), or the [SonarQube Cloud-hosted MCP server](#sonarqube-cloud-hosted-mcp-server), the `SONARQUBE_TOKEN` header is deprecated. Pass the token using the `"Authorization": "Bearer "` header instead. > **Tip:** SONARQUBE\_URL should be defined as `https://sonarqube.us` each time you use a SonarQube Cloud configuration (`SONARQUBE_TOKEN` + `SONARQUBE_ORG`) and want to connect to a US-region instance. See the [Connecting to SonarQube Cloud in the US region](/sonarqube-developer-tools/sonarqube-mcp-server/setup/environment-considerations.md#connecting-to-sonarqube-cloud-in-the-us-region) section for details. **Cursor with SonarQube Cloud** ```json { "mcpServers": { "sonarqube": { "command": "docker", "args": [ "run", "-i", "--rm", "--init", "--pull=always", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", //"-e", //"SONARQUBE_URL", "mcp/sonarqube" ], "env": { "SONARQUBE_TOKEN": "", "SONARQUBE_ORG": "", //"SONARQUBE_URL": "https://sonarqube.us" } } } } ``` **Cursor with SonarQube Server** ```json { "mcpServers": { "sonarqube": { "command": "docker", "args": [ "run", "-i", "--rm", "--init", "--pull=always", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_URL", "mcp/sonarqube" ], "env": { "SONARQUBE_TOKEN": "", "SONARQUBE_URL": "" }, } } } ``` Once you've set up the Sonar MCP Server, the configuration appears under **Tools & Integrations** in Cursor. > **Tip:** To verify the connection, ask your AI agent to call the SonarQube MCP `ping_system` tool. For example: *"Ping the SonarQube MCP server."* > **Note:** Restart Cursor for the new MCP server configuration to take effect. #### HTTPS Use HTTPS when connecting Cursor to a shared MCP server deployed for a team. This requires an [HTTPS transport server](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#https) to be running and accessible. Add the following to your `mcp.json` file, at the location specified in the [Cursor documentation](https://docs.cursor.com/context/model-context-protocol#configuration-locations): ```json { "mcpServers": { "sonarqube": { "type": "https", "url": "https://:8443/mcp", "headers": { "Authorization": "Bearer " } } } } ``` > **Tip:** To verify the connection, ask your AI agent to call the SonarQube MCP `ping_system` tool. For example: *"Ping the SonarQube MCP server."* > **Note:** Restart Cursor for the new MCP server configuration to take effect. #### HTTP > **Important:** The [HTTP](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#http) transport mode is not recommended. Use [Stdio](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#stdio) for local development or [HTTPS](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#https) for multi-user production deployments. Use HTTP only on a trusted internal network or for local testing. This requires an [HTTP transport server](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#http) to be running. Add the following to your `mcp.json` file: ```json { "mcpServers": { "sonarqube": { "type": "http", "url": "http://:8080/mcp", "headers": { "Authorization": "Bearer " } } } } ``` > **Tip:** To verify the connection, ask your AI agent to call the SonarQube MCP `ping_system` tool. For example: *"Ping the SonarQube MCP server."* > **Note:** Restart Cursor for the new MCP server configuration to take effect. ## Agentic analysis and context augmentation When using Agentic Analysis and Context Augmentation services, your `SONARQUBE_TOKEN` lets your local MCP server configured for [Stdio](/sonarqube-developer-tools/sonarqube-mcp-server/setup/self-hosted.md#local-server-stdio) mode authenticate to the SonarQube Cloud API. See [Agentic Analysis](/agent-centric-development-cycle/features/agentic-analysis.md) and [Context Augmentation](/agent-centric-development-cycle/features/context-augmentation.md) for more information. ## SonarQube Cloud-hosted MCP server Use the SonarQube Cloud-hosted MCP server to avoid running and maintaining your own MCP infrastructure while always using the current server version. The embedded server exposes a smaller, fixed subset of tools; for the available toolsets and configuration details, see the [SonarQube Cloud-hosted](/sonarqube-developer-tools/sonarqube-mcp-server/setup/sonarqube-cloud-hosted.md) page. ## Use Sonar tools from Cursor Once connected, use the Cursor chat to call SonarQube MCP tools—for example, by typing: "search my sonarqube projects". See the [tools](/sonarqube-developer-tools/sonarqube-mcp-server/reference/tools.md) page for the full list of available tools. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sonarsource.com/sonarqube-developer-tools/sonarqube-mcp-server/setup/quickstart-guides/cursor.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.