/ 디렉터리 / 플레이그라운드 / JetBrains IDEs
← 모든 서버 ↗ GitHub
● 공식 JetBrains ⚡ 바로 사용

JetBrains IDEs

제작: JetBrains · JetBrains/mcp-jetbrains

에이전트에게 IntelliJ와 동일한 코드 인텔리전스 기능을 제공하세요 — 리팩토링, 사용처 찾기, 검사, 실행 구성.

공식 JetBrains MCP 프록시입니다. IDE(IntelliJ, PyCharm, WebStorm, Rider 등)에 설치된 MCP Server 플러그인과 연동됩니다. 에이전트는 파일시스템이 아닌 IDE의 인덱싱된 모델을 통해 프로젝트 구조를 봅니다. 따라서 리팩토링, 사용처 찾기, 검사가 모두 작동합니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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는 맵이 아닌 서버 오브젝트 배열 사용.

~/.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

전체 프로젝트에서 심볼을 안전하게 이름 변경

👤 Java / Kotlin / Python / C# 엔지니어 ⏱ ~10 min intermediate

언제 쓸까: 심볼의 이름을 변경하고 싶지만 grep-and-replace로는 문자열 참조나 동적 호출을 놓칠 수 있을 때

사전 조건
  • IDE에 설치된 MCP Server 플러그인 — plugins.jetbrains.com/plugin/26071-mcp-server — 또는 2025.2 이상이면 기본 제공
  • IDE에서 프로젝트를 열고 인덱싱된 상태 — 프로젝트를 열고 인덱싱이 완료될 때까지 대기하세요(상태 표시줄)
흐름
  1. 심볼 찾기
    getCurrentUser의 정의와 프로젝트 내 모든 사용 위치를 찾으세요. 테스트 파일을 포함하세요.✓ 복사됨
    → IDE 정확도의 사용처 목록(file:line 포함)
  2. 리네임 사전 검토
    getAuthenticatedUser로 이름을 변경하면 무엇이 바뀌는지 보여주세요. 수동으로 수정해야 할 문자열 리터럴이나 리플렉션 기반 호출에 플래그를 지정하세요.✓ 복사됨
    → 미리보기 diff + 수동 수정 목록
  3. 리팩토링 적용
    이름 변경을 적용하세요. 그 다음 영향을 받는 테스트를 실행하세요.✓ 복사됨
    → 리팩토링 완료, 테스트 통과

결과: IDE 수준의 정확도로 안전한 이름 변경이 가능하며, IDE의 기존 리팩토링 엔진으로 지원됩니다.

함정
  • 리플렉션 기반 또는 문자열로 구성된 참조가 감지되지 않음 — 리팩토링 후 old name을 문자열로 grep하세요. IDE는 경고하지만 자동으로 수정하지 않습니다
  • IDE가 완전히 인덱싱되지 않아 결과가 부분적임 — 실행하기 전에 진행률 표시줄이 사라질 때까지 기다리세요. 먼저 IDE에 인덱스 상태를 확인하세요
함께 쓰기: git

특정 테스트를 실행하고 실패에 대해 반복

👤 JetBrains IDE를 사용하는 모든 엔지니어 ⏱ ~15 min intermediate

언제 쓸까: 에이전트가 코드를 작성하고, 일치하는 테스트를 실행하고, 실패를 수정하고, 반복하기를 원할 때 — 채팅을 떠나지 않고

사전 조건
  • IDE에 테스트에 대한 실행 구성이 존재함 — 테스트 파일 우클릭 → 실행 — IDE가 구성을 저장합니다
흐름
  1. 특정 테스트 실행
    CartCalculatorTest 클래스를 실행하세요. 실패 메시지와 함께 메서드별 통과/실패를 반환하세요.✓ 복사됨
    → 구조화된 테스트 결과
  2. 실패 수정
    실패한 각 테스트에 대해 소스를 읽고, 버그를 식별하고, 최소 수정을 제안하세요.✓ 복사됨
    → File:line + 제안된 변경
  3. 반복
    수정을 적용하고 통과할 때까지 다시 실행하세요. 테스트를 수정하지 말고 프로덕션 코드만 수정하세요.✓ 복사됨
    → 모든 테스트 통과

결과: IDE의 컴파일 + 실행 인프라를 이용한 에이전트 속도의 TDD가 가능합니다.

함정
  • 에이전트가 테스트를 수정하여 통과시킴 — 명시적 프롬프트: '테스트 파일을 건드리지 마세요'; commit 전에 diff를 검토하세요

IDE 네비게이션을 통해 낯선 코드베이스에 온보딩

👤 신입 사원, 코드 리뷰어 ⏱ ~30 min beginner

언제 쓸까: 20개 파일을 수동으로 이동하지 않고 X가 어떻게 사용되는지 이해해야 할 때

흐름
  1. 진입점에서 시작
    POST /checkout의 HTTP 핸들러를 찾으세요. 호출 계층 구조를 보여주세요 — 호출하는 항목, 깊이 3.✓ 복사됨
    → file:line 노드가 있는 호출 트리
  2. 테스트 찾기
    checkout flow를 다루는 모든 테스트를 찾으세요. 각각을 열고 어떤 것을 다루는지 요약하세요.✓ 복사됨
    → 테스트 커버리지 맵
  3. flow 설명
    1페이지 설명자를 작성하세요: endpoint → validation → payment → persistence → response. 라인 번호와 함께 파일을 참조하세요.✓ 복사됨
    → 온보딩 품질의 설명서

결과: 하루 대신 30분 안에 서브시스템의 구체적인 정신 모델을 구축할 수 있습니다.

함정
  • 에이전트가 존재하지 않는 클래스/메서드 이름을 만듦 — 모든 주장은 file:line에 링크되어야 합니다. 그렇지 않으면 허구입니다. 지적하고 다시 쿼리하세요
함께 쓰기: git

조합

다른 MCP와 조합해 10배 효율

jetbrains + git

IDE 수준 리팩터 + commit이 깨끗한지 검증

fetchUser를 프로젝트 전체에서 loadUser로 이름을 변경하세요. 그 다음 git diff를 보여주세요 — 테스트가 여전히 통과하고 commit하는지 확인하세요.✓ 복사됨
jetbrains + github

GitHub의 웹 UI 대신 IDE 네비게이션으로 PR 검토

PR #234의 branch를 checkout하세요. find_usages를 사용하여 diff를 살펴보고 각 변경된 메서드가 어디에서 호출되는지 이해하세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
get_project_structure 새 프로젝트를 시작할 때 개요 무료
find_usages symbol 변경 전 영향 분석 무료
search_in_files text, scope? 전체 프로젝트에 걸친 전체 텍스트 검색 무료
get_symbol_info symbol or file:line 무엇인지 해결 무료
run_configuration config_name 저장된 실행 구성 실행(테스트, 앱, 스크립트) 무료(로컬)
apply_refactoring refactor type + params 이름 변경, 메서드 추출, 인라인, 이동 무료
get_diagnostics file_path? IDE가 이미 알고 있는 문제 포착 무료

비용 및 제한

운영 비용

API 쿼터
없음 — 로컬 IDE
호출당 토큰
호출 계층 구조는 클 수 있습니다. 깊이를 명시적으로 제한하세요.
금액
무료 — MCP는 무료입니다. 어쨌든 JetBrains 라이선스가 필요합니다
팁
원시 파일시스템 읽기보다 IDE 작업(find_usages, refactor)에 의존하세요. 토큰 비용이 적게 들고 더 정확합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 없음 — 로컬 IDE
데이터 외부 송신: JetBrains로의 송신 없음; MCP는 IDE와 클라이언트 간 localhost 전용

문제 해결

자주 발생하는 오류와 해결

연결 거부 / MCP가 IDE에 도달할 수 없음

IDE는 플러그인이 활성화된 상태로 열려 있어야 합니다. 설정 → 도구 → MCP Server에서 확인하세요. 포트는 보통 63342이거나 자동 할당됩니다.

확인: curl http://localhost:63342/api/mcp
도구가 '프로젝트를 찾을 수 없음' 반환

IDE에서 열려 있는 프로젝트가 없거나, 여러 프로젝트가 열려 있고 에이전트가 잘못된 프로젝트를 묻고 있습니다. 올바른 창에 포커스하세요.

리팩터가 파일 변경을 보고하지만 동일하게 보임

IDE 버퍼가 아직 디스크에 저장되지 않았습니다. IDE에서 '모두 저장' 도구를 호출하거나 Cmd+S를 누르세요.

find_usages가 참조를 놓침

인덱싱이 완료되지 않았습니다. IDE 상태 표시줄에 '인덱싱 완료'가 표시될 때까지 기다리세요.

대안

JetBrains IDEs 다른 것과 비교

대안언제 쓰나단점/장점
VSCode MCP(다양한 커뮤니티)JetBrains 대신 VSCode를 사용 중임다른 IDE, 다른 생태계 — 직접 교체 불가
language-server MCPsLSP를 통해 IDE 독립적인 코드 인텔리전스를 원함LSP는 기본 심볼 정보만 제공하고 리팩토링이나 실행 구성은 제공하지 않습니다

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기