mcp-for-beginners

다음 단계를 따라 이 리소스들을 사용해 시작해 보세요:

저장소 포크하기 : 클릭
저장소 클론하기 : git clone https://github.com/microsoft/mcp-for-beginners.git
참여하기

🌐 다국어 지원
Co-op Translator로 유지 관리되는 번역

아랍어 | 벵골어 | 불가리아어 | 버마어(미얀마) | 중국어(간체) | 중국어(번체, 홍콩) | 중국어(번체, 마카오) | 중국어(번체, 대만) | 크로아티아어 | 체코어 | 덴마크어 | 네덜란드어 | 에스토니아어 | 핀란드어 | 프랑스어 | 독일어 | 그리스어 | 히브리어 | 힌디어 | 헝가리어 | 인도네시아어 | 이탈리아어 | 일본어 | 칸나다어 | 크메르어 | 한국어 | 리투아니아어 | 말레이어 | 말라얄람어 | 마라티어 | 네팔어 | 나이지리아 피진 | 노르웨이어 | 페르시아어(파르시) | 폴란드어 | 포르투갈어(브라질) | 포르투갈어(포르투갈) | 펀자브어(구르무키) | 루마니아어 | 러시아어 | 세르비아어(키릴) | 슬로바키아어 | 슬로베니아어 | 스페인어 | 스와힐리어 | 스웨덴어 | 타갈로그어(필리핀어) | 타밀어 | 텔루구어 | 태국어 | 터키어 | 우크라이나어 | 우르두어 | 베트남어

로컬에 클론하는 것을 선호하시나요?

이 저장소에는 50개 이상의 언어 번역이 포함되어 있어 다운로드 크기가 크게 증가합니다. 번역 없이 클론하려면 sparse checkout을 사용하세요:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone ' /* ' ' !translations ' ' !translated_images '
CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
git sparse-checkout set --no-cone " /* " " !translations" "! translated_images "
이렇게 하면 과정을 완료하는 데 필요한 모든 것을 훨씬 빠르게 다운로드할 수 있습니다.

🚀 초보자를 위한 Model Context Protocol (MCP) 커리큘럼
C#, Java, JavaScript, Rust, Python, TypeScript로 된 실습 코드 예제로 MCP 배우기
🧠 Model Context Protocol 커리큘럼 개요
Model Context Protocol 여정에 오신 것을 환영합니다! AI 애플리케이션이 다양한 도구 및 서비스와 어떻게 통신하는지 궁금해한 적이 있다면, 개발자들이 지능형 시스템을 구축하는 방식을 변화시키고 있는 우아한 해결책을 곧 발견하게 될 것입니다.

MCP를 AI 애플리케이션을 위한 범용 번역기라고 생각해 보세요. USB 포트로 어떤 장치든 컴퓨터에 연결할 수 있는 것처럼, MCP는 AI 모델이 표준화된 방식으로 어떤 도구나 서비스에도 연결할 수 있게 해줍니다. 첫 챗봇을 만들든 복잡한 AI 워크플로를 작업하든, MCP를 이해하면 더 유능하고 유연한 애플리케이션을 만들 수 있는 힘을 얻게 됩니다.

이 커리큘럼은 여러분의 학습 여정을 위해 인내심과 정성을 담아 설계되었습니다. 이미 이해하고 있는 간단한 개념부터 시작해, 좋아하는 프로그래밍 언어로 된 실습을 통해 점진적으로 전문성을 쌓아갑니다. 모든 단계에는 명확한 설명, 실용적인 예제, 그리고 많은 격려가 담겨 있습니다.

이 여정을 마칠 때쯤이면 자신만의 MCP 서버를 구축하고, 인기 있는 AI 플랫폼과 통합하며, 이 기술이 AI 개발의 미래를 어떻게 재편하고 있는지 이해할 수 있는 자신감을 갖게 될 것입니다. 이 흥미진진한 모험을 함께 시작해 봅시다!

공식 문서 및 사양
현재 프로토콜 개정판은 MCP Specification 2026-07-28 입니다. MCP
사양은 날짜 기반 버전 관리(YYYY-MM-DD 형식)를 사용하여 프로토콜
호환성을 명확히 합니다.

버전 참고: 이 커리큘럼은 무상태 요청, Extensions 프레임워크, 그리고
Roots, Sampling, Logging의 지원 중단을 포함한 현재의 2026-07-28
개념을 가르칩니다. 일부 실습 예제는 SDK 지원이 따라잡을 때까지
2025-11-25로 명시적으로 버전이 지정되어 있습니다. 변경 사항과 마이그레이션
안내는 What's Changed in MCP: The 2026-07-28 Specification
을 참조하세요.

이 리소스들은 여러분의 이해가 깊어질수록 더 가치 있어지지만, 모든 것을 즉시 읽어야 한다는 부담은 갖지 마세요. 가장 관심 있는 분야부터 시작하세요!

📘 MCP 문서 – 단계별 튜토리얼과 사용자 가이드를 위한 필수 리소스입니다. 문서는 초보자를 염두에 두고 작성되어, 자신의 속도에 맞춰 따라 할 수 있는 명확한 예제를 제공합니다.
📜 MCP 사양 – 포괄적인 참조 매뉴얼이라고 생각하세요. 커리큘럼을 진행하다 보면 특정 세부 사항을 찾아보고 고급 기능을 탐색하기 위해 여기로 다시 돌아오게 될 것입니다.
📜 MCP 사양 버전 관리 – 프로토콜 버전 이력과 MCP가 날짜 기반 버전 관리(YYYY-MM-DD 형식)를 사용하는 방식에 대한 정보가 담겨 있습니다.
🧑‍💻 MCP GitHub 저장소 – 여러 프로그래밍 언어로 된 SDK, 도구, 코드 샘플을 찾을 수 있습니다. 실용적인 예제와 바로 사용할 수 있는 구성 요소의 보물창고와 같습니다.
🌐 MCP 커뮤니티 – MCP에 관한 토론에서 동료 학습자와 숙련된 개발자들과 함께하세요. 질문이 환영받고 지식이 자유롭게 공유되는 지지적인 커뮤니티입니다.

학습 목표
이 커리큘럼을 마치면 새로운 능력에 대해 자신감과 설렘을 느끼게 될 것입니다. 여러분이 성취하게 될 것은 다음과 같습니다:

• MCP 기본 이해 : Model Context Protocol이 무엇이며 왜 AI 애플리케이션이 함께 작동하는 방식을 혁신하고 있는지, 이해하기 쉬운 비유와 예제를 통해 파악하게 됩니다.

• 첫 MCP 서버 구축 : 선호하는 프로그래밍 언어로 작동하는 MCP 서버를 만들며, 간단한 예제부터 시작해 단계적으로 기술을 키워갑니다.

• AI 모델을 실제 도구에 연결 : AI 모델과 실제 서비스 사이의 간극을 메우는 방법을 배워, 애플리케이션에 강력한 새 기능을 부여합니다.

• 보안 모범 사례 구현 : MCP 구현을 안전하고 보안성 있게 유지하는 방법을 이해하여, 애플리케이션과 사용자 모두를 보호합니다.

• 자신 있게 배포 : MCP 프로젝트를 개발에서 프로덕션으로 전환하는 방법을 알게 되며, 실제 환경에서 작동하는 실용적인 배포 전략을 익힙니다.

• MCP 커뮤니티 참여 : AI 애플리케이션 개발의 미래를 만들어가는 성장하는 개발자 커뮤니티의 일원이 됩니다.

필수 배경 지식
MCP 세부 사항으로 들어가기 전에, 몇 가지 기초 개념에 익숙해지도록 합시다. 이 분야의 전문가가 아니어도 걱정하지 마세요. 진행하면서 필요한 모든 것을 설명해 드립니다!

프로토콜 이해하기 (기초)
프로토콜을 대화의 규칙이라고 생각해 보세요. 친구에게 전화하면, 둘 다 받을 때 "여보세요"라고 말하고, 번갈아 말하며, 끝나면 "안녕"이라고 말한다는 것을 압니다. 컴퓨터 프로그램도 효과적으로 통신하려면 비슷한 규칙이 필요합니다.

MCP는 프로토콜입니다. AI 모델과 애플리케이션이 도구 및 서비스와 생산적인 "대화"를 나누도록 돕는 합의된 규칙의 집합입니다. 대화 규칙이 있으면 인간의 의사소통이 더 원활해지는 것처럼, MCP가 있으면 AI 애플리케이션의 의사소통이 훨씬 더 신뢰할 수 있고 강력해집니다.

클라이언트-서버 관계 (프로그램이 함께 작동하는 방식)
여러분은 이미 매일 클라이언트-서버 관계를 사용하고 있습니다! 웹 브라우저(클라이언트)를 사용해 웹사이트를 방문하면, 페이지 콘텐츠를 보내주는 웹 서버에 연결됩니다. 브라우저는 정보를 요청하는 방법을 알고, 서버는 응답하는 방법을 압니다.

MCP에서도 비슷한 관계가 있습니다. AI 모델은 정보나 작업을 요청하는 클라이언트 역할을 하고, MCP 서버는 그러한 기능을 제공합니다. AI가 특정 작업을 수행하도록 요청할 수 있는 유용한 조수(서버)가 있는 것과 같습니다.

표준화가 중요한 이유 (함께 작동하게 만들기)
모든 자동차 제조사가 서로 다른 모양의 주유 펌프를 사용한다고 상상해 보세요. 자동차마다 다른 어댑터가 필요할 것입니다! 표준화란 사물이 매끄럽게 함께 작동하도록 공통 접근 방식에 합의하는 것을 의미합니다.

MCP는 AI 애플리케이션에 이러한 표준화를 제공합니다. 모든 AI 모델이 모든 도구와 작동하기 위해 맞춤 코드를 필요로 하는 대신, MCP는 이들이 소통할 수 있는 보편적인 방법을 만듭니다. 즉, 개발자는 도구를 한 번 구축하면 여러 다양한 AI 시스템과 함께 작동하게 할 수 있습니다.

🧭 학습 경로 개요
여러분의 MCP 여정은 자신감과 기술을 점진적으로 쌓을 수 있도록 신중하게 구성되어 있습니다. 각 단계는 이미 배운 것을 강화하면서 새로운 개념을 소개합니다.

🌱 기초 단계: 기본 이해 (모듈 0-2)
여기서 모험이 시작됩니다! 익숙한 비유와 간단한 예제를 사용해 MCP 개념을 소개합니다. MCP가 무엇인지, 왜 존재하는지, 그리고 AI 개발의 더 큰 세계에서 어떻게 자리 잡는지 이해하게 됩니다.

• 모듈 0 - MCP 소개 : MCP가 무엇이며 현대 AI 애플리케이션에 왜 그렇게 중요한지 탐구하는 것으로 시작합니다. 실제 사례에서 작동하는 MCP를 보고, 개발자들이 직면하는 일반적인 문제를 어떻게 해결하는지 이해하게 됩니다.

• 모듈 1 - 핵심 개념 설명 : 여기서 MCP의 필수 구성 요소를 배웁니다. 이러한 개념이 자연스럽고 이해하기 쉽게 느껴지도록 많은 비유와 시각적 예제를 사용합니다.

• 모듈 2 - MCP의 보안 : 보안은 위협적으로 들릴 수 있지만, MCP에 내장된 안전 기능을 보여주고 처음부터 애플리케이션을 보호하는 모범 사례를 가르쳐 드립니다.

🔨 구축 단계: 첫 구현 만들기 (모듈 3)
이제 진짜 재미가 시작됩니다! 실제 MCP 서버와 클라이언트를 구축하는 실습 경험을 하게 됩니다. 걱정하지 마세요. 간단하게 시작해 모든 단계를 안내해 드립니다.

이 모듈에는 선호하는 프로그래밍 언어로 연습할 수 있는 여러 실습 가이드가 포함되어 있습니다. 첫 서버를 만들고, 연결할 클라이언트를 구축하며, VS Code 같은 인기 개발 도구와 통합하기까지 합니다.

각 가이드에는 완전한 코드 예제, 문제 해결 팁, 그리고 특정 설계 선택을 하는 이유에 대한 설명이 포함되어 있습니다. 이 단계를 마치면 자랑스러워할 수 있는 작동하는 MCP 구현을 갖게 됩니다!

🚀 성장 단계: 고급 개념과 실제 적용 (모듈 4-5)
기본을 마스터했으니, 더 정교한 MCP 기능을 탐구할 준비가 되었습니다. 실용적인 구현 전략, 디버깅 기법, 멀티모달 AI 통합 같은 고급 주제를 다룹니다.

또한 MCP 구현을 프로덕션 용도로 확장하고 Azure 같은 클라우드 플랫폼과 통합하는 방법도 배웁니다. 이 모듈들은 실제 요구 사항을 처리할 수 있는 MCP 솔루션을 구축하도록 준비시켜 줍니다.

🌟 숙달 단계: 커뮤니티와 전문화 (모듈 6-11)
마지막 단계는 MCP 커뮤니티에 참여하고 가장 관심 있는 분야를 전문화하는 데 초점을 맞춥니다. 오픈소스 MCP 프로젝트에 기여하는 방법, 고급 인증 패턴 구현, 데이터베이스 통합 솔루션 구축 등을 배웁니다.

모듈 11은 특별히 언급할 가치가 있습니다. PostgreSQL 통합을 갖춘 프로덕션 준비 완료 MCP 서버를 구축하도록 가르치는 완전한 13개 실습 학습 경로입니다. 배운 모든 것을 종합하는 캡스톤 프로젝트와 같습니다!

📚 전체 커리큘럼 구조

모듈
주제
설명
링크

모듈 0-3: 기초

00
MCP 소개
Model Context Protocol 개요와 AI 파이프라인에서의 중요성
더 보기

01
핵심 개념 설명
핵심 MCP 개념에 대한 심층 탐구
더 보기

1.1
MCP의 변경 사항 (2026-07-28)
현재 사양의 무상태 프로토콜, Extensions 프레임워크, 기능 지원 중단
가이드

02
MCP의 보안
보안 위협과 모범 사례
더 보기

2.1
CIMD 및 DCR 인증
보호된 MCP 서버를 사용해 선호되는 CIMD 등록과 지원 중단된 DCR 폴백 비교
샘플

03
MCP 시작하기
환경 설정, 기본 서버/클라이언트, 통합
더 보기

모듈 3: 첫 서버 및 클라이언트 구축

3.1
첫 서버
첫 MCP 서버 만들기
가이드

3.2
첫 클라이언트
기본 MCP 클라이언트 개발
가이드

3.3
LLM을 사용한 클라이언트
대규모 언어 모델 통합
가이드

3.4
VS Code 통합
VS Code에서 MCP 서버 사용
가이드

3.5
stdio 서버
stdio 전송을 사용해 서버 만들기
가이드

3.6
HTTP 스트리밍
MCP에서 HTTP 스트리밍 구현
가이드

3.7
Microsoft Foundry Toolkit
MCP와 함께 Microsoft Foundry Toolkit 사용
가이드

3.8
테스트
MCP 서버 구현 테스트
가이드

3.…