Set up your app
Adding MCP servers to JetBrains IDEs
By Sophie Filer · Updated 10 Nov 2026
JetBrains IDEs such as IntelliJ IDEA, PyCharm and WebStorm connect to MCP servers through AI Assistant. You paste the same "mcpServers" JSON other apps use into a settings dialog, and each server can be on for every project or just one.
- Settings
- Tools → AI Assistant → Model Context Protocol (MCP)
- Format
- "mcpServers" JSON
- Local servers
- Yes
- Remote URLs
- Yes
At a glance
- Step 1
1. Pick a server
Find one on the shelf and open its page.
- Step 2
2. Open MCP settings
Tools → AI Assistant → Model Context Protocol (MCP).
- Step 3
3. Add and paste
Pick STDIO or HTTP, paste the JSON, choose Global or Project.
- Step 4
4. Apply
Check the Status column, then ask AI Assistant.
Before you start
- AI Assistant must be installed and switched on in your IDE. MCP lives in its settings.
- For local servers, the runtime they need on your PATH: Node.js for
npx, uv foruvx, or Docker. - If your company manages AI Assistant centrally, an admin may have added servers for you already, or turned off adding your own.
AI Assistant can start local servers over standard input and output, and connect to remote ones over Streamable HTTP. Older servers that still use SSE work too.
Add a server
- Step 1: Open Settings (Preferences on older Macs) and go to Tools → AI Assistant → Model Context Protocol (MCP). Typing
/in the AI chat and choosing Add Command opens the same page. - Step 2: Click Add (the + button).
- Step 3: Choose STDIO for a command or HTTP for a URL, then paste the JSON from the server’s page on MCP Shelf. The Claude Desktop tab has the right shape.
- Step 4: For a local server, set the Working directory if its arguments use relative paths.
- Step 5: Pick the server level: Global for every project, or Project for this one only.
- Step 6: Click OK, then Apply. The IDE starts the server, and the Status column shows whether it connected.
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Use the tools in the chat
Once a server shows as connected, AI Assistant can call its tools when your request needs them. You can also run a tool yourself by typing / in the chat and picking it. To see what a server offers, click the icon in its Status column.
- To pause a server, untick its checkbox and click Apply.
- To move a server between Global and Project, click its entry in the Level column.
- After changing a server’s config, select it and click Reconnect.
- Turn on "Automatically enable new and changed MCP servers" if you would rather not tick each one after adding it.
Keys, files and Docker
Servers that need an API key take it in an "env" block, exactly as in other apps. Servers that read files usually take the folder as their last argument; give an absolute path, or set the Working directory and use a relative one.
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": { "FIRECRAWL_API_KEY": "fc-your-key" }
}
}
}Servers that ship as Docker images use docker as the command, with run -i --rm and the image name as arguments. Running MCP servers in Docker covers the flags, mounting folders and passing keys.
When a server will not start
- Read the server’s own log. Go to Help → Show Log in Finder (Show Log in Explorer on Windows), open the
mcpfolder, and find the file named after your server. - Run the command in your terminal. If
npxoruvxis not found there, the IDE cannot find it either. On macOS, an IDE opened from the Dock may not see a PATH set up by nvm or Homebrew; use the full path, such as/opt/homebrew/bin/npx. - Check the JSON has a single "mcpServers" block. A trailing comma or a missing brace stops the dialog from saving.
- For a URL that will not connect, test it with MCP Inspector first.
Common error messages and their fixes are in Fixing MCP server errors.
The other way round: your IDE as an MCP server
Since version 2025.2, JetBrains IDEs also include their own MCP server, so other assistants can use the IDE: open files, run configurations, search the project. It is a bundled plugin, switched off until you enable it.
- Step 1: Go to Settings → Tools → MCP Server and tick Enable MCP Server.
- Step 2: Read what the dialog says outside apps will be able to do with your open projects, then click Enable and Apply.
- Step 3: Under Clients Auto-Configuration, click Auto-Configure next to each app you use, such as Claude Code, Codex or VS Code. The IDE writes its address into that app’s config for you.
Popular servers to try
| Server | What it gives your assistant | You need |
|---|---|---|
| Sequential Thinking | A numbered scratchpad the model fills in, revises and branches while it works. | Node.js 24 or newer (the package asks for it) |
| Context7 | Pulls current, version-specific library docs into the conversation. | Node.js 22.13 or newer for the ctx7 setup command, or Node.js 18 or newer for the local server alone |
| Playwright MCP | Microsoft's browser automation server: navigate, click, type, read. | Node.js 18 or newer |
| GitHub | GitHub's own server for repos, issues, pull requests and Actions. | A GitHub account |
| Blender MCP | Prompt-driven modelling in a running copy of Blender. | Blender 3.0 or newer |
| Serena | IDE-style "find symbol" and "edit symbol" for an agent, backed by language servers. | uv, which installs Serena and the Python 3.13 it runs on |
| MCP Toolbox for Databases | Google's toolbox for Postgres, MySQL, BigQuery, Spanner and other databases. | Node.js 18 or newer |
| Framelink Figma MCP | Feeds Figma layout and styling to coding agents so the UI matches the design. | A Figma personal access token |
Questions
Which JetBrains IDEs support MCP?
All the IDEs that run AI Assistant, including IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Rider, RubyMine and CLion. The settings page is in the same place in each.
Can I reuse my Claude Desktop or Cursor config?
Yes. AI Assistant reads the same "mcpServers" JSON, and Import from Claude copies your Claude Desktop servers in one click. Cursor entries can be pasted as they are.
Does AI Assistant support remote MCP servers?
Yes. Choose HTTP when you add the server and give it a "url". It speaks Streamable HTTP, and SSE for older servers.
What is the difference between this and the JetBrains MCP Server setting?
Model Context Protocol (MCP) under AI Assistant lets the IDE’s assistant use other servers. MCP Server under Tools does the reverse: it lets other assistants, such as Claude Code, use your IDE.
Plant Your First Pea
Every server on the shelf has a tab with the exact config for your app.
For bots & AI agents
Machine-readable versions of this guide and MCP Shelf. Fetch these instead of parsing this page.
This guide (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs