JetBrains — Claude Code MCP server: what it does, how to install
Passes MCP client requests into a running JetBrains IDE, so the agent works against the project you have open. Useful when the editor is already running and the client lives outside it.
no license updated 2026-10-29
Open on GitHubWhat JetBrains does
The proxy sits between an MCP client and a JetBrains IDE: the client sends requests, the server hands them to the IDE that holds the project. The IDE itself needs the MCP Server plugin installed, otherwise there is nothing to talk to. Launch it as the mcp/jetbrains container or through npx -y @jetbrains/mcp-proxy.
When several IDEs are open, set IDE_PORT in env to pick one. Traffic goes to 127.0.0.1 unless you point HOST elsewhere. Logging switches on with LOG_ENABLED.
Node 16 is out: startup dies with Cannot find module 'node:path', so use 18 or later. On macOS with nvm the plugin can miss npx, and a symlink in /usr/local/bin fixes that. External clients and containers such as LibreChat also need external connections allowed in the debugger settings, plus the machine's LAN address in place of host.docker.internal.
What it helps with
- connect an MCP client to a JetBrains IDE that is already running
- pick one IDE when several windows carry the plugin
- run the proxy in Docker next to a containerised client
- turn on logging when the proxy goes quiet
- trace a startup failure back to an old Node version
Example prompts for the agent
- Hook up my running JetBrains IDE through the MCP proxy and list the tools it exposes.
- The proxy can't see my IDE — check
HOSTandIDE_PORTin the config and enableLOG_ENABLED. - Add
npx -y @jetbrains/mcp-proxyto my MCP client config and wire it to the IDE.
How to install JetBrains
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about JetBrains
How do I install the JetBrains MCP server?
Install the MCP Server plugin inside your IDE from JetBrains Marketplace. Then add a server entry running npx -y @jetbrains/mcp-proxy to your MCP client config.
What does the JetBrains MCP server do?
It relays requests from an MCP client to the JetBrains IDE that has your project open.
Which Node.js version does it need?
18 or later. On Node 16 the proxy fails at startup with Cannot find module 'node:path'.