---
component: ROOT
version: "2026.1"
slug: ROOT/integrations/ai-clients
canonical_url: "https://docs.gradle.com/develocity/2026.1/integrations/mcp-servers/ai-clients/"
title: "AI Clients"
description: "Set up and configure the Develocity MCP servers in your AI client for build analysis and insights."
keywords: []
status: current
---

<!-- llms-index: https://docs.gradle.com/develocity/llms.txt -->

# AI Clients

<a id="preamble"></a>

This guide explains how to connect your AI clients to the MCP servers provided by Develocity. To enable the MCP servers on your Develocity installation, see the [Installation Manual](https://docs.gradle.com/develocity/2026.1/integrations/mcp-servers/installation/).

<a id="permissions"></a>

## Permissions

Both MCP servers require an access key with the `Access build data via the API` permission.

The Develocity Analytics MCP Server additionally requires `Access all data with or without an associated project` for instances with project-level access control enabled.

You can check your permissions by visiting the `/settings/access` page when logged in to Develocity.

For detailed instructions on generating access keys, see [the Develocity API user manual](https://docs.gradle.com/develocity/2026.1/reference/develocity-api/#creating-access-keys).

<a id="mcp-client-configuration"></a>

## MCP Client Configuration

Configure the Develocity MCP Server using the URL of your Develocity instance with the path `/mcp`, for example, `https://develocity.example.com/mcp`.

Configure the Develocity Analytics MCP Server using the path `/drv-mcp` appended to either your Develocity instance URL (if using Athena Data Export) or your Reporting Kit instance URL. For example, `https://develocity.example.com/drv-mcp` or `https://reporting-kit.example.com/drv-mcp`.

<a id="tabs-1"></a>

*   <a id="tabs-1-claude-code-cli"></a>
    
    Claude Code CLI
    
*   <a id="tabs-1-github-copilot-intellij-ides"></a>
    
    GitHub Copilot (IntelliJ IDEs)
    
*   <a id="tabs-1-github-copilot-visual-studio-code"></a>
    
    GitHub Copilot (Visual Studio Code)
    
*   <a id="tabs-1-gemini-cli"></a>
    
    Gemini CLI
    
*   <a id="tabs-1-gemini-in-android-studio"></a>
    
    Gemini in Android Studio
    
*   <a id="tabs-1-claude-desktop-via-npx-mcp-remote"></a>
    
    Claude Desktop (via npx mcp-remote)
    

<a id="tabs-1-claude-code-cli--panel"></a>

Use the Claude Code CLI to add the MCP servers ([guide](https://code.claude.com/docs/en/mcp)):

```shell
claude mcp add --transport http develocity --scope user <base-url>/mcp --header "Authorization: Bearer <Develocity Access Key>"
```

```shell
claude mcp add --transport http develocity-analytics --scope user <base-url>/drv-mcp --header "Authorization: Bearer <Develocity Access Key>"
```

<a id="tabs-1-github-copilot-intellij-ides--panel"></a>

Use the GitHub Copilot plugin for IntelliJ IDEs to connect to the MCP servers ([guide](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)):

**mcp.json:**

```
{
  "servers": {
    "develocity": {
      "type": "http",
      "url": "<base-url>/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer <Develocity Access Key>"
        }
      }
    },
    "develocity-analytics": {
      "type": "http",
      "url": "<base-url>/drv-mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer <Develocity Access Key>"
        }
      }
    }
  }
}
```

<a id="tabs-1-github-copilot-visual-studio-code--panel"></a>

Use GitHub Copilot for Visual Studio Code to connect to the MCP servers ([guide](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)).

Using `inputs` is recommended to avoid hardcoding the Develocity access key within the JSON configuration. You will be prompted for your access key the first time you start the server.

**mcp.json:**

```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "develocity-access-key",
      "description": "Develocity Access Key",
      "password": true
    }
  ],
  "servers": {
    "develocity": {
      "type": "http",
      "url": "<base-url>/mcp",
      "headers": {
        "Authorization": "Bearer ${input:develocity-access-key}"
      }
    },
    "develocity-analytics": {
      "type": "http",
      "url": "<base-url>/drv-mcp",
      "headers": {
        "Authorization": "Bearer ${input:develocity-access-key}"
      }
    }
  }
}
```

<a id="tabs-1-gemini-cli--panel"></a>

Add the following JSON configuration to your Gemini settings file, typically located at `~/.gemini/settings.json`. More details can be found in the [documentation](https://geminicli.com/docs/tools/mcp-server/#how-to-set-up-your-mcp-server).

**settings.json:**

```
{
  "mcpServers": {
    "develocity": {
      "httpUrl": "<base-url>/mcp",
      "headers": {
        "Authorization": "Bearer <Develocity Access Key>"
      }
    },
    "develocity-analytics": {
      "httpUrl": "<base-url>/drv-mcp",
      "headers": {
        "Authorization": "Bearer <Develocity Access Key>"
      }
    }
  }
}
```

<a id="tabs-1-gemini-in-android-studio--panel"></a>

Use Gemini in Android Studio to connect to the MCP servers ([guide](https://developer.android.com/studio/gemini/add-mcp-server)):

**mcp.json:**

```
{
  "mcpServers": {
    "develocity": {
      "httpUrl": "<base-url>/mcp",
      "headers": {
        "Authorization": "Bearer <Develocity Access Key>"
      }
    },
    "develocity-analytics": {
      "httpUrl": "<base-url>/drv-mcp",
      "headers": {
        "Authorization": "Bearer <Develocity Access Key>"
      }
    }
  }
}
```

<a id="tabs-1-claude-desktop-via-npx-mcp-remote--panel"></a>

Claude Desktop doesn’t support connecting to MCP servers using an access key for authentication, which is required by the Develocity MCP servers. To use the MCP servers with Claude Desktop, configure a local MCP proxy that converts the streamable HTTP API into the STDIO protocol.

A popular proxy server for this purpose is [mcp-remote](https://github.com/geelen/mcp-remote).

> [!IMPORTANT]
> Gradle isn’t affiliated with or involved in the development of mcp-remote. Please ensure that any third-party software you install complies with your organization’s security policies.

Modify the Claude Desktop configuration file (**Developer**  **Edit Config** in settings) with the following, replacing `<base-url>` and `<Develocity Access Key>`:

```json
{
  "mcpServers": {
    "develocity": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "<base-url>/mcp",
        "--header",
        "Authorization: Bearer ${API_ACCESS_TOKEN}",
        "--transport",
        "http-only"
      ],
      "env": {
        "API_ACCESS_TOKEN": "<Develocity Access Key>"
      }
    },
    "develocity-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "<base-url>/drv-mcp",
        "--header",
        "Authorization: Bearer ${API_ACCESS_TOKEN}",
        "--transport",
        "http-only"
      ],
      "env": {
        "API_ACCESS_TOKEN": "<Develocity Access Key>"
      }
    }
  }
}
```

<a id="other-clients"></a>

### Other Clients

The Develocity MCP servers follow the standard MCP protocol and will work with any clients that support:

*   Remote MCP servers
    
*   Streamable HTTP transport
    
*   Bearer authentication with static credentials
    

<a id="usage-tips"></a>

## Usage Tips

<a id="recommended-models"></a>

### Recommended Models

After testing the MCP servers against a variety of different models, our recommendation is to use the latest or frontier version of your selected model where possible.

Testing has shown the "light" versions of these models are capable of basic analysis, however they’re more prone to making mistakes and generally provide worse results than the frontier versions of the models.

<a id="avoiding-common-issues-with-llms"></a>

### Avoiding Common Issues With LLMs

When using the Develocity Analytics MCP Server, briefly inspect the SQL queries submitted by the LLM to the MCP server to catch obvious errors.

Long conversations with many different lines of questioning or analysis may lead to the model’s responses becoming gradually worse. Consider starting a new session or clearing the model’s context to fix this when it happens.

<a id="authentication-troubleshooting"></a>

### Authentication Troubleshooting

Authentication or access key errors may be interpreted by client applications as a trigger to initiate the OAuth access flow. If you begin to see messages or errors related to authentication or OAuth, verify that your access key configuration is correct, the key is valid, and the associated Develocity user has the required permissions.

Some clients may need a restart for MCP configuration to be correctly updated.

<a id="example-usage"></a>

## Example Usage

<a id="develocity-mcp-server"></a>

### Develocity MCP Server

Here are some example prompts you can use with Develocity MCP Server:

*   _What are the most flaky tests from this week?_
    
*   _What different kinds of failures happened on CI on my branch?_
    
*   _What was the cause of the most recent failed build?_
    
*   _How can I make builds for this project faster?_
    

<a id="develocity-analytics-mcp-server"></a>

### Develocity Analytics MCP Server

Here are some example prompts you can use with Develocity Analytics MCP Server:

*   _Are any projects using a version of log4j earlier than 2.17.1?_
    
*   _Which projects are using a non-LTS JDK version?_
    
*   _What tasks should I prioritize fixing to stabilize my CI builds?_
    
*   _Can you identify whether some users are impacted more by locally failing builds than others?_
    
*   _What’s the typical configuration time for local builds?_
    
*   _Which are the longest-running tasks in my CI builds?_
    
*   _What are the top 5 slowest builds in the last week?_