Model Context Protocol 실전
AI로 번역함. 영어 원문을 사람이 검증함. 우리가 책을 만드는 방식
영어판 2026.11.14판을 번역한 것이다. 원문 읽기
에이전트를 위한 도구와 데이터를 다룬다. API를 아는 엔지니어를 대상으로, MCP가 HTTP API에 무엇을 더하는지와 MCP가 잘못된 선택이 되는 경우를 설명하고, 명세 개정판 2026-07-28을 기준으로 Python SDK인 mcp 2.x를 사용해 MCP 서버와 클라이언트를 설계하고 구축하고 보호하고 테스트하고 운영하는 방법을 다룬다. 2025년 개정판에서 옮겨 가는 이전 경로도 함께 제시한다.
대상 독자 HTTP API를 만들거나 호출해 본 엔지니어 가운데, 이제 에이전트에 도구와 데이터를 제공하거나 에이전트를 다른 사람의 시스템에 연결해야 하는 독자를 위한 책이다. 머신러닝 배경지식은 필요하지 않다.
Kindle 또는 모든 전자책 리더기에서 읽는다
EPUB은 Apple Books, Kobo 및 대부분의 전자책 단말기에서도 사용할 수 있다.
Kindle로 보내기
이 판의 EPUB을 보냅니다 한국어.
-
우리 주소 승인하기
아마존은 승인된 주소에서 보낸 파일만 킨들로 전달한다. 파일을 이메일로 보내는 서비스마다 한 번씩 승인해야 한다. 우리 주소를 승인된 개인 문서 이메일 목록에 추가한다.
books@rollingedition.comAmazon 개인 문서 설정 열기. Amazon에서는 콘텐츠 및 기기 관리, 환경설정, 개인 문서 설정에 있다.
보냈다. 몇 분 안에 Kindle 서재에 나타난다.
도서가 도착하지 않으면 대부분 1단계의 승인 문제이다. books@rollingedition.com가 승인된 개인 문서 이메일 목록에 있는지 확인한다.
저장한 책의 새 판은 Kindle로도 전송된다.
Kindle 주소가 아니다. 주소는 @kindle.com으로 끝나며, Amazon의 개인 문서 설정에서 찾을 수 있다.
오늘 {count}권의 책을 보냈으며, 이는 한 계정이 하루에 받을 수 있는 최대치입니다. 내일 다시 시도하세요.
오늘 보낼 수 있는 도서는 모두 보냈다. 내일 다시 시도하라.
책을 보내지 못했다. 몇 분 후 다시 시도한다.
이 판은 용량이 커서 이메일로 보낼 수 없다.
Kindle로 보내기는 Labs와 함께 제공된다.
Kindle 주소가 아니다. 주소는 @kindle.com으로 끝나며, Amazon의 개인 문서 설정에서 찾을 수 있다.
책을 보내지 못했다. 몇 분 후 다시 시도한다.
또는 EPUB을 내려받아 Amazon의 Send to Kindle 페이지에 끌어다 놓는다.
Kindle is a trademark of Amazon.com, Inc.
목차
12장, 읽는 데 약 13시간 18분, 70개 예제 포함.
-
1MCP end to end
By the end of this chapter you can put an existing HTTP API behind a Model Context Protocol server over stdio, call its tool from a client, read every message the two exchange, and let a model choose the tool through a small host.
-
2MCP가 API에 더하는 것
이 장을 마치면 호스트, 클라이언트, 서버가 각각 무엇을 하는지 설명할 수 있다. 상점의 각 기능을 알맞은 Model Context Protocol 프리미티브에 배치할 수 있다. 모든 요청이 싣고 다니는 버전과 기능(capabilities)을 읽을 수 있다. 상점이 일반 HTTP API를 그대로 두어야 하는 경우도 판단할 수 있다. 이 장의 주장과 예제는 명세의 2026-07-28 개정판과 Python SDK인
mcp의 2.3.0 버전에 맞춘 것이다. -
3모델이 사용할 수 있는 도구 설계하기
이 장을 마치면 the shop의 API를 Model Context Protocol 도구로 바꿀 수 있다. 이 도구의 이름, 설명, 입력 스키마, 결과, 오류는 모델이 그에 따라 행동할 수 있어야 한다. 또한 설명 하나를 바꾸었을 때 모델이 선택하는 도구가 어떻게 달라지는지도 측정할 수 있다. 이어지는 내용은 명세의 2026-07-28 개정판과 Python SDK인
mcp2.3.0에 적용된다. -
4Serve data as resources and prompts
By the end of this chapter you can publish the shop's policies and records as Model Context Protocol resources, address many records with one resource template, complete an argument while a user types it, tell a client when a resource changes, and package a refund review as a prompt the user can pick.
-
5Ask the user in the middle of a call
By the end of this chapter you can make the shop's refund tool stop in the middle of a call, ask the person at the host to confirm a refund, and carry on with the answer, using Model Context Protocol elicitation inside a Multi Round-Trip Request on a server that keeps no call open while it waits.
-
6Streamable HTTP로 서비스하기
이 장을 마치면 상점의 Model Context Protocol 서버를 Streamable HTTP로 서비스하고, 각 요청과 응답에 무엇이 담기는지 읽고, 오래 걸리는 호출의 진행 상황을 스트리밍하고 그 호출을 취소하고, 스티키 세션 없이 하나의 주소 뒤에서 서버를 복제본으로 실행하고, 브라우저가 속아서 보낸 요청을 거부할 수 있다. 이 장의 내용은 명세의 2026-07-28 리비전과 Python SDK인
mcp의 2.3.0 버전에서 유효하다. -
7Run long work as tasks
By the end of this chapter you can negotiate a Model Context Protocol extension, run a slow restock report as a task that the client polls, let tasks expire and cancel them, and say what MCP Apps add to a tool.
-
8OAuth로 클라이언트 인가하기
이 장을 마치면 상점의 Model Context Protocol 서버를 OAuth로 보호할 수 있다. 클라이언트를 인가 서버로 안내하는 메타데이터를 게시하고, Client ID Metadata Document로 지원팀의 호스트를 식별하며, PKCE로 토큰을 얻는다. 또 상점의 서버를 위해 발급된 토큰만 받아들이고, 각 응답의 발급자(issuer)로 혼동 공격(mix-up attack)을 잡아내며, 도구마다 스코프를 요구하고 환불에 더 높은 권한이 필요할 때는 단계 상승(step-up)을 적용한다. 이 장의 주장은 프로토콜 리비전 2026-07-28의 명세에 따른 것이며, Python SDK인
mcp2.3.0이 이를 구현한 방식을 따른다. -
9도구를 오용으로부터 보호하기
이 장을 마치면 Model Context Protocol 서버와 그 호스트 주위에 신뢰 경계를 그리고, 토큰 패스스루를 거부하고, 서버가 혼동된 대리인(confused deputy)으로 동작하지 않도록 막고, 도구 정의를 고정하여 변경된 정의를 탐지하고, 티켓 텍스트를 데이터로 취급하고, 부작용이 있는 모든 도구 호출 전에 사용자에게 확인을 구할 수 있다. 여기에 담긴 내용은 모두 사양의 2026-07-28 리비전과 Python SDK인
mcp의 2.3.0 버전에서 유효하다. -
10티켓을 처리하는 호스트 만들기
이 장을 마치면 호스트를 여러 Model Context Protocol 서버에 연결하고, 서로 충돌할 수 없도록 각 서버의 도구에 이름을 붙이고, 모델이 도구를 호출하고 그 결과를 읽는 짧은 루프를 실행하고, 사용자를 대신해 서버의 입력 요청에 응답하고, 리소스를 모델의 컨텍스트에 넣고, 이 모든 과정으로 티켓 큐를 처리할 수 있다. 이 장의 주장과 코드는 명세의 2026-07-28 개정판과 Python SDK인
mcp2.3.0에서 성립한다. -
11서버를 테스트하고 실행을 관찰하기
이 장을 마치면 Model Context Protocol 서버의 도구를 메모리 안에서와 HTTP로 테스트하고, 클라이언트를 깨뜨릴 스키마 변경을 배포 전에 잡아내고, 기록된 호스트 실행을 회귀 테스트로 재생하고, OpenTelemetry로 도구 호출을 추적하고, 모델이 올바른 도구를 고르는 빈도를 측정하고, 도구를 사용하는 클라이언트를 깨뜨리지 않고 그 도구를 퇴역시킬 수 있다. 여기서 프로토콜에 관한 설명은 사양의 2026-07-28 리비전에 대해 성립하고, SDK에 관한 설명은 Python SDK인
mcp2.3.0에 대해 성립한다. -
122025년형 서버 이전하기
이 장을 마치면 2025년 개정판들과 Python SDK의 1.x 계열에 맞춰 작성한 Model Context Protocol 서버를 사양의 2026-07-28 개정판과
mcp2.3.0로 옮길 수 있다. 목표에 관한 설명은 모두 그 개정판과 SDK 버전에서 성립한다. 서버가 무엇에 의존하는지 찾아내고, 세션을 제거하고, HTTP+SSE 전송에서 벗어나게 하고, 샘플링, 루트, 로깅, 동적 클라이언트 등록을 대체하고, 코드를 이식한다. 그리고 옛 클라이언트가 남아 있는 동안 두 시대의 클라이언트를 모두 지원한다.