MCP란? Claude Desktop MCP 서버 설정하는 법 - Model Context Protocol 초보 가이드

안녕하세요! 갓대희 입니다. :- )

 

과거의 AI가 단순히 대화만 했다면, 이제는 직접 외부 시스템과 소통하며 실제 행동까지 수행한다.

 

예전에는 Claude에게 "내 GitHub 이슈 좀 확인해줘"라고 하면 "죄송하지만 직접 접근할 수 없어요. 복사해서 붙여넣기 해주세요."라는 답변만 돌아왔었던 기억도 있을 것 이다.

매번 복붙 신공을 써가며 AI와 소통해야 하는 현실이 너무 비효율적이었다.

 

그런데 이런 불편함을 해소 하고자 Anthropic에서 Model Context Protocol(MCP)을 내놓게 되었다. 

 

AI 연결의 혁신 : MCP가 바꾸는 개발의 미래
마치 USB-C처럼 하나의 포트로 모든 기기를 연결하듯, MCP는 AI와 모든 시스템을 간단하게 연결해주는 표준 프로토콜이다. 더 이상 각각의 연동을 위해 고생할 필요가 없어졌다!

이미 MCP에 대해서 잘 설명하는 여러 글들이 있기 때문에 아주 간단히 기록만 하고 넘어 가려고 한다.

 

MCP란?

MCP(Model Context Protocol)는 쉽게 말해 AI 모델과 외부 도구 및 데이터를 연결하는 표준 인터페이스다.

MCP도 마찬가지로, AI가 특정 형식만 이해하면 어떤 툴이든 붙여 쓸 수 있다.

 

MCP(Model Context Protocol)를 한 마디로 설명하면 "AI 애플리케이션을 위한 USB-C 포트" 이다. 

이미 지금 MCP를 모르는 분들이 없기 문에 이 유명한 그림 하나면 다 설명이 될 것 이다.

USB 포트를 예로 드는데, 생각해보면 노트북에 마우스, 키보드, 외장하드를 연결하는 방식이 다르지 않다. USB 규격만 맞으면 제조사, 브랜드가 달라도 연결이 된다는 컨셉으로 설명하고 있다.. 

USB-C vs MCP : 왜 이 비교 해보기

• USB-C 이전 : 프린터, 마우스, 키보드... 각각 다른 포트와 드라이버가 필요했다.
• MCP 이전 : GitHub, Slack, DB... AI가 각각 다른 방식으로 연결해야 했다.
• USB-C 이후 : 하나의 포트로 모든 기기 연결 가능.
• MCP 이후 : 하나의 표준으로 모든 시스템 연결 가능.

MCP: AI를 위한 USB-C

모델 컨텍스트 프로토콜(MCP)은 AI 모델이 외부 도구 및 데이터와 소통하는 방식을 표준화합니다

⏱️

실시간 문서

최신 공식 문서를 즉시 참조

✔️

정확한 버전

사용 중인 버전에 맞는 코드

🚀

생산성 향상

불필요한 검색 시간 단축

🌐

범용 호환성

주요 AI IDE 지원

 

MCP의 동작 방식

MCP 아키텍처 : 간단명료한 구조

1. MCP Client (클라이언트) : Claude Desktop 같은 AI 애플리케이션 안에 살고 있다고 보자.
2. MCP Server (서버) : GitHub, Slack, DB 등 각 시스템마다 서버를 구현해 두었다.
3. 표준 프로토콜 : 이 둘이 JSON-RPC로 대화한다고 한다. (LSP에서 영감을 받았다고 한다.!) 

유형	도구 / 클라이언트	주요 특징
MCP 클라이언트	Claude Code / Claude.ai / Claude Desktop / Cline / Cursor 등	다양한 UI(Desktop, 웹, IDE 등)에서 MCP 서버와 연동 가능
MCP 서버	fileSystem / Context7 / Peekaboo / TestSprite / allthingsdev-mcp-server / Mailtrap / Postmark 등	다양한 기능별 MCP 서버 구현 (문서, UI 캡처, 테스트 자동화, 이메일, API 마켓 등)

MCP 동작 흐름

1. 클라이언트 요청: AI 에이전트가 특정 작업 요청 (예: "FastAPI로 API 만들어줘")
2. 호스트 중재: 요청을 검토하고 적절한 서버로 라우팅 (보안 체크)
3. 서버 처리: 외부 데이터 소스에서 최신 정보 수집
4. 컨텍스트 주입: 수집된 정보를 AI의 컨텍스트에 직접 삽입
5. 응답 생성: 최신 정보 기반으로 정확한 코드 제안

🤖

클라이언트

AI 에이전트
(Claude, GPT 등)

➔

🏠

호스트

보안 관제탑
(권한 관리)

➔

🔧

서버

외부 도구
(문서, API, DB)

 

 - 이왕 이면 실제로 위 예시들 중 아주 간단한 실습을 통해 어떤 내용인지 살펴보는게 더 간단할 것 같다.  

MCP 시작해보기

Claude Desktop에 MCP가 이미 내장되어 있기 때문에, 설정 파일만 조금 만져주면 바로 사용할 수 있다. 

 

1. Claude Desktop 설치

 - 나의 경우 클로드를 사용하고 있기 문에 클로드 데스트탑을 통해 실습 내용을 보여드리고자 한다.

 

1) 다운로드 링크 접속

 - https://claude.ai/download

 

2) 본인의 환경에 맞는 파일 다운로드 및 설치

 

3) 어떤 MCP를 사용하느냐에 따라서 파이썬 or UV, Node 등의 환경이 필요할 수 있다. 

4) Claude Desktop 앱 실행 > 메뉴 > 파일(File) > 설정(Settings) > 개발자(Developer) > 구성편집(Edit Config) 클릭

 - 실습을 위해 쓰고있던 MCP는 깔끔히 삭제 하도록 하겠다.

  - 구성편집(Edit Config) 클릭

 

5) claude_desktop_config.json이라는 설정 파일이 생성된다. 문서 편집툴로 열어보자. 

  - 별내용이 없을 것 이다.

 - 혹시 직접 경로를 찾는다면 os별 다음과 같다.

Claude Desktop 설정 파일 위치

// macOS
~/Library/Application Support/Claude/claude_desktop_config.json

// Windows  
%APPDATA%\Claude\claude_desktop_config.json

 

6) MCP 서버 리스트를 확인 ( 어떤 MCP들을 사용할수있는지 리스트, 추천 하는 사이트들은 많은데, 오늘은 제일 간단한하고, 흔하디 흔한 MCP 연결 테스트를 진행해보자. )

ex) 혹시나 내가 자주 접속했었던 사이트는참고 

 - https://github.com/modelcontextprotocol/servers

 - https://github.com/wong2/awesome-mcp-servers

 - https://mcpmarket.com/ko

 

7) 지금은 Filesystem MCP를 연동해보려 한다. 

 - https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem

 - 쭉 내용을 읽어보면 해당 내용이 보일 것 이고 해당 내용을 복사하자.

 

  - claude_desktop_config.json에 그대로 복사해 준다. 저장도 꼭 해주자.

// 파일시스템 서버 설정

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "본인이 허용할 폴더 경로"
      ]
    }
  }
}

 

 - 클로드 desktop을 완전 종료 후 다시 시작해 준다.

   ( 우상단 X 버튼을 누르지 않고 꼭, 메뉴 > 파일 > 종료후 다시 클로드를 새로 시작해 주자. )

 

 - 정상적으로 연동 되었다면, 새로운 채팅 > filesystem 이라는 새로운 도구가 연동된것을 볼 수 있다.

 

  - 어떤 일을 할 수 있게 되었을까? 

 

ex) 일반적인 순서 채팅 AI에 요청시

 - gpt : 로컬 PC 파일(폴더)에 접근조차 불가능하다. 

 

ex) MCP를 장착한 AI에 요청 해보자. 

 

  - 권한허용 요청이 오면 허용해 주자. (아까 할수 없었던 폴더 접근을 시도하고 , 파일 검색도 시도 하려한다. )

 

 - 내가 의도한대로 파일들에 대해 리스트업 완료.

 

 - 삭제 처리 요청 및 결과

 

 - delete file 기능은 보안상 만들진 않았나보다. ( 필요하면 직접 이 mcp 소스를 다운로드해서 커스터 마이징도 가능하다.  )

 

 - 아주 다양하고 유용한 MCP들이 많지만, 최대한 빠르고 간단하게 MCP라는게 어떤건지 찍먹. 정도해보고자 해당 실습을 통해 MCP가 어떤 컨셉인지 나타내보고자 했는데 

이후에는 개발자를 위한 MCP Tools를 추천하기 위한 기초 글이라고 봐주시면 좋을 것 같다. 

 

 - 지금 해본 예시는 하기 표에서 다음 내용을 테스트 해본 것 이다. 
클라이언트: 클로드 Desktop 
MCP 서버: fileSystem MCP 서버  

 - 그럼 응용해서 Cursor에서 fileSystem연동도 바로 해볼 수 있곘다라고 생각 되실거다. 당연히 가능 하다.

 

 - 동일하게 내용을 복사해 준다.

 

  - 채팅창에서 기존과 같이 사용해보면 된다.

 

MCP로 무엇을 할 수 있나?

Tools (도구) - AI가 액션을 취할 수 있어요

// GitHub 이슈 생성하기
{
  "tool": "create_github_issue",
  "parameters": {
    "title": "버그 수정 필요",
    "body": "사용자 로그인 시 세션 만료 문제",
    "labels": ["bug", "high-priority"]
  }
}

Resources (리소스) - AI가 데이터를 읽을 수 있어요

// 프로젝트 파일 내용 가져오기
{
  "resource": "file://project/src/main.py",
  "description": "메인 애플리케이션 파일"
}

Prompts (프롬프트) - 미리 정의된 템플릿이에요

// 코드 리뷰 템플릿
{
  "prompt": "code_review",
  "description": "Pull Request에 대한 상세한 코드 리뷰 수행"
}

 

 

MCP의 장점

• 생산성 폭증 : 정말 체감될 정도로 개발 속도가 빨라져요. 특히 디버깅할 때!
• 컨텍스트 스위칭 감소 : 툴 간 이동이 줄어서 집중력이 확실히 늘었어요
• 표준화의 힘 : 한 번 설정해두면 다른 MCP 서버들도 쉽게 추가 가능해요
• 보안 걱정 No : OAuth와 기존 권한 체계를 그대로 사용하니까 안전해요

 

확장되는 MCP 생태계

MCP 생태계는 빠르게 성장하고 있고, 다양한 분야의 서버들이 등장하고 있다.

MCP 생태계 폭발적 성장! (2025년 8월 기준)

2024년 말 출시 이후 불과 8개월만에 수백 개의 MCP 서버가 등장했습니다!

개발 도구 (GitHub, Docker, Playwright 등)80+ 개

 

데이터베이스 (PostgreSQL, MongoDB, BigQuery 등)45+ 개

 

생산성/협업 (Slack, Notion, Google Drive 등)35+ 개

 

클라우드/인프라 (AWS, Azure, Cloudflare 등)25+ 개

 

게임/엔터테인먼트 (Unity, Chess, RuneScape 등)20+ 개

 

특수 목적 (금융, 지도, 보안 등)15+ 개

 

🚀 총 220+ 개의 MCP 서버가 활발히 운영 중! (출처: GitHub awesome-mcp-servers, mcpservers.org)

2025년 주목할 만한 신규 MCP 서버들
• 게임 개발: Unity3D MCP, Godot Engine MCP, Unreal Engine MCP
• AI/ML: Jupyter Notebook MCP, TensorFlow MCP, Hugging Face MCP
• 금융: Stripe MCP, PayPal MCP, 암호화폐 데이터 MCP
• 소셜: Discord MCP, WhatsApp MCP, LinkedIn MCP, Twitter MCP
• 엔터프라이즈: Salesforce MCP, SAP MCP, Oracle Cloud MCP

 

보안은 안전한가? MCP 보안 고려사항

강력한 기능에는 항상 보안 리스크가 따른다. MCP도 예외는 아니다. 하지만 제대로 알고 쓰면 충분히 안전하다.

🚨 MCP 보안 위험 요소들

📦 생성 단계 위험

이름 충돌

스푸핑

코드 주입

악의적인 서버가 정상 서버로 위장하거나 백도어를 심을 위험

⚡ 운영 단계 위험

샌드박스 탈출

서버가 허용된 범위를 벗어나 시스템에 접근할 위험

🔄 업데이트 단계 위험

권한 지속

구성 드리프트

업데이트 후에도 이전 권한이 남거나 설정이 변경될 위험

내가 실천하는 MCP 보안 수칙
• 공식 저장소에서만 서버 설치 (npm, GitHub 등)
• 서버별 최소 권한 원칙 적용
• 정기적으로 서버 목록과 권한 검토
• 로컬 서버보다는 검증된 원격 서버 우선 사용
• 의심스러운 서버는 샌드박스 환경에서 먼저 테스트

 

 

자주 묻는 질문 ❓

Q: MCP를 쓰려면 새로운 언어를 배워야 하나요?

A: 전혀요! 기존에 쓰던 도구들을 그대로 쓰면서 MCP 서버만 연결하면 됩니다. 마치 USB 기기를 연결하는 것처럼 간단해요.

Q: 보안은 괜찮나요? 내 데이터가 외부로 나가지 않을까요?

A: MCP는 기존 권한 체계를 그대로 사용해요. GitHub 토큰, DB 접근 권한 등 기존 보안 설정이 그대로 적용됩니다.

Q: Claude Desktop 말고 다른 AI 툴에서도 쓸 수 있나요?

A: 네! Cursor, Replit, Codeium 등 많은 개발 도구들이 MCP를 지원하기 시작했어요. 앞으로 더 많아질 거예요.

 

참고 자료

• Anthropic MCP 공식 문서 - 가장 정확하고 최신 정보
• MCP GitHub Repository - 다양한 서버 구현체들
• MCP 발표 블로그 - Anthropic의 비전과 철학