Intellij + Claude 를 MCP 로 연동하기 (+ MCP 알아보기)

1. MCP(Model Context Protocol)??

MCP (Model Context Protocol) 는 AI 에이전트와 다양한 시스템에 연결하는 USB-C 포트와 같은 오픈소스 표준 프로토콜이다. (참고로 Antropic(엔트로픽) 에서 처음 도입하였다.)

 

그렇다면 표준화를 하는 이유는 무엇일까?

 

표준화란 모두가 똑같이 따라야 하는 규칙이나 방식을 정의하는 행위를 의미한다.

통신 규약을 정의함으로써 서로 다른 시스템이라도 같은 표준을 따르면 다른 시스템으로 변경하기 용이하다.

즉, 호환성을 향상시킬 수 있다.

 

또한 이미 정해진 규칙에 따라 작업할 수 있어 시간과 비용을 절약하기 때문에 효율성과 생산성을 증가할 수 있다.

 

MCP 에 대입해서 정리하자면 AI 모델과 도구 사이를 MCP 로 표준화하여
다양한 데이터 소스와 도구를 효율적으로 연동할 수 있고, - (효율성, 생산성)
다른 AI 모델 또는 도구로 변경하기 용이하게 하기 위한 프로토콜이다. - (호환성)

 

 

2. MCP(Model Context Protocol) 이 도입된 이유?

• 개별 통합 방식으로 인한 낮은 AI 모델 생산성 :
  • 기존 AI 모델은 외부 데이터나 도구에 접근할 때마다 개별적인 통합 방식을 구현해야 했다.
  • 각 서비스마다 다른 API, 인증 방식, 데이터 형식을 사용하다 보니 개발 복잡성이 증가하고 생산성 저하를 야기했다.
  • 이와 같은 생산성과 호환성을 해결하기 위해 AI 에이전트와 외부 시스템 연결에 관한 표준화가 필요했다.
• 보안 취약점
  • 기존의 AI 모델이 외부 도구에 접근하려면 사용자 데이터에 접근하기 위해서는 보안, 프라이버시, 인증이 중요하다.
  • 하지만 기존의 방식은 도구마다 다른 방식을 채택하고 있어 취약점이 통일성이 없었다.
  • 이를 해결하기 위해서 일관된 접근 제어, 사용자 동의, 감사 로그 등의 보안 메커니즘에 관한 표준화가 필요했다.

 

 

3. MCP client-server 모델에서 3가지 컴포넌트

MCP 는 client-server 모델을 기반하며 구조는 아래 그림과 같이 동작한다.

• Host (호스트)
  • Claude 와 같은 AI 애플리케이션을 말하며, AI 가 다양한 도구나 데이터 소스에 접근할 수 있는 환경을 제공한다.
  • 호스트는 MCP 클라이언트를 실행한다.
• MCP Client (클라이언트)
  • Claude 같은 AI 모델 내부에 존재하며, MCP 서버와 통신할 수 있도록 해주는 구성 요소이다.
  • 예를 들어 Claude 가 PostgreSQL 데이터가 필요하면 MCP 클라이언트는 해당 요청을 구조화된 메시지로 변환해 MCP 서버로 전송한다.
• MCP Server (서버)
  • Claude 같은 AI 모델이 PostgreSQL, Google Drive, 기타 API 등 외부 시스템에 연결할 수 있도록 중개자 역할을 한다.

[bytebytego] What is MCP : https://blog.bytebytego.com/p/ep154-what-is-mcp

 

 

4. Intellij 와 Claude 를 MCP 로 연동하기

(1) Claude Desktop App 설치

• MCP 호스트와 클라이언트 역할은 Claude Desktop App 을 설치한다.

 

(2) jetbrains MCP 서버 플러그인 설치

1. Intellij > Settings > Jetrbrains IDE 전용 MCP 서버 플러그인 설치한다.

 

(3) claude_desktop_config.json 수정

1. claude desktop 실행 > mac 기준 claude > 설정 (cmd + ,) > 개발자 탭 > 로컬 MCP 서버 구성 편집 클릭한다.

 

2. claude_desktop_config.json 파일에 JetBrains 제공 MCP Proxy Server 설정을 추가해준다.

(자세한 내용은 JetBrains/mcp-jetbrains github repository 를 확인해보자.)

 

(4) claude desktop + intellij 연동 확인하기

1. 설정이 완료되면 꼭 Intellij IDE 와 claude desktop 을 재시작하고, jetbranins mcp server 연결 확인 + claude desktop 으로  intellij 접근 여부 확인하기

 

 

 

5. [🪏삽질] Intellij 와 Claude Desktop 를 MCP 로 연동해도 동작하지 않을 경우

Jetbrains mcp server 와 Claude Desktop 을 연동했음에도 intellij 에 접근할 수 없는 문제가 발생했다.

 

 

Jetbrains repository issue 을 확인해보니 node version 이슈였다. 로컬에 설치된 nvm 18 미만 버전이 존재하면 접근하지 않는 문제가 발생하므로 nvm 18 미만 버전을 제거한 후 최신 LTS 버전으로 설정해서 해결되었다.

# 1. 최신 lts version 설치
$ nvm install --lts

# 2. 최신 lts version 사용
$ nvm use --lts

# 3. 18버전 이하 nvm 버전 삭제
$ nvm ls

       v16.15.0
       v18.13.0
       v20.17.0
->     v22.18.0
        v24.3.0
        
$ nvm uninstall v16.15.0

 

 

Reference

• [bytebytego] What is MCP? : https://blog.bytebytego.com/p/ep154-what-is-mcp
• [anthropic] Introducing the Model Context Protocol : https://www.anthropic.com/news/model-context-protocol
• [wikipedia] Model Context Protocol : https://en.wikipedia.org/wiki/Model_Context_Protocol?utm_source=chatgpt.com
• [JetBrains github] Claude Can't Connect : https://github.com/JetBrains/mcp-jetbrains/issues/44