JetBrains IDEs MCP — Сценарии использования, Установка & Живое демо

Name: JetBrains IDEs MCP Server
Author: JetBrains

Зачем использовать

Ключевые функции

Reads the IDE's indexed model — symbol resolution, type info, call hierarchies
Trigger refactorings, run configurations, tests from the agent
Works across all IntelliJ-based IDEs with the same MCP Server plugin
Note: since 2025.2, MCP Server is integrated into the IDEs natively

Живое демо

Как выглядит на практике

jetbrains.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "jetbrains",
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "jetbrains": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jetbrains/mcp-proxy"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add jetbrains -- npx -y @jetbrains/mcp-proxy

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: JetBrains IDEs

Rename a symbol safely across the whole project

👤 Java / Kotlin / Python / C# engineers ⏱ ~10 min intermediate

Когда использовать: You want to rename a symbol but grep-and-replace would miss string references or dynamic calls.

Предварительные требования

MCP Server plugin installed in the IDE — plugins.jetbrains.com/plugin/26071-mcp-server — or built-in if on 2025.2+
Project opened and indexed in the IDE — Open the project; wait for indexing to complete (status bar)

Поток

Find the symbol

Find the definition and all usages of getCurrentUser in the project. Include test files.✓ Скопировано

→ IDE-accurate usage list with file:line
Dry-run the rename

Show me what renaming to getAuthenticatedUser would change. Flag any string literals or reflection-based calls I'll need to fix manually.✓ Скопировано

→ Preview diff + manual-fix list
Apply the refactor

Apply the rename. Then run the affected tests.✓ Скопировано

→ Refactor done, tests green

Итог: A safe rename with IDE-level accuracy, covered by the IDE's existing refactoring engine.

Подводные камни

Reflection-based or string-built references aren't caught — After refactor, grep for the old name as a string — the IDE warns but doesn't auto-fix these
IDE not fully indexed, results are partial — Wait for the progress bar to clear before running; ask the IDE for index status first

Сочетать с: git

Run a specific test and iterate on failures

👤 Any engineer using JetBrains IDEs ⏱ ~15 min intermediate

Когда использовать: You want the agent to write code, run the matching test, fix failures, iterate — without leaving the chat.

Предварительные требования

Run configuration for the test exists in the IDE — Right-click test file → Run — IDE saves the config

Поток

Run the specific test

Run the CartCalculatorTest class. Return pass/fail per method with failure messages.✓ Скопировано

→ Structured test result
Fix failures

For each failing test, read the source, identify the bug, propose a minimal fix.✓ Скопировано

→ File:line + proposed change
Loop

Apply the fix and re-run until green. Don't modify tests, only production code.✓ Скопировано

→ All tests passing

Итог: TDD-at-agent-speed with the IDE's compile + run infrastructure.

Подводные камни

Agent modifies tests to make them pass — Explicit prompt: 'do not touch test files'; review the diff before committing

Onboard to an unfamiliar codebase via IDE navigation

👤 New hires, code reviewers ⏱ ~30 min beginner

Когда использовать: You need to understand how X is used without bouncing around 20 files manually.

Поток

Start at an entrypoint

Find the HTTP handler for POST /checkout. Show me the call hierarchy — what it calls, depth 3.✓ Скопировано

→ Call tree with file:line nodes
Find tests

Find all tests that exercise the checkout flow. Open each and summarize what they cover.✓ Скопировано

→ Test coverage map
Explain the flow

Write a 1-page explainer: endpoint → validation → payment → persistence → response. Reference files with line numbers.✓ Скопировано

→ Onboarding-quality explainer

Итог: A concrete mental model of a subsystem in 30 minutes instead of a day.

Подводные камни

Agent invents class/method names that don't exist — Every claim must link to file:line — if it can't, it's hallucinated; call it out and re-query

Сочетать с: git

Комбинации

Сочетайте с другими MCP — эффект x10

jetbrains + git

IDE-level refactor + verify commit is clean

Rename fetchUser to loadUser project-wide. Then show me the git diff — confirm tests still pass and commit.✓ Скопировано

jetbrains + github

Reviewing a PR with IDE navigation instead of GitHub's web UI

Check out PR #234's branch. Walk through the diff using find_usages to understand what each changed method is called from.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
get_project_structure		Overview when starting in a new project	free
find_usages	symbol	Impact analysis before changes	free
search_in_files	text, scope?	Full-text search across project	free
get_symbol_info	symbol or file:line	Resolve what something is	free
run_configuration	config_name	Execute a saved run config (test, app, script)	free (local)
apply_refactoring	refactor type + params	Rename, extract method, inline, move	free
get_diagnostics	file_path?	Catch issues the IDE already knows about	free

Стоимость и лимиты

Во что обходится

Квота API: None — local IDE
Токенов на вызов: Call hierarchies can be large; limit depth explicitly
Деньги: Free — MCP is free; you need a JetBrains license anyway
Совет: Rely on IDE operations (find_usages, refactor) over raw filesystem reads — cheaper tokens and more accurate

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: None — local IDE

Исходящий трафик: None to JetBrains; MCP is localhost-only between IDE and client

The JetBrains/mcp-jetbrains npm package is deprecated — since IDE 2025.2, MCP Server functionality is built in. Prefer the built-in version if you're on a recent release.

Устранение неполадок

Частые ошибки и исправления

Connection refused / MCP can't reach IDE

The IDE must be open with the plugin enabled. Check Settings → Tools → MCP Server; port is usually 63342 or auto-assigned.

Проверить: curl http://localhost:63342/api/mcp

Tools return 'Project not found'

No project open in the IDE, or multiple projects open and agent is asking about the wrong one. Focus the correct window.

Refactor reports files changed but they look the same

IDE buffers aren't saved to disk yet. Call a 'save all' tool or Cmd+S in the IDE.

find_usages misses references

Indexing hasn't completed. Wait for the IDE status bar to show 'Indexing complete'.

Альтернативы

JetBrains IDEs в сравнении

Альтернатива	Когда использовать	Компромисс
VSCode MCP (various community)	You're on VSCode instead of JetBrains	Different IDE, different ecosystem — not a direct swap
language-server MCPs	You want IDE-agnostic code intelligence via LSP	LSP gives basic symbol info but not refactoring or run configs

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills