Cover of Model Context Protocol in Practice, edition 2026.11.14, code VS53-BS53 Model Context Protocol in Practice VS53-BS53 14 editions since Nov 2026 Rolling Edition 2026.11.14

Model Context Protocol 실전

2026.11.14판 예제 통과 2026년 11월 19 70개 예제 중 70개 통과 변경 사항

AI로 번역함. 영어 원문을 사람이 검증함. 우리가 책을 만드는 방식

영어판 2026.11.14판을 번역한 것이다. 원문 읽기

에이전트를 위한 도구와 데이터를 다룬다. API를 아는 엔지니어를 대상으로, MCP가 HTTP API에 무엇을 더하는지와 MCP가 잘못된 선택이 되는 경우를 설명하고, 명세 개정판 2026-07-28을 기준으로 Python SDK인 mcp 2.x를 사용해 MCP 서버와 클라이언트를 설계하고 구축하고 보호하고 테스트하고 운영하는 방법을 다룬다. 2025년 개정판에서 옮겨 가는 이전 경로도 함께 제시한다.

대상 독자 HTTP API를 만들거나 호출해 본 엔지니어 가운데, 이제 에이전트에 도구와 데이터를 제공하거나 에이전트를 다른 사람의 시스템에 연결해야 하는 독자를 위한 책이다. 머신러닝 배경지식은 필요하지 않다.

읽기 시작
판 이력2026년 11월 이후 14판모든 판과 각 판에서 바뀐 내용
2026.11.12026.11.14
2026.11.14 · 2026년 11월 21문장 수정,새 콘텐츠30절 변경됨

목차

12장, 읽는 데 약 13시간 18분, 70개 예제 포함.

  1. 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.

  2. 2MCP가 API에 더하는 것

    이 장을 마치면 호스트, 클라이언트, 서버가 각각 무엇을 하는지 설명할 수 있다. 상점의 각 기능을 알맞은 Model Context Protocol 프리미티브에 배치할 수 있다. 모든 요청이 싣고 다니는 버전과 기능(capabilities)을 읽을 수 있다. 상점이 일반 HTTP API를 그대로 두어야 하는 경우도 판단할 수 있다. 이 장의 주장과 예제는 명세의 2026-07-28 개정판과 Python SDK인 mcp의 2.3.0 버전에 맞춘 것이다.

  3. 3모델이 사용할 수 있는 도구 설계하기

    이 장을 마치면 the shop의 API를 Model Context Protocol 도구로 바꿀 수 있다. 이 도구의 이름, 설명, 입력 스키마, 결과, 오류는 모델이 그에 따라 행동할 수 있어야 한다. 또한 설명 하나를 바꾸었을 때 모델이 선택하는 도구가 어떻게 달라지는지도 측정할 수 있다. 이어지는 내용은 명세의 2026-07-28 개정판과 Python SDK인 mcp 2.3.0에 적용된다.

  4. 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.

  5. 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.

  6. 6Streamable HTTP로 서비스하기

    이 장을 마치면 상점의 Model Context Protocol 서버를 Streamable HTTP로 서비스하고, 각 요청과 응답에 무엇이 담기는지 읽고, 오래 걸리는 호출의 진행 상황을 스트리밍하고 그 호출을 취소하고, 스티키 세션 없이 하나의 주소 뒤에서 서버를 복제본으로 실행하고, 브라우저가 속아서 보낸 요청을 거부할 수 있다. 이 장의 내용은 명세의 2026-07-28 리비전과 Python SDK인 mcp의 2.3.0 버전에서 유효하다.

  7. 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.

  8. 8OAuth로 클라이언트 인가하기

    이 장을 마치면 상점의 Model Context Protocol 서버를 OAuth로 보호할 수 있다. 클라이언트를 인가 서버로 안내하는 메타데이터를 게시하고, Client ID Metadata Document로 지원팀의 호스트를 식별하며, PKCE로 토큰을 얻는다. 또 상점의 서버를 위해 발급된 토큰만 받아들이고, 각 응답의 발급자(issuer)로 혼동 공격(mix-up attack)을 잡아내며, 도구마다 스코프를 요구하고 환불에 더 높은 권한이 필요할 때는 단계 상승(step-up)을 적용한다. 이 장의 주장은 프로토콜 리비전 2026-07-28의 명세에 따른 것이며, Python SDK인 mcp 2.3.0이 이를 구현한 방식을 따른다.

  9. 9도구를 오용으로부터 보호하기

    이 장을 마치면 Model Context Protocol 서버와 그 호스트 주위에 신뢰 경계를 그리고, 토큰 패스스루를 거부하고, 서버가 혼동된 대리인(confused deputy)으로 동작하지 않도록 막고, 도구 정의를 고정하여 변경된 정의를 탐지하고, 티켓 텍스트를 데이터로 취급하고, 부작용이 있는 모든 도구 호출 전에 사용자에게 확인을 구할 수 있다. 여기에 담긴 내용은 모두 사양의 2026-07-28 리비전과 Python SDK인 mcp의 2.3.0 버전에서 유효하다.

  10. 10티켓을 처리하는 호스트 만들기

    이 장을 마치면 호스트를 여러 Model Context Protocol 서버에 연결하고, 서로 충돌할 수 없도록 각 서버의 도구에 이름을 붙이고, 모델이 도구를 호출하고 그 결과를 읽는 짧은 루프를 실행하고, 사용자를 대신해 서버의 입력 요청에 응답하고, 리소스를 모델의 컨텍스트에 넣고, 이 모든 과정으로 티켓 큐를 처리할 수 있다. 이 장의 주장과 코드는 명세의 2026-07-28 개정판과 Python SDK인 mcp 2.3.0에서 성립한다.

  11. 11서버를 테스트하고 실행을 관찰하기

    이 장을 마치면 Model Context Protocol 서버의 도구를 메모리 안에서와 HTTP로 테스트하고, 클라이언트를 깨뜨릴 스키마 변경을 배포 전에 잡아내고, 기록된 호스트 실행을 회귀 테스트로 재생하고, OpenTelemetry로 도구 호출을 추적하고, 모델이 올바른 도구를 고르는 빈도를 측정하고, 도구를 사용하는 클라이언트를 깨뜨리지 않고 그 도구를 퇴역시킬 수 있다. 여기서 프로토콜에 관한 설명은 사양의 2026-07-28 리비전에 대해 성립하고, SDK에 관한 설명은 Python SDK인 mcp 2.3.0에 대해 성립한다.

  12. 122025년형 서버 이전하기

    이 장을 마치면 2025년 개정판들과 Python SDK의 1.x 계열에 맞춰 작성한 Model Context Protocol 서버를 사양의 2026-07-28 개정판과 mcp 2.3.0로 옮길 수 있다. 목표에 관한 설명은 모두 그 개정판과 SDK 버전에서 성립한다. 서버가 무엇에 의존하는지 찾아내고, 세션을 제거하고, HTTP+SSE 전송에서 벗어나게 하고, 샘플링, 루트, 로깅, 동적 클라이언트 등록을 대체하고, 코드를 이식한다. 그리고 옛 클라이언트가 남아 있는 동안 두 시대의 클라이언트를 모두 지원한다.

이 절 인용

형식

각 형식은 이 번역이 따르는 영문 원서를 출처로 표기한다.

모든 형식은 이 판을 명시한다. 링크는 현재 판을 열며, 여기서 절의 제목은 본문이 마지막으로 바뀐 시점을 알려 준다. 접근 날짜와 검색 날짜는 이 자료를 여는 날짜다.