[Claude 시리즈 11편] Claude MCP 완벽 정리 - AI를 외부 도구와 연결하는 표준 (2026 최신)

[Claude 시리즈 11편] Claude MCP 완벽 정리 - AI를 외부 도구와 연결하는 표준 (2026 최신)

테스트 환경: Claude Desktop, Claude Code, MCP 2.x (2026년 7월 기준)

Claude에게 이렇게 말할 수 있다면 어떨까요?

"내 GitHub 이슈 확인해서 우선순위 정리해줘." "우리 데이터베이스에서 지난달 매출 뽑아줘." "이 문서를 내 드라이브에 저장해줘."

Claude가 본인의 실제 도구와 데이터에 직접 접근해서 일을 처리하는 것. 이걸 가능하게 하는 것이 MCP(Model Context Protocol) 입니다.

MCP는 2024년 11월 Anthropic이 발표한 오픈 표준으로, 2026년 현재 AI 업계 전체의 표준이 되었습니다. 그런데 한국어 자료가 거의 없습니다. 이 글에서 처음부터 정리합니다.

• MCP가 정확히 무엇인가 (비유로 이해)
• 핵심 구조 (Client, Server, Transport)
• 기본 MCP 서버 연결하기 (실전)
• 어떤 서버를 먼저 써야 하나
• 커스텀 MCP 서버 개념
• 보안과 주의사항

이 글은 Phase 3의 두 번째 글입니다. API 편에 이어 개발자·파워유저를 위한 심화 내용입니다.

 

MCP란 무엇인가 - "AI를 위한 USB"

가장 좋은 비유는 USB입니다.

USB가 나오기 전에는 프린터, 마우스, 키보드마다 다른 포트와 케이블이 필요했습니다. USB는 하나의 표준 규격으로 이 모든 것을 연결했습니다.

MCP도 마찬가지입니다.

MCP 이전:
Claude ─(각각 다른 방식)→ GitHub
Claude ─(각각 다른 방식)→ 데이터베이스
Claude ─(각각 다른 방식)→ Slack
→ 도구마다 별도 통합 개발 필요

MCP 이후:
Claude ─(MCP 표준)→ [GitHub / DB / Slack / ...]
→ 하나의 프로토콜로 모든 도구 연결

한 줄 정의: MCP는 AI가 외부 도구·데이터에 접근하는 표준 방식입니다.

왜 중요한가

2023~2024년에는 Claude에 정보를 주려면 복사-붙여넣기를 해야 했습니다. CSV를 내보내고, 문서를 열어서 긁어오고. MCP는 이 마찰을 없앱니다. Claude가 직접 파일을 읽고, DB를 조회하고, API를 호출합니다.

2026년 현재 위상

• 9,400개 이상의 MCP 서버가 공식 레지스트리에 등록
• 2025년 12월 Linux Foundation으로 이관 → Anthropic만의 것이 아닌 진정한 오픈 표준
• model-agnostic: Claude뿐 아니라 GPT, Gemini도 MCP 지원
• 월 9,700만 다운로드 (16개월 만에 4,750% 성장)

즉, MCP를 배우는 것은 특정 회사 기술이 아니라 AI 시대의 범용 인프라를 배우는 것입니다.

 

★ MCP 핵심 구조 3가지

MCP를 이해하려면 세 가지 구성 요소를 알면 됩니다.

1. MCP Client (클라이언트)

대화를 이끄는 애플리케이션입니다.

예시:
- Claude Desktop (데스크톱 앱)
- Claude Code (터미널)
- Claude.ai (웹, Pro 이상)
- Cursor, 기타 AI 에디터

사용자(나)와 서버(도구) 사이를 중개합니다.

2. MCP Server (서버)

도구를 제공하는 쪽입니다. 각 서버는 특정 기능을 노출합니다.

예시:
- GitHub 서버: "이슈 생성", "PR 검토", "코드 검색"
- PostgreSQL 서버: "쿼리 실행", "테이블 조회"
- Filesystem 서버: "파일 읽기", "파일 쓰기"
- Slack 서버: "메시지 전송", "채널 조회"

서버는 model-agnostic입니다. GitHub 서버 하나를 만들면 Claude, GPT, Gemini 어디서든 쓸 수 있습니다.

3. Transport (전송 방식)

클라이언트와 서버가 통신하는 채널입니다.

방식 특징 용도

stdio	로컬 프로세스로 실행	개인 PC (가장 흔함)
HTTP/SSE	원격 서버와 통신	팀 공유, 클라우드
WebSocket	실시간 양방향	고급 사용

개인 사용은 대부분 stdio입니다. 본인 컴퓨터에서 서버가 프로세스로 실행됩니다.

전체 흐름

[나] → [Claude Desktop = Client]
              ↓ (stdio/HTTP)
       [GitHub MCP Server]
              ↓
       [실제 GitHub API]

Claude가 GitHub 서버에게 "이슈 목록 줘"라고 요청하면, 서버가 실제 GitHub에서 데이터를 가져와 Claude에게 전달합니다.

 

MCP의 세 가지 제공물

MCP 서버는 세 종류를 제공합니다. 구분하면 이해가 쉽습니다.

종류 의미 예시

Tools (도구)	Claude가 호출하는 함수 (행동)	"쿼리 실행", "파일 쓰기"
Resources (리소스)	미리 붙는 컨텍스트 (읽기)	파일 내용, DB 행
Prompts (프롬프트)	재사용 프롬프트 템플릿	"코드 리뷰 표준 절차"

Tool과 Resource의 차이: Tool은 "요청해서 실행"(마우스 클릭 같은), Resource는 "미리 열어둔 것"(파일 여는 것 같은)입니다.

 

★ 기본 MCP 서버 연결하기 (실전)

이론은 충분합니다. 실제로 연결해봅시다. Claude Desktop 기준입니다.

Anthropic 공식 레퍼런스 서버 6개

Anthropic이 직접 제공하는 검증된 서버입니다. 여기서 시작하세요.

1. filesystem   - 로컬 파일 읽기/쓰기
2. PostgreSQL   - DB 조회
3. Brave Search - 웹 검색
4. GitHub       - 저장소 관리
5. Puppeteer    - 브라우저 제어
6. Google Maps  - 지도/위치

설정 파일 위치

Claude Desktop은 설정 파일을 읽어서 MCP 서버를 로드합니다.

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

Windows:
%APPDATA%\Claude\claude_desktop_config.json

Filesystem 서버 연결 예시

가장 기본이 되는 파일시스템 서버를 연결해봅시다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/사용자명/Documents"
      ]
    }
  }
}

이렇게 하면 Claude가 지정한 폴더의 파일을 읽고 쓸 수 있습니다.

GitHub 서버 연결 예시

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

적용 방법

1. 설정 파일 편집 (위 내용 추가)
2. Claude Desktop 완전 종료 후 재시작
3. 대화창에서 도구 아이콘 확인
4. "내 Documents 폴더의 파일 목록 보여줘" 테스트

재시작하면 도구가 자동으로 나타납니다.

Claude Code에서 연결

Claude Code는 CLI로 더 간단합니다.

# 서버 추가
claude mcp add github npx @modelcontextprotocol/server-github

# 목록 확인
claude mcp list

# 특정 서버 정보
claude mcp get github

설정은 ~/.claude/settings.json(사용자) 또는 프로젝트의 .claude/settings.json에 저장됩니다.

 

★ 어떤 서버를 먼저 써야 하나

수천 개 서버가 있지만, 커뮤니티가 검증한 필수 5개부터 시작하세요.

서버 용도 추천 대상

filesystem	로컬 파일 작업	모두
GitHub	이슈/PR/코드	개발자
PostgreSQL/Supabase	DB 조회	개발자/DBA
Playwright/Puppeteer	웹 자동화	자동화
Brave Search	웹 검색	모두

★ 중요: 너무 많이 설치하지 말 것

커뮤니티의 가장 중요한 교훈입니다.

한 개발자의 측정:
"컨텍스트 윈도우의 30~40%가 한 번도 안 쓴 
도구 스키마로 채워지고 있었다."

서버 하나하나가 도구 정의로 컨텍스트를 차지합니다. 3~5개만 설치하고, 자주 안 쓰는 건 제거하세요. 많을수록 좋은 게 아닙니다.

사용 빈도로 판단

주 1회만 쓰는 서버 → 설치하지 말고 CLI 도구로 대체
매일 쓰는 서버 → MCP로 상시 연결

 

커스텀 MCP 서버 만들기 (개념)

기성 서버로 부족하면 직접 만들 수 있습니다. 개념만 짚습니다.

언제 만드나

• 사내 전용 시스템 연결 (자체 API, 내부 DB)
• 특정 워크플로우 자동화
• 기성 서버가 없는 도구

기본 구조 (Python 예시)

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def get_ticket(ticket_id: str) -> str:
    """티켓 정보를 조회합니다."""
    # 실제 로직 (DB 조회 등)
    return f"티켓 {ticket_id}의 정보..."

@mcp.tool()
def search_notes(keyword: str) -> str:
    """프로젝트 노트를 검색합니다."""
    # 실제 로직
    return f"'{keyword}' 검색 결과..."

if __name__ == "__main__":
    mcp.run()

이렇게 만든 서버를 설정 파일에 등록하면 Claude가 get_ticket, search_notes 도구를 쓸 수 있습니다.

FastMCP 프레임워크

FastMCP는 MCP 서버를 쉽게 만드는 프레임워크입니다. 함수에 @mcp.tool() 데코레이터만 붙이면 도구가 됩니다. Docker로 배포하면 팀 전체가 공유할 수도 있습니다.

DBA·운영자 활용 아이디어: 사내 모니터링 시스템, 운영 DB 조회, 로그 검색을 MCP 서버로 만들면 Claude가 직접 운영 데이터에 접근해서 분석할 수 있습니다.

 

★ 보안과 주의사항 (필독)

MCP는 강력한 만큼 위험도 있습니다. 반드시 이해하세요.

1. 권한 범위 = 위험 범위

stdio 서버는 본인 권한으로 실행됩니다.
→ 그 프로세스가 읽을 수 있는 모든 것을 Claude가 읽을 수 있습니다.

filesystem 서버에 홈 디렉토리 전체를 열어주면, Claude가 그 안의 모든 파일에 접근 가능합니다. 필요한 폴더만 열어주세요.

2. 신뢰할 수 있는 서버만

❌ 출처 불명의 MCP 서버 설치 금지
✅ 공식 레지스트리, 검증된 커뮤니티 서버만

MCP 서버는 코드를 실행합니다. 악의적 서버는 위험합니다. 공식 또는 널리 검증된 것만 쓰세요.

3. 인증 정보 관리

GitHub 토큰, DB 비밀번호 등을 설정 파일에 넣을 때:
- 최소 권한 토큰 사용
- 설정 파일을 git에 올리지 않기
- 정기적으로 토큰 교체

4. 데이터 전송 이해

Claude가 MCP 도구로 데이터를 받으면(예: 파일 내용), 그 데이터는 Claude의 컨텍스트로 들어갑니다. 즉 Anthropic 서버로 전송됩니다. 민감 데이터를 다루는 MCP는 신중하게.

5. 승인 프롬프트 확인

Claude Code 등에서 팀의 .mcp.json을 가져오면 승인 프롬프트가 뜹니다. 무엇을 승인하는지 확인하고 승인하세요.

 

실전 활용 시나리오

개발자

"GitHub에서 이번 스프린트 이슈 가져와서 
우선순위별로 정리하고, 각 이슈에 예상 공수 추정해줘"
→ GitHub MCP로 실제 이슈 조회 + 분석

DBA·운영자

"운영 DB에서 최근 24시간 느린 쿼리 TOP 10 뽑아서 
원인 분석해줘"
→ PostgreSQL MCP로 실제 조회 + 진단

일반 실무자

"내 Documents 폴더에서 지난달 보고서들 찾아서 
공통 이슈를 요약해줘"
→ filesystem MCP로 파일 접근 + 요약

 

다음 글 예고

다음 글은 [Claude 시리즈 12편] Claude Skills 만들기 입니다. MCP가 "외부 도구 연결"이라면, Skills는 "반복 작업을 Claude에게 가르치는" 기능입니다. 둘의 차이와 각각의 활용법을 다룹니다.

 

마무리

MCP의 핵심을 다시 정리하면:

1. MCP는 AI를 위한 USB — 하나의 표준으로 모든 도구 연결
2. Client(Claude) + Server(도구) + Transport(통신) 3요소
3. 공식 레퍼런스 6개부터 시작 (filesystem, GitHub 등)
4. 3~5개만 설치 — 많으면 컨텍스트 낭비
5. 보안 필수 — 권한 최소화, 검증된 서버만, 인증 정보 관리

MCP는 2026년 AI 활용의 핵심 인프라입니다. 복사-붙여넣기 시대를 끝내고 Claude가 본인의 실제 도구와 직접 일하게 만듭니다. 다만 강력한 만큼 보안에 신중해야 합니다. filesystem 서버 하나부터 연결해보며 감을 잡으시길 권합니다.

MCP를 활용한 사례나 유용한 서버 추천이 있다면 댓글로 공유해주세요. 한국어 MCP 정보가 부족한 만큼, 함께 노하우를 모으면 좋겠습니다.