Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Who This Is For and How to Read It

This book is for people who need MCP to work in production:

  • A developer building an MCP server for an internal tool, SaaS API, or local workflow.
  • A technical lead deciding whether MCP is the right abstraction for a product surface.
  • A platform or security engineer who will have to review, deploy, monitor, or govern MCP systems.
  • A consultant or solutions architect translating business requirements into an LLM-facing interface.

You get the most from it if you already understand APIs, HTTP, authentication basics, and at least one general-purpose language such as Python or TypeScript. You do not need to be an AI specialist, and you do not need prior MCP or OAuth experience. You do need to be comfortable thinking about interface design, reliability, and unintended consequences.

Front to Back, or by Track

Read front to back if you are new to MCP or are building a shared mental model for a team. Otherwise pick a route from Reader Tracks. Each chapter stands on its own, but many point back to earlier decisions; when a recommendation seems strict, the reason is usually in the chapter it links to.

Platform Material Dates Faster Than Design

Client support changes faster than design principles. Read the client chapters for the categories of behavior, approval flows and constraints they describe, then confirm the product details in current platform documentation and test with the exact client versions you ship to.

Keep the Appendices Open

The appendices are for use while building. Keep the troubleshooting, security and OAuth appendices and the Quick Reference Cards nearby; they are deliberately terse. When a term is unfamiliar, the Glossary says what it means and where it is taught.