JetBrains IDEs MCP — Casos de uso, Instalar & Demo ao vivo

Name: JetBrains IDEs MCP Server
Author: JetBrains

Por que usar

Principais recursos

Lê o modelo indexado da IDE — resolução de símbolos, informações de tipo, hierarquias de chamadas
Dispara refatorações, executa configurações, testa a partir do agente
Funciona em todas as IDEs baseadas em IntelliJ com o mesmo plugin MCP Server
Nota: desde 2025.2, MCP Server está integrado nas IDEs nativamente

Demo ao vivo

Como fica na prática

jetbrains.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

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

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: JetBrains IDEs

Renomear um símbolo com segurança em todo o projeto

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

Quando usar: Você quer renomear um símbolo, mas grep-and-replace perderia referências em strings ou chamadas dinâmicas.

Pré-requisitos

Plugin MCP Server instalado na IDE — plugins.jetbrains.com/plugin/26071-mcp-server — ou integrado se em 2025.2+
Projeto aberto e indexado na IDE — Abra o projeto; aguarde a conclusão da indexação (barra de status)

Fluxo

Encontre o símbolo

Encontre a definição e todos os usos de getCurrentUser no projeto. Inclua arquivos de teste.✓ Copiado

→ Lista de uso precisa da IDE com arquivo:linha
Simulação da renomeação

Mostre-me o que mudaria ao renomear para getAuthenticatedUser. Sinalize quaisquer literais de string ou chamadas baseadas em reflexão que precisarei corrigir manualmente.✓ Copiado

→ Visualização de diff + lista de correções manuais
Aplique a refatoração

Aplique a renomeação. Depois execute os testes afetados.✓ Copiado

→ Refatoração concluída, testes verdes

Resultado: Uma renomeação segura com precisão de nível IDE, coberta pelo mecanismo de refatoração existente da IDE.

Armadilhas

Referências baseadas em reflexão ou construídas em strings não são detectadas — Após a refatoração, grep o nome antigo como uma string — a IDE avisa, mas não corrige automaticamente
IDE não totalmente indexada, resultados são parciais — Aguarde a barra de progresso desaparecer antes de executar; primeiro pergunte ao IDE pelo status do índice

Combine com: git

Execute um teste específico e itere sobre falhas

👤 Qualquer engenheiro usando IDEs JetBrains ⏱ ~15 min intermediate

Quando usar: Você quer que o agente escreva código, execute o teste correspondente, corrija falhas, itere — sem sair do chat.

Pré-requisitos

Configuração de execução para o teste existe na IDE — Clique direito no arquivo de teste → Executar — IDE salva a configuração

Fluxo

Execute o teste específico

Execute a classe CartCalculatorTest. Retorne sucesso/falha por método com mensagens de falha.✓ Copiado

→ Resultado de teste estruturado
Corrija as falhas

Para cada teste que falha, leia o código, identifique o bug, proponha uma correção mínima.✓ Copiado

→ Arquivo:linha + mudança proposta
Loop

Aplique a correção e execute novamente até que fique verde. Não modifique os testes, apenas o código de produção.✓ Copiado

→ Todos os testes passando

Resultado: TDD em velocidade de agente com infraestrutura de compilação + execução da IDE.

Armadilhas

Agente modifica testes para fazê-los passar — Prompt explícito: 'não toque em arquivos de teste'; revise o diff antes de fazer commit

Integre-se a uma base de código desconhecida via navegação IDE

👤 Novos contratados, revisores de código ⏱ ~30 min beginner

Quando usar: Você precisa entender como X é usado sem pular entre 20 arquivos manualmente.

Fluxo

Comece em um ponto de entrada

Encontre o manipulador HTTP para POST /checkout. Mostre-me a hierarquia de chamadas — o que ele chama, profundidade 3.✓ Copiado

→ Árvore de chamadas com nós arquivo:linha
Encontre testes

Encontre todos os testes que exercitam o fluxo de checkout. Abra cada um e resuma o que cobrem.✓ Copiado

→ Mapa de cobertura de testes
Explique o fluxo

Escreva um explicador de 1 página: endpoint → validação → pagamento → persistência → resposta. Referencie arquivos com números de linha.✓ Copiado

→ Explicador de qualidade de onboarding

Resultado: Um modelo mental concreto de um subsistema em 30 minutos em vez de um dia.

Armadilhas

Agente inventa nomes de classe/método que não existem — Toda alegação deve estar vinculada a arquivo:linha — se não conseguir, é alucinação; indique e refaça a consulta

Combine com: git

Combinações

Combine com outros MCPs para 10× de alavancagem

jetbrains + git

Refatoração de nível IDE + verificar se commit é limpo

Renomeie fetchUser para loadUser em todo o projeto. Depois mostre-me o git diff — confirme que os testes ainda passam e faça commit.✓ Copiado

jetbrains + github

Revisar um PR com navegação IDE em vez da interface web do GitHub

Verifique o branch do PR #234. Percorra o diff usando find_usages para entender de onde cada método alterado é chamado.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
get_project_structure		Visão geral ao começar em um novo projeto	gratuito
find_usages	símbolo	Análise de impacto antes das mudanças	gratuito
search_in_files	texto, escopo?	Busca de texto completo no projeto	gratuito
get_symbol_info	símbolo ou arquivo:linha	Resolva o que algo é	gratuito
run_configuration	nome_da_configuração	Execute uma configuração de execução salva (teste, app, script)	gratuito (local)
apply_refactoring	tipo de refatoração + parâmetros	Renomear, extrair método, inline, mover	gratuito
get_diagnostics	caminho_do_arquivo?	Detecte problemas que a IDE já conhece	gratuito

Custo e limites

O que custa rodar

Cota de API: Nenhuma — IDE local
Tokens por chamada: Hierarquias de chamadas podem ser grandes; limite a profundidade explicitamente
Monetário: Gratuito — MCP é gratuito; você precisa de uma licença JetBrains de qualquer forma
Dica: Confie em operações IDE (find_usages, refactor) ao invés de leituras brutas do sistema de arquivos — tokens mais baratos e mais precisos

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhuma — IDE local

Saída de dados: Nenhuma para JetBrains; MCP é apenas localhost entre IDE e cliente

O pacote npm JetBrains/mcp-jetbrains está descontinuado — desde IDE 2025.2, a funcionalidade MCP Server está integrada. Prefira a versão integrada se você estiver em uma versão recente.

Solução de problemas

Erros comuns e correções

Conexão recusada / MCP não consegue alcançar IDE

A IDE deve estar aberta com o plugin habilitado. Verifique Configurações → Ferramentas → MCP Server; a porta é geralmente 63342 ou atribuída automaticamente.

Verificar: curl http://localhost:63342/api/mcp

Ferramentas retornam 'Projeto não encontrado'

Nenhum projeto aberto na IDE, ou vários projetos abertos e o agente está perguntando sobre o errado. Foque a janela correta.

Refatoração relata arquivos alterados, mas parecem iguais

Os buffers da IDE ainda não foram salvos em disco. Chame uma ferramenta 'salvar tudo' ou Cmd+S na IDE.

find_usages perde referências

A indexação não foi concluída. Aguarde a barra de status da IDE mostrar 'Indexação concluída'.

Alternativas

JetBrains IDEs vs. outros

Alternativa	Quando usar	Troca
VSCode MCP (várias comunidades)	Você está no VSCode em vez de JetBrains	IDE diferente, ecossistema diferente — não é uma troca direta
MCPs de servidor de linguagem	Você quer inteligência de código agnóstico de IDE via LSP	LSP fornece informações básicas de símbolos, mas não refatoração ou configurações de execução

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills