JetBrains IDE와 Claude Desktop MCP 서버 연동 가이드

by · 2025년 3월 12일

 

개발 생산성을 향상시키는 방법을 항상 고민하는 개발자라면, JetBrains IDE와 Claude Desktop MCP(Model Control Protocol) 서버의 연동은 게임체인저가 될 수 있습니다. 이 가이드에서는 두 강력한 도구를 연결하여 AI 기반 코드 어시스턴트의 힘을 여러분의 개발 환경에 통합하는 방법을 단계별로 알려드립니다.

 

준비 사항

시작하기 전에 다음 항목이 준비되어 있는지 확인하세요:

  • JetBrains IDE(IntelliJ IDEA, PyCharm, WebStorm 등) 최신 버전
  • Claude Desktop 애플리케이션 설치
  • 안정적인 인터넷 연결
  • Claude 계정

 

Claude Desktop 설치 및 설정

1단계: Claude Desktop 다운로드 및 설치

  1. Claude Desktop 공식 웹사이트에서 운영체제에 맞는 버전을 다운로드합니다.
  2. 다운로드한 설치 파일을 실행하고 화면의 지시에 따라 설치를 완료합니다.
  3. 설치가 완료되면 애플리케이션을 실행합니다.

2단계: Claude 계정 로그인 및 설정

  1. Claude Desktop을 실행하고 Anthropic 계정으로 로그인합니다.
  2. 설정(⚙️) 메뉴로 이동하여 개인 설정을 확인합니다.
  3. 필요에 따라 사용자 인터페이스 언어 및 테마를 조정합니다.

3단계: MCP 서버 설정 구성

JetBrains와의 연동을 위해 Claude Desktop의 설정 파일을 수정해야 합니다:

  1. 텍스트 편집기를 사용하여 다음 경로에 있는 설정 파일을 엽니다:
    • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
  2. 파일에 다음 내용을 추가합니다: 
    {
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}
  1. 파일을 저장하고 Claude Desktop을 재시작합니다.

이 설정은 JetBrains IDE와 Claude Desktop 사이에 MCP 프록시 서버를 자동으로 시작하도록 합니다. 이제 MCP 서버가 자동으로 실행되어 JetBrains IDE와 통신할 준비가 완료됩니다.

4단계: 고급 MCP 서버 구성

여러 JetBrains IDE를 동시에 사용하거나 Obsidian과 같은 다른 도구를 추가하려면 다음과 같이 더 복잡한 설정을 구성할 수 있습니다:

{
  "mcpServers": {
    "pycharm": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"],
      "env": {
        "IDE_PORT": "63342",
        "HOST": "127.0.0.1",
        "LOG_ENABLED": "true"
      }
    },
    "webstorm": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"],
      "env": {
        "IDE_PORT": "63343",
        "HOST": "127.0.0.1",
        "LOG_ENABLED": "true"
      }
    },
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/Users/username/Documents/ObsidianVault"
      }
    }
  }
}

주의사항:

  • OBSIDIAN_VAULT_PATH를 자신의 Obsidian 저장소 경로로 변경해야 합니다
  • 여러 JetBrains IDE를 사용할 경우 각각 다른 포트 번호를 지정해야 합니다
  • 로그를 활성화하면 문제 해결에 도움이 되지만 프로덕션 환경에서는 비활성화하는 것이 좋습니다

 

JetBrains IDE 플러그인 설치

MCP Server 플러그인 설치

  1. JetBrains IDE를 실행합니다.
  2. File > Settings(Windows/Linux) 또는 IntelliJ IDEA > Preferences(macOS)로 이동합니다.
  3. 왼쪽 패널에서 Plugins를 선택합니다.
  4. 마켓플레이스 탭에서 “MCP Server”를 검색합니다.
  5. ‘설치’ 버튼을 클릭하고 IDE를 재시작합니다.

 

플러그인 설치가 완료되면 자동으로 MCP 서버와 연결할 준비가 됩니다. 대부분의 경우 추가 구성이 필요하지 않습니다.

 

연동 테스트 및 확인

JetBrains IDE에 MCP Server 플러그인을 설치하고 Claude Desktop에서 MCP 서버를 활성화한 후, 연동이 제대로 작동하는지 확인해 보겠습니다.

기본 연동 테스트

  1. JetBrains IDE에서 코드 파일을 열거나 새로 만듭니다.
  2. 다음 방법 중 하나로 Claude를 호출합니다:
    • 단축키: Ctrl+Shift+C(Windows/Linux) 또는 Cmd+Shift+C(macOS)
    • 마우스 오른쪽 버튼 클릭 메뉴에서 ‘Ask Claude’ 선택
    • 툴바의 Claude 아이콘 클릭
  3. 프롬프트 입력 필드에 “이 코드를 최적화해 줄래?”와 같은 질문을 입력합니다.
  4. ‘Send’ 버튼을 클릭하거나 Enter 키를 누릅니다.

 

고급 설정 및 커스터마이징

커스텀 프롬프트 템플릿 설정

IDE의 Claude MCP 설정에서 다음과 같은 상황별 템플릿을 추가할 수 있습니다:

// 코드 설명 템플릿
다음 {{language}} 코드를 명확하게 설명해 주세요:
// 코드 설명 템플릿
다음 {{language}} 코드를 명확하게 설명해 주세요:
// 코드 설명 템플릿
다음 {{language}} 코드를 명확하게 설명해 주세요:

프로젝트별 설정

다양한 프로젝트에 대해 다른 설정을 사용할 수 있습니다:

  1. 프로젝트 루트 디렉토리에 .claude-config.json 파일을 생성합니다.
  2. 다음과 같이 프로젝트별 설정을 구성합니다:
{
  "model": "claude-3-7-sonnet-20250219",
  "temperature": 0.7,
  "maxTokens": 4000,
  "contextLimit": 15000,
  "defaultLanguage": "python",
  "templateOverrides": {
    "codeReview": "다음 {{language}} 코드를 리뷰하고 개선점을 제안해 주세요:"
  }
}

 

문제 해결 가이드

연결 문제

문제: IDE에서 “MCP 서버에 연결할 수 없음” 오류가 발생합니다.

해결책:

  1. Claude Desktop에서 MCP 서버가 실행 중인지 확인합니다.
  2. 포트 번호가 IDE 설정과 일치하는지 확인합니다.
  3. 로컬 방화벽이 해당 포트를 차단하고 있지 않은지 확인합니다.
  4. localhost 대신 127.0.0.1을 사용해 보세요.

성능 문제

문제: Claude의 응답이 느리거나 시간이 초과됩니다.

해결책:

  1. 네트워크 연결을 확인합니다.
  2. Claude Desktop 애플리케이션에 충분한 시스템 리소스가 할당되어 있는지 확인합니다.
  3. 입력 프롬프트의 크기를 줄이거나 더 적은 코드를 선택합니다.
  4. config.json에서 타임아웃 설정을 늘립니다:
{
  "mcp": {
    "requestTimeout": 120000  // 120초로 설정
  }
}

 

유용한 사용 사례

1. 코드 리뷰 자동화

코드 리뷰 프로세스를 향상시키기 위해 Claude를 사용할 수 있습니다:

  1. 변경된 코드를 선택합니다.
  2. 마우스 오른쪽 버튼 클릭 메뉴에서 ‘Review with Claude’를 선택합니다.
  3. Claude가 제공하는 코드 리뷰 피드백을 검토합니다.
  4. 필요한 수정 사항을 적용합니다.

2. 문서 생성

코드에 대한 문서를 자동으로 생성할 수 있습니다:

  1. 문서화할 함수나 클래스를 선택합니다.
  2. ‘Generate Documentation with Claude’를 선택합니다.
  3. Claude가 생성한 문서 문자열이나 설명을 검토합니다.
  4. 필요에 따라 조정하고 코드에 통합합니다.

3. IDE와 Obsidian 간 통합 문서 작업

다중 도구 설정의 강력한 장점을 활용한 통합 문서 작업 흐름:

  1. IDE에서 API 구현 코드를 선택합니다.
  2. ‘Generate API Documentation with Claude’를 선택합니다.
  3. 생성된 문서를 검토한 후 “Save to Obsidian” 옵션을 사용합니다.
  4. Claude가 자동으로 API 문서를 Obsidian 저장소의 적절한 위치에 저장합니다.

 

결론

JetBrains IDE와 Claude Desktop MCP 서버를 연동함으로써, 개발 워크플로우에 강력한 AI 기반 코드 어시스턴트를 통합할 수 있습니다. 이 조합은 코드 품질을 향상시키고, 반복적인 작업을 자동화하며, 새로운 기술이나 프레임워크를 더 빠르게 학습하는 데 도움을 줍니다.

이 가이드에서 설명한 단계를 따르면 두 도구를 원활하게 연결하고, 개발 생산성을 크게 향상시킬 수 있습니다. 연동 과정에서 문제가 발생하면 문제 해결 섹션을 참조하거나 각 도구의 공식 문서를 확인하세요.

참고: 이 가이드는 2025년 3월 기준 최신 정보를 바탕으로 작성되었습니다. 소프트웨어 업데이트로 인해 일부 단계나 설정이 변경될 수 있으므로, 최신 공식 문서를 항상 확인하세요.

Post Views: 1
소셜 미디어로 공유하기

Tags:

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

This site uses Akismet to reduce spam. Learn how your comment data is processed.