---
title: "JetBrains IDE MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/jetbrains/
description: "MCP server bundled into IntelliJ-based IDEs since 2025.2, exposing IDE tools to external clients over SSE, Streamable HTTP and stdio. The IDE auto-configures detected clients and the server runs locally against the projects opened in the IDE."
---

# JetBrains IDE MCP Server: review, setup & limitations · Undominated.ai

> MCP server bundled into IntelliJ-based IDEs since 2025.2, exposing IDE tools to external clients over SSE, Streamable HTTP and stdio. The IDE auto-configures detected clients and the server runs locally against the projects opened in the IDE.

[← Explore all mcp servers](/mcp-servers/)

APPLICATION DEVELOPMENT / JetBrains

# JetBrains IDE MCP Server

MCP server bundled into IntelliJ-based IDEs since 2025.2, exposing IDE tools to external clients over SSE, Streamable HTTP and stdio. The IDE auto-configures detected clients and the server runs locally against the projects opened in the IDE.

 [See setup guidance ↓](#setup)[Original source ↗](https://www.jetbrains.com/help/idea/mcp-server.html)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 3 linked sources
 Publisher JetBrains
 Licence Not established
 [Read what was—and wasn’t—checked ↓](#review)

“Starting with version 2025.2, IntelliJ IDEA comes with an integrated MCP Server …”

 [JetBrains · upstream description ↗](https://www.jetbrains.com/help/idea/mcp-server.html) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The bundled server is the current official JetBrains MCP surface; the former mcp-jetbrains npm proxy repository is marked deprecated with functionality moved into the IDEs.
- It gives external agents IDE-side tools — code analysis, file modification, run configurations, debugger sessions — that complement the existing xcodebuild record for Apple tooling.

### A good fit for

 - Letting Claude Code, Codex, VS Code or other clients act on an IntelliJ project through the IDE's own indexing and build system.
- Per-project client setup where the MCP server should only be registered while one project is open.

### Weigh up before choosing

 - The local server port is auto-assigned starting from 64342 and was not user-configurable as of January 2026 (tracked as IJPL-207839).
- A brave-mode setting lets connected clients run shell commands or run configurations without confirmation each time; it is a Command execution setting the user must enable.
- Auto-Configure for Claude Desktop writes one server entry named jetbrains, so a second IDE overwrites it unless the entry is renamed by hand (custom names tracked as IJPL-234652).

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - JetBrains IntelliJ IDEA 2026.2 help page for MCP Server, read 2026-10-13: bundled plugin enabled by default since 2025.2, Settings | Tools | MCP Server enable flow with an access-consent dialog, clients auto-configuration, project-level client setup, manual Copy SSE / Stdio / HTTP Stream Config, brave mode, and the Supported tools list with per-tool Enabled and Router-only checkboxes.
- JetBrains YouTrack support article SUPPORT-A-3223 (updated 2026-09-17, read through the YouTrack articles API): the IDE starts a local server, auto-finds the next available port from 64342 and reuses it; port configuration is not exposed; Claude Desktop Auto-Configure writes a jetbrains entry to claude_desktop_config.json.
- JetBrains/mcp-jetbrains README at c8c2b85bc6f029130542fdddc3daf066e404df41: marked deprecated, core functionality integrated into all IntelliJ-based IDEs since 2025.2, with SSE and a JVM-based proxy for stdio.

### Our findings

 - The set of configured transports depends on the client; the IDE writes each client's configuration file itself via Auto-Configure or copies a transport config for manual setup, rather than the help page publishing a fixed JSON snippet. No configExample is given for that reason.
- The deprecated npm package @jetbrains/mcp-proxy remains only as a stdio compatibility bridge; the bundled server is the documented primary path.
- The help page groups the exposed tools into analysis, code insight, database, debugger, execution, file, formatting, inspection, patch, read, refactoring, search, skill search, terminal, universal and VCS tools. Each tool can be disabled under Exposed Tools, or set Router-only so it is reachable only through the router tool.
- The database tools run SQL through the IDE's configured connections; the help page says strictly read-only access needs a database user with read-only privileges.
- Corrected 2026-10-13: the compatibility line named Cursor and Windsurf, which neither the help page, the YouTrack article nor the deprecated README names today. It now lists the clients those sources name.

### Not established by this review

 - No IDE was installed and no client was connected; tool execution against a live project was not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://www.jetbrains.com/help/idea/mcp-server.html)
 - Open Settings | Tools | MCP Server in an IntelliJ-based IDE 2025.2 or later and select Enable MCP Server.
- Review the access-consent dialog describing what third-party applications will get on opened projects.
- Use Auto-Configure for each detected client, or copy the transport configuration manually, then restart the client.

### Before you start

 - An IntelliJ-based JetBrains IDE version 2025.2 or later.

### Compatibility

IntelliJ-based IDEs version 2025.2 or later with the bundled MCP Server plugin enabled. · Clients the help page lists for auto-configuration: Junie, VS Code, Claude Code, Codex, Air and GitHub Copilot CLI. Claude Desktop through the Claude App Auto-Configure entry (YouTrack article). Other clients through the manual SSE, stdio or HTTP Stream configuration.

### Transports

SSE · Streamable HTTP · stdio

### Local IDE session

 - Connected clients gain access to the projects opened in the IDE, per the enable-time consent dialog.
- Exposed tools include file modification, builds, run configurations, debugger control, terminal commands and SQL execution against configured database connections; each tool can be disabled under Exposed Tools.
- Shell command and run-configuration execution without confirmation only if brave mode is explicitly enabled.

### Cost model

Included with JetBrains IDEs; no separate charge.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [JetBrains MCP Server help page ↗](https://www.jetbrains.com/help/idea/mcp-server.html) Checked 2026-10-13 https://www.jetbrains.com/help/idea/mcp-server.html Supports: summary, upstreamDescription, install, access, transports, compatibility, whySelected, bestFor, limitations, review
- [JetBrains YouTrack article on connecting via the MCP Server ↗](https://youtrack.jetbrains.com/projects/RSRP/articles/SUPPORT-A-3223/Connecting-a-JetBrains-IDE-to-Claude-Desktop-via-the-MCP-Server) Checked 2026-10-13 https://youtrack.jetbrains.com/projects/RSRP/articles/SUPPORT-A-3223/Connecting-a-JetBrains-IDE-to-Claude-Desktop-via-the-MCP-Server Supports: limitations, compatibility
- [Deprecated mcp-jetbrains repository README ↗](https://github.com/JetBrains/mcp-jetbrains/blob/c8c2b85bc6f029130542fdddc3daf066e404df41/README.md) Checked 2026-10-13 https://github.com/JetBrains/mcp-jetbrains/blob/c8c2b85bc6f029130542fdddc3daf066e404df41/README.md Supports: whySelected, limitations, review

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### MobileBuildMCP (formerly XcodeBuildMCP) ↗ Build, test and inspect Apple-platform projects through local Xcode and simulator workflows.](/mcp-servers/xcodebuild/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
