[AI] Cursor, Intellij, VSCode에서 MCP 사용하기

🌟 개요

MCP (Model Context Protocol)는 LLM이 외부 도구 및 서비스와 상호작용할 수 있도록 설계된 프로토콜입니다.

copilot chat + github-mcp-server + mcp-atlassian 를 연동하여 copilot chat을 통해 github 관련 기능을 사용합니다.

주요 기능

• ✅ PR 등록
• ✅코드리뷰
• ✅Jira 이슈 조회/생성/수정
• ✅ Confluence 위키 검색/편집
• ✅ 실시간 데이터 연동
• ✅ 자연어로 사내 시스템 제어

공식문서: https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-chat-with-mcp?tool=vscode

아키텍처 구성도

┌─────────────┐    MCP Protocol    ┌─────────────────┐    HTTP API    ┌─────────────┐
│   Cursor    │ ◄─────────────────►│      MCP        │ ◄─────────────►│   OSS/Wiki  │
│             │                    │     Server      │                │   Services  │
└─────────────┘                    └─────────────────┘                └─────────────┘
       ▲                                     ▲
       │                                     │
   mcp.json                              .env file
   설정 파일                             토큰 & 설정

---

🛠️ 사전 준비

1.Docker 설치

github-mcp-server 는 docker 기반으로 실행하기 때문에 사전에 로컬 환경에서 docker 가 실행중이어야 한다.

docker 서버 떠있는지 확인

docker ps

2. Homebrew 설치 (macOS)

mcp-Atlassian 을 사용하기위해 아래 사전 설치가 필요합니다.

# Homebrew 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 설치 확인
brew --version

3. UV (Python 패키지 관리자) 설치

# 방법 1: 공식 스크립트 (권장)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 방법 2: Homebrew
brew install uv

# 방법 3: pipx
pipx install uv

# 환경 설정 (스크립트 설치 시)
source "$HOME/.cargo/env"

# 설치 확인
uv --version

🔑 PAT 토큰 생성

github access token 생성

3.settings.json 에 mcp설정 추가

모든 settings.json (mcp.json) 설정파일은 로컬환경 (Users/{user_name}) 하위에 세팅하였습니다.

만약 ./cursor 하위에 mcp.json 파일을 생성하여 관리한다면 PAT 토큰을 개별관리하여 환경설정이 필요합니다.

 

1) Intellij 에 mcp 추가

1. plugin 추가 후 IDE 재시작

• Settings > Languages & Frameworks > Github Copilot

• mcp.json 수정

{
  "servers": {
     "github": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "-e",
        "GITHUB_HOST",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "{github-personal-token}",
        "GITHUB_HOST": ""
      }
    },
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_PERSONAL_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "",
        "CONFLUENCE_PERSONAL_TOKEN": "{confluence-personal-token}",
        "JIRA_URL": "",
        "JIRA_PERSONAL_TOKEN": "{jira-personal-token}"
      }
    }
  }
}

2) VSCode에 mcp 추가

• MCP Client (Copilot MCP) 설치
  

1. VSCode 확장에서 Copilot MCP 검색하여 설치
2. settings.json 파일에 아래와 같이 설정을 추가한다.
   • 설정 위치
     • .vscode/mcp.json : 프로젝트(워크스페이스) 단위, 팀 전체에 동일한 MCP 설정을 적용, Git에 커밋 가능
     • settings.json (User Settings): 로컬 사용자 단위, 개인 개발 환경에 MCP 서버 설정, Git에 포함 안 됨
   • Copilot Chat은 .vscode/mcp.json > settings.json 순으로 설정을 읽습니다.

• github enterprise 는 "-e", "GITHUB_HOST" 옵션을 추가한다.
• env 에 github pat 와 github_host 정보를 입력한다.

• docker 실행 후
• mcp server "start" 실행

{
    "mcp": {
        "servers": {
            "github": {
                "command": "docker",
                "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "GITHUB_PERSONAL_ACCESS_TOKEN",
                "-e", "GITHUB_HOST",
                "ghcr.io/github/github-mcp-server"
                ],
                "env": {
                    "GITHUB_PERSONAL_ACCESS_TOKEN": "${github_personal_access_token}",
                    "GITHUB_HOST": ""
                }
            }
        }
    }
}

3) Cursor AI 에 mcp 추가

Cursor Settings → Add new global MCP server 선택

• mcp.json 파일에 아래와 같이 github-mcp-server 등록
• GH_HOST 로 oss host 추가

• MCP tools 에서 github-mcp-server 가 등록된 것을 확인할 수 있다.
• tools enabled 를 클릭하여 사용하려는 tool 을 추가/제외 할 수 있다.

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "-e", "GITHUB_HOST",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${github-personal-token}",
        "GITHUB_HOST": ""
      }
    }
  }
}

성공 시 표시되는 도구들 (tools)

✅ Confluence 도구: - confluence_search - 위키 검색 - confluence_get_page - 페이지 조회 - confluence_create_page - 페이지 생성 - confluence_update_page - 페이지 수정

✅ Jira 도구: - jira_search - 이슈 검색 - jira_get_issue - 이슈 조회 - jira_create_issue - 이슈 생성 - jira_update_issue - 이슈 수정