MCP SDK의 튜토리얼대로 tools/call을 구현하면, MCP 서버는 '작동'합니다. 하지만 '작동하는 것'과 'AI가 망설임 없이 능숙하게 사용하는 것'은 별개의 문제입니다. 설명문이 모호하여 AI가 도구 선택에 망설이거나, 응답이 JSON뿐이라 AI가 매번 해독 비용을 지불하거나, 서버 내부에서 AI 추론을 떠안고 소리 없이 중단되는——그러한 "작동은 하지만, 제대로 활용되지는 못하는" MCP 서버가 실제로 양산되고 있습니다.

그 상황에서 2026-07-28의 사양 개정이 찾아왔습니다. initialize 핸드셰이크(handshake)와 Mcp-Session-Id가 사라지면서, MCP는 명시적으로 스테이트리스 코어(stateless core)가 되었습니다. 기존 구현을 이행하려는 사람에게는 큰 변경이지만, 설계 원칙까지 사라진 것은 아닙니다. 상태는 프로토콜이 아니라 애플리케이션이 가진다——세션이 아니라 영속 핸들(persistent handle). 이것은 새로운 사양의 요구사항인 동시에, "작동하는 것"과 "AI가 능숙하게 사용하는 것"을 가르는 설계 판단의 연장선상에 있습니다.

본서는 가상의 스타트업 분석 도구인 startup-analyzer를 전편 공통의 소재로 하여, 확정된 2026-07-28 사양을 토대로 한 MCP 서버 개발의 판단 기준을 5부 구성·총 35장으로 체계화했습니다.

대상 독자

• MCP를 막 사용하기 시작하여, 우선 개요와 리스크를 파악하고 싶은 분
• Node.js + TypeScript로 MCP 서버를 구현하고 싶지만 "AI에게 사용하기 쉬운 도구"의 설계 기준으로 고민하고 있는 초급~중급 엔지니어
• CLI 도구 개발 경험을 MCP 서버 개발에 활용하고 싶은 분
• stdio 서버를 만든 경험이 있으며, 원격화·OAuth·수익화를 포함하여 서비스로서 제공하고 싶은 중급 엔지니어
• 2026-07-28의 사양 개정으로 무엇이 바뀌었는지 정리하고 싶은, 기존 구현을 이행 중인 분
• 팀에 MCP 개발 "가이드라인"을 정비하고 싶은 분

본서에서 다루지 않는 것

• JavaScript / TypeScript 자체에 대한 입문
• MCP 클라이언트·호스트 애플리케이션의 구현
• Python SDK를 이용한 본격적인 개발 (TypeScript SDK와의 차이 소개에 그칩니다)
• 특정 결제 SDK·과금 프로바이더의 상세한 API