[MCP] Claude + IntelliJ IDEA 2025.2.4 (Ultimate Edition) 연동

1. 서론

최근 MCP 가 개발 업계에서 매우 핫하다. 필자의 경우 Gemini 유료 구독 (3.1 Pro Model) 를 사용하여 개발을 했으나, 프롬프트에 단순히 입력하고 답변받는 구조에 지쳤다. 그래서 Claude 로 갈아타서 MCP 서버 구성을 진행해보고자 하였고 그 중 IntelliJ 연동을 첫번째로 진행하였다. 이에 관한 내용이다.

 

2. 본론

2.1. MCP 란?

`MCP(Model Context Protocol)` 는 AI 를 외부 시스템에 연결하기 위한 일종의 프로토콜이다. 우리가 흔히 얘기하던 HTTP 프로토콜과 같이 AI 를 다른 응용프로그램이나 서버에 연동하는 프로토콜이다.

 

MCP를 사용하면 Claude나 ChatGPT와 같은 AI 를 단순히 프롬프트를 웹에서 입력하고 답변 받는것이 아닌, 로컬에 있는 파일에 접근 가능하게끔 할 수 있어 일일이 복붙을 안해도 된다. 뿐만 아니라, 다른 서버에 연동 (ex. Slack, Gmail 등) 하여 업무를 시킬 수 도 있다.

 

더 자세한 내용은 공식문서를 확인하면 이해할 수 있다.

https://modelcontextprotocol.io/docs/getting-started/intro

What is the Model Context Protocol (MCP)? - Model Context Protocol

 

2.2. Claude Desktop 설치

https://claude.com/download

Download Claude | Claude

 

공식 홈페이지에서 해당하는 OS 에 맞게 설치하면 된다.

 

2.3. IntelliJ Plugin MCP Server 설치

Claude 에서 IntelliJ 에 연동을 하려면 `MCP Server` 플러그인을 설치해야 한다.

 

IntelliJ 상에서 다음과 같이 입력해 Setting > Plugins 창을 연다.

# 윈도우
Ctrl + Alt + S

# 맥
Command +

 

상단에 MCP Server 를 입력하여 해당 플러그인을 설치한다.

 

해당 플러그인을 설치하면 Settings 왼쪽 탭에 MCP Server 가 생긴걸 확인할 수 있다.

`Enable MCP Server` 체크 > Clients Auto-Configuration 하위 Claude App `Auto-Configure` 클릭

하면 오른쪽에 초론색 체크표시가 뜬다. 이러면 사실상 연동이 끝이다.

 

이전 레거시 IntelliJ 의 경우 자동으로 claude_desktop_config.json 업데이트가 안된다고 알고있다.
해당 방법으로 되지 않을 경우, 수동으로 json 파일을 수정해줘야 한다.

 

2.4. MCP 연동 확인 방법

연동을 확인하는 방법은 `Claude Desktop` 앱 상에서 확인 가능하다.

왼쪽 하단 설정 >  커넥터 > 연동된 환경 확인 가능하다.

 

2.5. 연동안됨?

처음엔 상기 내용으로 했을 때 연동이 되지 않았다.

여러 글들을 보니, 왼쪽 하단 설정 >  개발자 > 구성 편집 을 눌러 ` claude_desktop_config.json` 을 확인해보라고 했다.

 

필자의 경우 애초에 AppData\Roaming\Claude 경로가 없다고 떴다.

종종 이런일이 발생할 수 있다고 한다. 이럴땐 그냥 삽질하지 말고 지웠다가 다시 설치하면 자동으로 해당 경로에 파일이 생성된다.

 

연동이 잘 되면, 실제로 설정 json 파일에 다음과 같이 자동으로 jetbrains mcpServers 설정이 들어가 있어야 한다.

 

이제 연동 잘 됐는지 실제로 프롬프트를 넣어보면 프로젝트를 읽어 분석하고 답변해주는걸 확인할 수 있다.