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

Name: JetBrains IDEs MCP Server
Author: JetBrains

Por qué usarlo

Características clave

Lee el modelo indexado del IDE — resolución de símbolos, información de tipos, jerarquías de llamadas
Activa refactorings, ejecuta configuraciones de prueba desde el agente
Funciona en todos los IDEs basados en IntelliJ con el mismo plugin MCP Server
Nota: desde 2025.2, MCP Server está integrado nativamente en los IDEs

Demo en vivo

Cómo se ve en la práctica

jetbrains.replay ▶ listo

0/0

Instalar

Elige tu 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"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: JetBrains IDEs

Renombrar un símbolo de forma segura en todo el proyecto

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

Cuándo usarlo: Quieres renombrar un símbolo pero grep-and-replace podría pasar por alto referencias en cadenas o llamadas dinámicas.

Requisitos previos

Plugin MCP Server instalado en el IDE — plugins.jetbrains.com/plugin/26071-mcp-server — o integrado si estás en 2025.2+
Proyecto abierto e indexado en el IDE — Abre el proyecto; espera a que la indexación se complete (barra de estado)

Flujo

Busca el símbolo

Busca la definición y todos los usos de getCurrentUser en el proyecto. Incluye archivos de prueba.✓ Copiado

→ Lista de uso precisa del IDE con archivo:línea
Prueba en seco el renombramiento

Muéstrame qué cambiaría al renombrar a getAuthenticatedUser. Señala cualquier literal de cadena o llamada basada en reflexión que tenga que arreglar manualmente.✓ Copiado

→ Vista previa diff + lista de correcciones manuales
Aplica el refactoring

Aplica el renombramiento. Luego ejecuta las pruebas afectadas.✓ Copiado

→ Refactoring hecho, pruebas en verde

Resultado: Un renombramiento seguro con precisión a nivel IDE, cubierto por el motor de refactoring existente del IDE.

Errores comunes

Las referencias basadas en reflexión o referencias construidas por cadenas no se capturan — Después del refactoring, busca el nombre antiguo como una cadena — el IDE advierte pero no lo corrige automáticamente
IDE no está completamente indexado, los resultados son parciales — Espera a que se borre la barra de progreso antes de ejecutar; pregunta al IDE por el estado del índice primero

Combinar con: git

Ejecutar una prueba específica e iterar sobre los fallos

👤 Cualquier ingeniero que use IDEs de JetBrains ⏱ ~15 min intermediate

Cuándo usarlo: Quieres que el agente escriba código, ejecute la prueba correspondiente, corrija fallos, itere — sin salir del chat.

Requisitos previos

La configuración de ejecución para la prueba existe en el IDE — Haz clic derecho en el archivo de prueba → Ejecutar — el IDE guarda la configuración

Flujo

Ejecuta la prueba específica

Ejecuta la clase CartCalculatorTest. Devuelve pase/fallo por método con mensajes de fallo.✓ Copiado

→ Resultado de prueba estructurado
Corrige fallos

Para cada prueba fallida, lee la fuente, identifica el bug, propón una corrección mínima.✓ Copiado

→ Archivo:línea + cambio propuesto
Bucle

Aplica la corrección y re-ejecuta hasta estar en verde. No modifiques las pruebas, solo el código de producción.✓ Copiado

→ Todas las pruebas pasando

Resultado: TDD a velocidad de agente con la infraestructura de compilación y ejecución del IDE.

Errores comunes

El agente modifica las pruebas para que pasen — Prompt explícito: 'no toques archivos de prueba'; revisa el diff antes de hacer commit

Incorporarse a una base de código desconocida a través de navegación del IDE

👤 Nuevos empleados, revisores de código ⏱ ~30 min beginner

Cuándo usarlo: Necesitas entender cómo se usa X sin saltar entre 20 archivos manualmente.

Flujo

Comienza en un punto de entrada

Busca el controlador HTTP para POST /checkout. Muéstrame la jerarquía de llamadas — qué llama, profundidad 3.✓ Copiado

→ Árbol de llamadas con nodos archivo:línea
Encuentra pruebas

Busca todas las pruebas que ejercitan el flujo de checkout. Abre cada una y resume lo que cubren.✓ Copiado

→ Mapa de cobertura de pruebas
Explica el flujo

Escribe un explicador de 1 página: endpoint → validación → pago → persistencia → respuesta. Referencia archivos con números de línea.✓ Copiado

→ Explicador de calidad de incorporación

Resultado: Un modelo mental concreto de un subsistema en 30 minutos en lugar de un día.

Errores comunes

El agente inventa nombres de clase/método que no existen — Cada afirmación debe vincularse a archivo:línea — si no puede, está alucinado; llámalo y vuelve a consultar

Combinar con: git

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

jetbrains + git

Refactor a nivel IDE + verifica que el commit esté limpio

Renombra fetchUser a loadUser en todo el proyecto. Luego muéstrame el diff de git — confirma que las pruebas aún pasan e haz commit.✓ Copiado

jetbrains + github

Revisar un PR con navegación del IDE en lugar de la interfaz web de GitHub

Revisa la rama del PR #234. Recorre el diff usando find_usages para entender desde dónde se llama cada método cambiado.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
get_project_structure		Vista general cuando comienzas en un nuevo proyecto	gratuito
find_usages	symbol	Análisis de impacto antes de cambios	gratuito
search_in_files	text, scope?	Búsqueda de texto completo en todo el proyecto	gratuito
get_symbol_info	symbol or file:line	Resuelve qué es algo	gratuito
run_configuration	config_name	Ejecuta una configuración de ejecución guardada (prueba, aplicación, script)	gratuito (local)
apply_refactoring	refactor type + params	Renombrar, extraer método, inline, mover	gratuito
get_diagnostics	file_path?	Captura problemas que el IDE ya conoce	gratuito

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — IDE local
Tokens por llamada: Las jerarquías de llamadas pueden ser grandes; limita la profundidad explícitamente
Monetario: Gratuito — MCP es gratuito; de todas formas necesitas una licencia de JetBrains
Consejo: Usa operaciones del IDE (find_usages, refactor) en lugar de lecturas del sistema de archivos en bruto — tokens más baratos y más precisos

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno — IDE local

Salida de datos: Ninguno a JetBrains; MCP es solo localhost entre IDE y cliente

El paquete npm JetBrains/mcp-jetbrains está deprecado — desde IDE 2025.2, la funcionalidad del servidor MCP está integrada. Prefiere la versión integrada si estás en una versión reciente.

Resolución de problemas

Errores comunes y soluciones

Conexión rechazada / MCP no puede alcanzar el IDE

El IDE debe estar abierto con el plugin habilitado. Comprueba Configuración → Herramientas → MCP Server; el puerto suele ser 63342 o se asigna automáticamente.

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

Las herramientas devuelven 'Proyecto no encontrado'

Ningún proyecto abierto en el IDE, o múltiples proyectos abiertos y el agente está preguntando sobre el incorrecto. Enfoca la ventana correcta.

El refactor reporta archivos cambiados pero se ven iguales

Los búferes del IDE aún no se han guardado en disco. Llama a una herramienta 'guardar todo' o Cmd+S en el IDE.

find_usages pierde referencias

La indexación no ha completado. Espera a que la barra de estado del IDE muestre 'Indexación completada'.

Alternativas

JetBrains IDEs vs otros

Alternativa	Cuándo usarla	Contrapartida
VSCode MCP (varios de la comunidad)	Estás en VSCode en lugar de JetBrains	IDE diferente, ecosistema diferente — no es un cambio directo
MCPs de servidor de lenguaje	Quieres inteligencia de código agnóstica de IDE a través de LSP	LSP proporciona información de símbolo básica pero no refactoring o configuraciones de ejecución

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills