IntelliJ IDEs에서 MCP를 사용하는 방법 (2026)

2026년 IntelliJ IDE에서 MCP를 사용하는 방법

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결되는 표준 방식으로 빠르게 자리 잡았습니다. 대부분의 MCP 가이드는 VS Code와 Claude Desktop에 초점을 맞추고 있지만, JetBrains IDE(IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider 등)도 이제 견고한 MCP 지원을 제공합니다. 이 가이드에서는 JetBrains IDE에서 MCP 서버를 설정하여 AI 어시스턴트가 에디터 내에서 데이터베이스, API, 프로젝트 관리 도구 등과 직접 상호작용할 수 있도록 하는 방법을 안내합니다.

MCP란 무엇인가요?

Model Context Protocol은 Anthropic에서 개발한 오픈 표준으로, AI 모델과 외부 도구 사이의 범용 인터페이스를 제공합니다. 모든 도구-AI 조합에 대해 커스텀 통합 기능을 빌드하는 대신, MCP는 모든 AI 클라이언트가 모든 MCP 서버와 통신하는 데 사용할 수 있는 공통 프로토콜을 정의합니다.

MCP 서버는 tools(AI가 취할 수 있는 작업), resources(AI가 읽을 수 있는 데이터), 그리고 prompts(사전 빌드된 템플릿)를 노출합니다. 예를 들면 다음과 같습니다:

GitHub MCP server: AI가 issue를 읽고, PR을 생성하며, 코드를 리뷰할 수 있게 합니다.
database MCP server: AI가 데이터베이스를 쿼리하고 스키마를 설명할 수 있게 합니다.
Jira MCP server: AI가 티켓을 읽고 상태를 업데이트할 수 있게 합니다.

사전 요구 사항

JetBrains IDE에서 MCP를 설정하기 전에 다음 사항을 확인하세요:

활성 라이선스가 있는 JetBrains IDE (2025.1 이상 버전)
Node.js 18+ 설치 (대부분의 MCP 서버는 Node 기반입니다)
AI Assistant plugin 활성화 (JetBrains IDE에 기본 포함되어 있음)
JetBrains AI 구독 또는 호환 가능한 AI 플러그인

IDE 버전을 확인하세요:

Help > About (Windows/Linux)
IntelliJ IDEA > About IntelliJ IDEA (macOS)

1단계: AI Assistant 활성화

JetBrains AI Assistant는 JetBrains IDE 내의 주요 MCP 클라이언트입니다.

Settings를 엽니다 (macOS는 Cmd+,, Windows/Linux는 Ctrl+Alt+S)
Plugins로 이동합니다
**"AI Assistant"**를 검색합니다
설치 및 활성화 여부를 확인합니다
메시지가 표시되면 IDE를 재시작합니다

재시작 후 오른쪽 사이드바에 AI Assistant 도구 창이 나타나야 합니다.

2단계: MCP 서버 구성

JetBrains IDE는 프로젝트 내부의 JSON 파일 또는 전역 설정을 통해 MCP 서버 구성을 지원합니다.

프로젝트 수준 구성

프로젝트 루트에 .jb-mcp.json 파일을 생성합니다:

{
  "servers": [
    {
      "name": "filesystem",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/directory"]
    },
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  ]
}

전역 구성

모든 프로젝트에서 사용하려는 MCP 서버의 경우 JetBrains 설정 디렉토리에 구성을 생성합니다:

# macOS
~/Library/Application Support/JetBrains/IntelliJIdea2025.2/mcp.json

# Linux
~/.config/JetBrains/IntelliJIdea2025.2/mcp.json

# Windows
%APPDATA%\JetBrains\IntelliJIdea2025.2\mcp.json

형식은 프로젝트 수준 구성과 동일합니다.

UI를 통한 구성

IDE 설정을 통해서도 MCP 서버를 구성할 수 있습니다:

Settings (Cmd+, / Ctrl+Alt+S)를 엽니다
Tools > AI Assistant > MCP Servers로 이동합니다
+ 버튼을 클릭하여 새 서버를 추가합니다
서버 세부 정보를 입력합니다:
- Name: 식별 가능한 이름
- Command: 서버를 시작하는 명령 (예: npx)
- Arguments: 명령 인자
- Environment Variables: 필요한 환경 변수

3단계: 인기 있는 MCP 서버 설정

GitHub MCP 서버

IDE의 AI를 GitHub 저장소에 연결하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

github.com/settings/tokens에서 repo 스코프를 가진 GitHub 토큰을 생성하세요.

가능한 작업:

"현재 변경 사항에 대한 PR 생성해 줘"
"나에게 할당된 열린 issue가 뭐야?"
"이 저장소의 최신 PR을 리뷰해 줘"

Database MCP 서버 (PostgreSQL)

AI가 데이터베이스 스키마를 쿼리하고 이해하도록 합니다:

{
  "servers": [
    {
      "name": "postgres",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://user:password@localhost:5432/mydb"]
    }
  ]
}

가능한 작업:

"users 테이블의 스키마를 보여줘"
"지난 30일 이내에 가입한 사용자를 찾는 쿼리를 작성해 줘"
"orders 테이블과 products 테이블 간의 관계를 설명해 줘"

Filesystem MCP 서버

AI에게 특정 디렉토리에 대한 읽기 권한을 부여합니다:

{
  "servers": [
    {
      "name": "docs",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "./docs", "./README.md"]
    }
  ]
}

Slack MCP 서버

팀 대화의 컨텍스트를 위해 Slack을 연결하세요:

{
  "servers": [
    {
      "name": "slack",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  ]
}

4단계: AI Chat에서 MCP 도구 사용하기

MCP 서버가 구성되고 실행되면, JetBrains IDE의 AI Assistant가 서버에서 노출하는 도구들을 사용할 수 있습니다.

대화 시작하기

AI Assistant 패널을 엽니다 (오른쪽 사이드바)
새 채팅을 시작합니다
AI가 사용 가능한 MCP 도구를 자동으로 검색합니다

상호작용 예시

사용자: 우리 GitHub 저장소에 열린 issue가 뭐야?

AI: [github MCP 도구 사용: list_issues]
열린 issue 12개를 찾았습니다. 가장 최근 항목은 다음과 같습니다:
- #145: 인증 타임아웃 수정 (@alice 담당)
- #143: 대시보드 레이아웃 업데이트 (담당자 없음)
- #140: 스테이징에서 데이터베이스 마이그레이션 실패 (@bob 담당)
...

사용자: payments 테이블의 스키마를 보여주고 느린 쿼리를 위한 인덱스를 추천해 줘.

AI: [postgres MCP 도구 사용: query]
payments 테이블의 스키마는 다음과 같습니다:
- id (uuid, primary key)
- user_id (uuid, users 테이블 외래 키)
- amount (decimal)
- status (varchar)
- created_at (timestamp)

일반적인 쿼리 패턴을 기반으로, 사용자의 최근 결제 내역을 조회하는 쿼리를 위해 (user_id, created_at DESC) 인덱스 추가를 추천합니다:

CREATE INDEX idx_payments_user_created ON payments (user_id, created_at DESC);

5단계: 문제 해결

MCP 서버가 시작되지 않음

IDE 외부에서 서버 명령이 작동하는지 확인하세요:

# 명령을 직접 테스트
npx -y @anthropic/mcp-server-github

# Node.js 접근 가능 여부 확인
node --version
npx --version

서버는 시작되지만 도구가 나타나지 않음

Settings > Tools > AI Assistant > MCP Servers를 엽니다
서버가 녹색 상태 표시등을 보여주는지 확인합니다
Refresh를 클릭하여 도구를 다시 검색합니다
IDE 로그에서 오류를 확인합니다: Help > Show Log in Finder/Explorer

환경 변수 문제

JetBrains IDE는 쉘의 환경 변수를 상속받지 못할 수 있습니다. MCP 구성에 명시적으로 지정하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  ]
}

nvm 또는 fnm 사용 시

nvm 또는 fnm으로 Node.js 버전을 관리하는 경우 IDE가 npx를 찾지 못할 수 있습니다. 전체 경로를 사용하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "/Users/yourname/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

다음 명령으로 npx 경로를 찾을 수 있습니다:

which npx

6단계: 보안 권장 사항

시크릿 정보를 하드코딩하지 마세요

토큰을 구성 파일에 직접 넣는 대신, 환경 변수 참조 또는 비밀 관리자를 사용하세요:

# 쉘 프로필에 환경 변수 설정
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
export SLACK_BOT_TOKEN="xoxb-your-token"

MCP 서버 권한 제한

filesystem MCP 서버에는 필요한 디렉토리에만 접근 권한을 부여하세요.
database MCP 서버에는 읽기 전용 데이터베이스 자격 증명을 사용하세요.
최소한의 권한으로 구성된 스코프 API 토큰을 생성하세요.

.gitignore에 구성 파일 추가

# .gitignore
.jb-mcp.json

지원되는 JetBrains IDE

AI Assistant 플러그인이 포함된 모든 JetBrains IDE에서 MCP 지원을 사용할 수 있습니다:

IDE	중점 언어	MCP 지원 여부
IntelliJ IDEA	Java, Kotlin	Yes
WebStorm	JavaScript, TypeScript	Yes
PyCharm	Python	Yes
GoLand	Go	Yes
Rider	C#, .NET	Yes
RubyMine	Ruby	Yes
PhpStorm	PHP	Yes
CLion	C, C++	Yes
DataGrip	SQL, Databases	Yes
RustRover	Rust	Yes

AI API와 함께 빌드하기

MCP는 개발 환경을 외부 도구에 연결하지만, 만약 AI 미디어 생성 기능(이미지, 비디오, 오디오, 아바타)이 필요한 애플리케이션을 빌드하고 있다면 Hypereal AI가 MCP 강화 워크플로우를 보완할 수 있는 통합 API를 제공합니다. AI 어시스턴트가 사용자의 코드와 빌드 중인 API를 모두 이해하고 있을 때 통합 프로토타입을 더 빠르게 제작할 수 있습니다.

요약

JetBrains IDE에서 MCP를 설정하는 과정은 AI Assistant 플러그인 활성화, 서버 정의가 포함된 .jb-mcp.json 구성 파일 생성, 그리고 채팅 시작의 세 단계로 이루어집니다. 일상적인 개발에 가장 유용한 MCP 서버는 GitHub(PR 및 issue), database(스키마 및 쿼리), filesystem(문서)입니다. 구성 파일에 시크릿 정보를 노출하지 말고, 권한을 제한하며, 서버 연결에 실패할 경우 위의 문제 해결 단계를 따르세요.

2026년 IntelliJ IDE에서 MCP를 사용하는 방법

MCP란 무엇인가요?

GitHub MCP server: AI가 issue를 읽고, PR을 생성하며, 코드를 리뷰할 수 있게 합니다.
database MCP server: AI가 데이터베이스를 쿼리하고 스키마를 설명할 수 있게 합니다.
Jira MCP server: AI가 티켓을 읽고 상태를 업데이트할 수 있게 합니다.

사전 요구 사항

JetBrains IDE에서 MCP를 설정하기 전에 다음 사항을 확인하세요:

활성 라이선스가 있는 JetBrains IDE (2025.1 이상 버전)
Node.js 18+ 설치 (대부분의 MCP 서버는 Node 기반입니다)
AI Assistant plugin 활성화 (JetBrains IDE에 기본 포함되어 있음)
JetBrains AI 구독 또는 호환 가능한 AI 플러그인

IDE 버전을 확인하세요:

Help > About (Windows/Linux)
IntelliJ IDEA > About IntelliJ IDEA (macOS)

1단계: AI Assistant 활성화

JetBrains AI Assistant는 JetBrains IDE 내의 주요 MCP 클라이언트입니다.

Settings를 엽니다 (macOS는 Cmd+,, Windows/Linux는 Ctrl+Alt+S)
Plugins로 이동합니다
**"AI Assistant"**를 검색합니다
설치 및 활성화 여부를 확인합니다
메시지가 표시되면 IDE를 재시작합니다

재시작 후 오른쪽 사이드바에 AI Assistant 도구 창이 나타나야 합니다.

2단계: MCP 서버 구성

JetBrains IDE는 프로젝트 내부의 JSON 파일 또는 전역 설정을 통해 MCP 서버 구성을 지원합니다.

프로젝트 수준 구성

프로젝트 루트에 .jb-mcp.json 파일을 생성합니다:

{
  "servers": [
    {
      "name": "filesystem",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/directory"]
    },
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  ]
}

전역 구성

모든 프로젝트에서 사용하려는 MCP 서버의 경우 JetBrains 설정 디렉토리에 구성을 생성합니다:

# macOS
~/Library/Application Support/JetBrains/IntelliJIdea2025.2/mcp.json

# Linux
~/.config/JetBrains/IntelliJIdea2025.2/mcp.json

# Windows
%APPDATA%\JetBrains\IntelliJIdea2025.2\mcp.json

형식은 프로젝트 수준 구성과 동일합니다.

UI를 통한 구성

IDE 설정을 통해서도 MCP 서버를 구성할 수 있습니다:

Settings (Cmd+, / Ctrl+Alt+S)를 엽니다
Tools > AI Assistant > MCP Servers로 이동합니다
+ 버튼을 클릭하여 새 서버를 추가합니다
서버 세부 정보를 입력합니다:
- Name: 식별 가능한 이름
- Command: 서버를 시작하는 명령 (예: npx)
- Arguments: 명령 인자
- Environment Variables: 필요한 환경 변수

3단계: 인기 있는 MCP 서버 설정

GitHub MCP 서버

IDE의 AI를 GitHub 저장소에 연결하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

github.com/settings/tokens에서 repo 스코프를 가진 GitHub 토큰을 생성하세요.

가능한 작업:

"현재 변경 사항에 대한 PR 생성해 줘"
"나에게 할당된 열린 issue가 뭐야?"
"이 저장소의 최신 PR을 리뷰해 줘"

Database MCP 서버 (PostgreSQL)

AI가 데이터베이스 스키마를 쿼리하고 이해하도록 합니다:

{
  "servers": [
    {
      "name": "postgres",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://user:password@localhost:5432/mydb"]
    }
  ]
}

가능한 작업:

"users 테이블의 스키마를 보여줘"
"지난 30일 이내에 가입한 사용자를 찾는 쿼리를 작성해 줘"
"orders 테이블과 products 테이블 간의 관계를 설명해 줘"

Filesystem MCP 서버

AI에게 특정 디렉토리에 대한 읽기 권한을 부여합니다:

{
  "servers": [
    {
      "name": "docs",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "./docs", "./README.md"]
    }
  ]
}

Slack MCP 서버

팀 대화의 컨텍스트를 위해 Slack을 연결하세요:

{
  "servers": [
    {
      "name": "slack",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  ]
}

4단계: AI Chat에서 MCP 도구 사용하기

MCP 서버가 구성되고 실행되면, JetBrains IDE의 AI Assistant가 서버에서 노출하는 도구들을 사용할 수 있습니다.

대화 시작하기

AI Assistant 패널을 엽니다 (오른쪽 사이드바)
새 채팅을 시작합니다
AI가 사용 가능한 MCP 도구를 자동으로 검색합니다

상호작용 예시

사용자: 우리 GitHub 저장소에 열린 issue가 뭐야?

AI: [github MCP 도구 사용: list_issues]
열린 issue 12개를 찾았습니다. 가장 최근 항목은 다음과 같습니다:
- #145: 인증 타임아웃 수정 (@alice 담당)
- #143: 대시보드 레이아웃 업데이트 (담당자 없음)
- #140: 스테이징에서 데이터베이스 마이그레이션 실패 (@bob 담당)
...

사용자: payments 테이블의 스키마를 보여주고 느린 쿼리를 위한 인덱스를 추천해 줘.

AI: [postgres MCP 도구 사용: query]
payments 테이블의 스키마는 다음과 같습니다:
- id (uuid, primary key)
- user_id (uuid, users 테이블 외래 키)
- amount (decimal)
- status (varchar)
- created_at (timestamp)

일반적인 쿼리 패턴을 기반으로, 사용자의 최근 결제 내역을 조회하는 쿼리를 위해 (user_id, created_at DESC) 인덱스 추가를 추천합니다:

CREATE INDEX idx_payments_user_created ON payments (user_id, created_at DESC);

5단계: 문제 해결

MCP 서버가 시작되지 않음

IDE 외부에서 서버 명령이 작동하는지 확인하세요:

# 명령을 직접 테스트
npx -y @anthropic/mcp-server-github

# Node.js 접근 가능 여부 확인
node --version
npx --version

서버는 시작되지만 도구가 나타나지 않음

Settings > Tools > AI Assistant > MCP Servers를 엽니다
서버가 녹색 상태 표시등을 보여주는지 확인합니다
Refresh를 클릭하여 도구를 다시 검색합니다
IDE 로그에서 오류를 확인합니다: Help > Show Log in Finder/Explorer

환경 변수 문제

JetBrains IDE는 쉘의 환경 변수를 상속받지 못할 수 있습니다. MCP 구성에 명시적으로 지정하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  ]
}

nvm 또는 fnm 사용 시

nvm 또는 fnm으로 Node.js 버전을 관리하는 경우 IDE가 npx를 찾지 못할 수 있습니다. 전체 경로를 사용하세요:

{
  "servers": [
    {
      "name": "github",
      "command": "/Users/yourname/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

다음 명령으로 npx 경로를 찾을 수 있습니다:

which npx

6단계: 보안 권장 사항

시크릿 정보를 하드코딩하지 마세요

토큰을 구성 파일에 직접 넣는 대신, 환경 변수 참조 또는 비밀 관리자를 사용하세요:

# 쉘 프로필에 환경 변수 설정
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
export SLACK_BOT_TOKEN="xoxb-your-token"

MCP 서버 권한 제한

filesystem MCP 서버에는 필요한 디렉토리에만 접근 권한을 부여하세요.
database MCP 서버에는 읽기 전용 데이터베이스 자격 증명을 사용하세요.
최소한의 권한으로 구성된 스코프 API 토큰을 생성하세요.

.gitignore에 구성 파일 추가

# .gitignore
.jb-mcp.json

지원되는 JetBrains IDE

AI Assistant 플러그인이 포함된 모든 JetBrains IDE에서 MCP 지원을 사용할 수 있습니다:

IDE	중점 언어	MCP 지원 여부
IntelliJ IDEA	Java, Kotlin	Yes
WebStorm	JavaScript, TypeScript	Yes
PyCharm	Python	Yes
GoLand	Go	Yes
Rider	C#, .NET	Yes
RubyMine	Ruby	Yes
PhpStorm	PHP	Yes
CLion	C, C++	Yes
DataGrip	SQL, Databases	Yes
RustRover	Rust	Yes

Hypereal로 구축 시작하기

2026년 IntelliJ IDE에서 MCP를 사용하는 방법

MCP란 무엇인가요?

사전 요구 사항

1단계: AI Assistant 활성화

2단계: MCP 서버 구성

프로젝트 수준 구성

전역 구성

UI를 통한 구성

3단계: 인기 있는 MCP 서버 설정

GitHub MCP 서버

Database MCP 서버 (PostgreSQL)

Filesystem MCP 서버

Slack MCP 서버

4단계: AI Chat에서 MCP 도구 사용하기

대화 시작하기

상호작용 예시

5단계: 문제 해결

MCP 서버가 시작되지 않음

서버는 시작되지만 도구가 나타나지 않음

환경 변수 문제

nvm 또는 fnm 사용 시

6단계: 보안 권장 사항

시크릿 정보를 하드코딩하지 마세요

MCP 서버 권한 제한

.gitignore에 구성 파일 추가

지원되는 JetBrains IDE

AI API와 함께 빌드하기

요약

관련 아티클

MCP Server를 처음부터 구축하는 방법 (2026)

Context7 MCP Server 설정 방법 (2026)

FastMCP: 몇 분 만에 MCP 서버 구축하기 (2026)

지금 바로 개발을 시작하세요

Hypereal로 구축 시작하기

2026년 IntelliJ IDE에서 MCP를 사용하는 방법

MCP란 무엇인가요?

사전 요구 사항

1단계: AI Assistant 활성화

2단계: MCP 서버 구성

프로젝트 수준 구성

전역 구성

UI를 통한 구성

3단계: 인기 있는 MCP 서버 설정

GitHub MCP 서버

Database MCP 서버 (PostgreSQL)

Filesystem MCP 서버

Slack MCP 서버

4단계: AI Chat에서 MCP 도구 사용하기

대화 시작하기

상호작용 예시

5단계: 문제 해결

MCP 서버가 시작되지 않음

서버는 시작되지만 도구가 나타나지 않음

환경 변수 문제

nvm 또는 fnm 사용 시

6단계: 보안 권장 사항

시크릿 정보를 하드코딩하지 마세요

MCP 서버 권한 제한

.gitignore에 구성 파일 추가

지원되는 JetBrains IDE

AI API와 함께 빌드하기

요약

관련 아티클

MCP Server를 처음부터 구축하는 방법 (2026)

Context7 MCP Server 설정 방법 (2026)

FastMCP: 몇 분 만에 MCP 서버 구축하기 (2026)

지금 바로 개발을 시작하세요