🔌 Claude Code MCP 완전 가이드

MCP = Claude Code에 앱을 추가하는 것

Claude Code한테 “내 GitHub 이슈 확인해줘”라고 하면 어떻게 될까요? 기본 상태에선 아무것도 못 해요. GitHub에 접근할 방법이 없거든요.

그런데 MCP 서버를 추가하면? 바로 돼요. 스마트폰에 카카오톡을 깔면 메시지를 보낼 수 있는 것처럼, Claude Code에 GitHub 앱을 깔면 이슈를 확인할 수 있는 거예요.

MCP는 Model Context Protocol의 약자인데, 이름은 몰라도 돼요. 중요한 건 “Claude Code에 앱을 추가하는 방법”이라는 것만 기억하면 돼요.

스마트폰	Claude Code
앱스토어에서 앱 검색	MCP 서버 목록에서 도구 검색
앱 설치 (터치 한 번)	MCP 추가 (명령어 한 줄)
앱 실행해서 사용	Claude에게 말하면 알아서 사용
카카오톡 깔면 메시지 가능	GitHub MCP 깔면 이슈 관리 가능
토스 깔면 송금 가능	Notion MCP 깔면 문서 관리 가능

한 줄 요약

MCP = Claude Code의 앱스토어. 필요한 앱(서버)을 설치하면 Claude가 그 서비스를 직접 쓸 수 있어요.

어떤 앱들이 있을까?

스마트폰에 SNS 앱, 은행 앱, 쇼핑 앱이 있듯이, Claude Code에도 다양한 종류의 앱(MCP 서버)이 있어요. 카테고리별로 살펴볼게요.

📋

업무 도구

Notion, Linear, Asana 등. 할일 관리, 프로젝트 관리, 문서 작성을 Claude에게 시킬 수 있어요.

💻

개발 도구

GitHub. 코드 관리, 이슈 생성, PR 리뷰를 대화로 처리할 수 있어요.

📊

데이터

PostgreSQL, Supabase 등. 데이터베이스를 한국어로 물어보면 결과를 뽑아줘요.

📬

커뮤니케이션

Slack, Gmail 등. 메일 정리, 메시지 전송을 Claude가 대신해줘요.

🔍

모니터링

Sentry 등. 에러가 발생하면 원인 분석부터 수정 코드 제안까지 해줘요.

🎨

디자인

Figma 등. 디자인 파일을 읽어서 코드로 변환할 수 있어요.

전부 무료로 연결할 수 있어요

MCP 서버를 추가하는 것 자체는 무료예요. Claude Code에 명령어 한 줄이면 끝이에요. (단, 연결하는 서비스 자체의 유료 플랜은 별개예요.)

실제로 이렇게 씁니다

MCP가 있으면 뭐가 달라지는지, 구체적으로 비교해볼게요.MCP 없을 때와 있을 때의 차이예요.

1. GitHub — 코드 관리

MCP 없을 때

브라우저에서 GitHub 열고, PR 목록 찾고, 하나씩 클릭해서 확인

MCP 있을 때

“PR 목록 보여줘” 한마디면 끝

이렇게 말하면 돼요

내 GitHub 저장소에서 열린 PR 목록 보여줘.
가장 오래된 것부터 정리해줘.

2. Sentry — 에러 추적

MCP 없을 때

Sentry 사이트 로그인, 에러 로그 페이지 찾기, 스택트레이스 읽기

MCP 있을 때

“최근 에러 분석해줘” 한마디로 원인까지 파악

이렇게 말하면 돼요

Sentry에서 최근 24시간 에러를 가져와서
원인별로 분류하고 해결 방법을 알려줘.

3. Notion — 문서 관리

MCP 없을 때

노션에서 내용 복사, Claude에 붙여넣기, 결과를 다시 노션에 복사

MCP 있을 때

“노션 페이지 읽어서 요약해줘” 한마디

이렇게 말하면 돼요

내 노션 워크스페이스에서 "회의록" 페이지를 찾아서
핵심 내용을 3줄로 요약해줘.

4. Gmail — 메일 관리

MCP 없을 때

Gmail 열고 메일 하나하나 확인, 중요한 것 직접 골라내기

MCP 있을 때

“오늘 중요 메일 정리해줘” 한마디

이렇게 말하면 돼요

오늘 온 메일 중에서 답장이 필요한 것만 골라줘.
각각 한 줄 요약이랑 답장 초안도 만들어줘.

5. PostgreSQL — 데이터 조회

MCP 없을 때

SQL 문법 공부, 쿼리 직접 작성, 결과 해석

MCP 있을 때

“지난달 매출 Top 10 보여줘” 한국어로 질문

이렇게 말하면 돼요

지난달 매출 상위 10개 제품을 보여줘.
매출액, 판매량, 전월 대비 증감을 표로 정리해줘.

핵심은 조합이에요

MCP의 진짜 힘은 여러 앱을 동시에 쓸 때 나타나요. “Sentry에서 에러 확인하고, GitHub에서 수정하고, Slack으로 알려줘” — 이런 복합 작업도 한마디면 돼요.

MCP = Claude Code의 앱스토어

앱을 깔수록 Claude가 할 수 있는 일이 늘어나요

설치 방법 — 딱 2가지만 알면 돼요

MCP 서버를 추가하는 방법은 딱 2가지예요. 어렵게 생각하지 마세요.

1. 원격 서버 (대부분 이거예요)

인터넷에 있는 서비스에 연결하는 거예요. GitHub, Notion, Sentry 같은 서비스들이 다 이 방식이에요.

원격 서버 추가

claude mcp add --transport http 이름 URL

2. 로컬 서버 (특수한 경우)

내 컴퓨터에서 직접 돌리는 거예요. 내 컴퓨터 파일에 접근하거나, 로컬 데이터베이스를 쓸 때 사용해요.

로컬 서버 추가

claude mcp add 이름 -- 명령어

자주 쓰는 예시 3개

GitHub (원격)

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Notion (원격)

claude mcp add --transport http notion https://mcp.notion.com/mcp

Sentry (원격)

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

명령어가 복잡해 보이지만

외울 필요 없어요. 공식 문서에서 복사해서 붙여넣기 하면 끝이에요. 이 페이지 아래에 인기 서버 명령어를 전부 모아뒀으니까 거기서 복붙하세요.

지금 바로 설치해보기

직접 해봐야 감이 잡혀요. 가장 쉬운 GitHub MCP를 설치해볼게요.

터미널에서 Claude Code 실행

아무 폴더에서나 claude 입력하면 돼요

아래 명령어 복붙

Claude Code 세션 밖, 일반 터미널에서 실행하세요

/mcp 입력해서 확인

Claude Code 세션 안에서 연결 상태를 확인할 수 있어요

말로 시켜보기

"내 GitHub PR 목록 보여줘"라고 말하면 성공!

Step 2: GitHub MCP 추가 (터미널에서 실행)

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Step 3: Claude Code 세션 안에서 확인

/mcp

Step 4: 사용해보기

내 GitHub 저장소 목록을 보여줘.

여기까지 했으면 성공이에요! GitHub 외에 다른 서버를 추가하고 싶으면 같은 방식으로 하면 돼요.

관리 명령어 3개 — 이것만 알면 돼요

명령어	설명
`claude mcp list`	설치된 MCP 서버 목록 보기
`claude mcp get 이름`	특정 서버 상세 정보 확인
`claude mcp remove 이름`	필요 없는 서버 삭제

설치는 한 번만 하면 돼요

한번 추가한 MCP 서버는 자동으로 저장돼요. 다음에 Claude Code를 켜면 알아서 연결돼요. 매번 다시 설치할 필요 없어요.

로그인이 필요한 서버

GitHub, Notion 같은 서비스는 내 계정 데이터에 접근해야 하잖아요? 그래서 처음 연결할 때 로그인이 필요해요. 카카오 로그인이나 구글 로그인처럼, “이 앱이 내 계정을 써도 될까요?” 물어보는 거예요.

전체 과정 — 3단계면 끝

MCP 서버 추가 (위에서 한 것)

터미널에서 claude mcp add 명령어 실행

Claude Code 안에서 /mcp 입력

인증이 필요한 서버가 있으면 여기서 알려줘요

브라우저에서 로그인 + "허용" 클릭

브라우저가 자동으로 열려요. 로그인하고 허용 누르면 끝!

한 번 로그인하면 다음부터는 자동이에요. 매번 로그인할 필요 없어요.

브라우저가 안 열리면?

터미널에 URL이 뜰 거예요. 그 URL을 복사해서 브라우저 주소창에 직접 붙여넣으면 돼요.

설치 범위 — 보통 기본값이면 충분해요

MCP 서버를 설치할 때, “나만 쓸 건지” “팀과 공유할 건지” 정할 수 있어요. 3가지 옵션이 있는데, 처음엔 기본값으로 충분해요.

기본 (Local)

나만 쓰는 거예요. 아무 옵션 안 붙이면 자동으로 이거예요. 처음엔 이걸로 충분해요.

claude mcp add 이름 ...

팀 공유 (Project)

팀원들이 같이 쓸 수 있어요. 뒤에 --scope project를 붙이면 돼요.

claude mcp add --scope project 이름 ...

모든 프로젝트 (User)

내가 하는 모든 작업에서 쓰고 싶을 때.--scope user를 붙이면 돼요.

claude mcp add --scope user 이름 ...

나중에 바꿔도 돼요

처음엔 기본(Local)으로 시작하세요. 팀과 공유할 일이 생기면 그때 삭제하고 Project로 다시 추가하면 돼요.

더 편하게 쓰는 법

MCP 서버를 설치했으면, 더 편하게 쓰는 방법 2가지를 알아볼게요.

@ 멘션 — 데이터를 직접 불러오기

채팅에서 @ 치고 서버 이름을 입력하면, 그 서버의 데이터를 직접 참조할 수 있어요. 파일을 복사하거나 다운로드할 필요 없이, 대화 중에 바로 불러오는 거예요.

@ 멘션 사용 예시

# Claude Code 세션에서 이렇게 입력
@github 이 이슈를 분석해줘

@notion 이 페이지를 요약해줘

/ 슬래시 명령어 — 추가 기능 사용하기

MCP 서버를 설치하면 새로운 슬래시 명령어가 추가될 수 있어요./를 입력하면 사용 가능한 명령어 목록이 보여요.

모르면 일단 말로 시켜보세요

@ 멘션이나 슬래시 명령어를 몰라도 괜찮아요. 그냥 “GitHub에서 이슈 확인해줘”, “노션 페이지 요약해줘” 처럼 한국어로 말하면 Claude가 알아서 올바른 도구를 사용해요.

MCP, 어떻게 발전해왔나

MCP는 아직 새로운 기술이에요. 짧은 역사지만 빠르게 발전하고 있어요.

2024.11

MCP 첫 공개

Anthropic이 MCP를 무료로 공개했어요. "AI의 USB-C 표준이 생겼다"고 화제가 됐어요.

2025.11

1주년 - 생태계 폭발

수많은 서비스들이 MCP를 지원하기 시작했어요. GitHub, Notion, Slack 등이 합류했어요.

2026.01

원격 연결 시대

명령어 한 줄로 원격 서버에 바로 연결할 수 있게 됐어요. 설치가 훨씬 간단해졌어요.

2026.03

2026 로드맵 발표

더 빠르게, 더 안전하게, 기업에서도 쓸 수 있게 만들겠다는 계획이 나왔어요.

계속 좋아지고 있어요

MCP는 매달 새로운 서버가 추가되고 있어요. 지금 배워두면 앞으로 할 수 있는 일이 계속 늘어나요.

직접 해보기

읽기만 하면 감이 안 잡혀요. 아래 실습을 따라해보세요.

실습 1: GitHub MCP 연결하기 (가장 쉬움)

GitHub 계정만 있으면 바로 할 수 있어요.

1단계: MCP 서버 추가

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

2단계: Claude Code에서 /mcp 입력

/mcp
# 목록에 github이 보이면 성공!
# 인증이 필요하면 브라우저에서 로그인하세요.

3단계: 사용해보기

내 GitHub 저장소 목록을 보여줘.

실습 2: Notion MCP도 추가해보기

Notion을 쓰고 있다면 이것도 연결해보세요.

Notion MCP 추가

claude mcp add --transport http notion https://mcp.notion.com/mcp

# Claude Code에서:
내 Notion 워크스페이스의 최근 페이지 5개 보여줘.

확인 체크리스트

MCP 서버 1개를 설치했다/mcp에서 서버 목록이 보인다Claude에게 뭔가 시켜봤다 (목록 조회, 요약 등)

에러가 나도 괜찮아요.claude mcp list로 상태를 확인하고, 안 되면 claude mcp remove 이름으로 삭제한 뒤 다시 추가해보세요.

활용 팁 + 출처

MCP를 쓰면서 알아두면 좋은 실용적인 팁들이에요.

1. 안 되면 /mcp에서 상태 확인

MCP 도구가 동작하지 않으면 Claude Code에서 /mcp를 입력해보세요. 연결 상태, 인증 상태를 한눈에 볼 수 있어요.

2. 서버 여러 개 써도 돼요

GitHub + Notion + Sentry를 동시에 연결해도 전혀 문제없어요. 오히려 여러 서버를 조합할 때 MCP의 진가가 나와요.

3. 필요 없으면 삭제

안 쓰는 서버는 claude mcp remove 이름으로 깔끔하게 삭제하세요. 서버가 너무 많으면 로딩이 느려질 수 있어요.

4. Windows에서 npx 안 되면

로컬 서버 추가할 때 npx가 안 되는 경우가 있어요. 이때는 cmd /c npx로 바꿔보세요. Node.js 최신 버전(22+)으로 업데이트하는 것도 방법이에요.

5. 더 많은 서버 찾기

위에 소개한 8개 외에도 수백 개의 MCP 서버가 있어요. github.com/modelcontextprotocol/servers에서 전체 목록을 확인할 수 있어요.

MCP = Claude Code의 앱스토어

앱(서버)을 설치하면 Claude가 직접 GitHub을 관리하고, 메일을 정리하고, 데이터를 분석해요. 여러분은 한국어로 지시만 하면 돼요.

한 개만 설치해도 달라져요

처음부터 여러 개 설치할 필요 없어요. GitHub 하나만 연결해도 “이게 되네?” 하는 순간이 올 거예요. 그때 하나씩 추가하면 돼요.

참고 자료

Anthropic 공식 MCP 문서 — docs.anthropic.com/en/docs/claude-code/mcp
MCP 공식 서버 목록 — github.com/modelcontextprotocol/servers
Model Context Protocol 사양 — modelcontextprotocol.io/specification/2025-11-25
Claude Code Remote MCP — anthropic.com/news/claude-code-remote-mcp
MCP 2026 로드맵 — blog.modelcontextprotocol.io/posts/2026-mcp-roadmap

MCP = Claude Code에 앱을 추가하는 것

어떤 앱들이 있을까?

업무 도구

개발 도구

데이터

커뮤니케이션

모니터링

디자인

실제로 이렇게 씁니다

1. GitHub — 코드 관리

2. Sentry — 에러 추적

3. Notion — 문서 관리

4. Gmail — 메일 관리

5. PostgreSQL — 데이터 조회

설치 방법 — 딱 2가지만 알면 돼요

1. 원격 서버 (대부분 이거예요)

2. 로컬 서버 (특수한 경우)

자주 쓰는 예시 3개

지금 바로 설치해보기

관리 명령어 3개 — 이것만 알면 돼요

인기 MCP 서버 — 복붙으로 바로 설치

GitHub

Sentry

Notion

Slack

Linear

PostgreSQL

Figma

Playwright

로그인이 필요한 서버

전체 과정 — 3단계면 끝

설치 범위 — 보통 기본값이면 충분해요

기본 (Local)

팀 공유 (Project)

모든 프로젝트 (User)

더 편하게 쓰는 법

@ 멘션 — 데이터를 직접 불러오기

/ 슬래시 명령어 — 추가 기능 사용하기

MCP, 어떻게 발전해왔나

직접 해보기

실습 1: GitHub MCP 연결하기 (가장 쉬움)

실습 2: Notion MCP도 추가해보기

확인 체크리스트

활용 팁 + 출처

1. 안 되면 /mcp에서 상태 확인

2. 서버 여러 개 써도 돼요

3. 필요 없으면 삭제

4. Windows에서 npx 안 되면

5. 더 많은 서버 찾기