Understanding MCP

What is Model Context Protocol?

5 min read

MCP Mastery knowledge map — the five modules and the capstone they build toward

The Model Context Protocol (MCP) is an open standard introduced by Anthropic on November 25, 2024 that enables AI assistants to securely connect with external data sources and tools. Think of it as a universal adapter that allows AI models to interact with your databases, APIs, file systems, and other services. Since launch, MCP has been adopted by Anthropic, OpenAI, Microsoft, Google, AWS, and thousands of third-party developers, becoming the de facto standard for AI-to-tool connectivity.

The Problem MCP Solves

Before MCP, connecting AI assistants to external systems required:

  • Custom API integrations for each service
  • Repeated implementation of similar patterns
  • Security concerns with direct API access
  • No standardized way to expose data to AI

MCP provides a standardized protocol that solves all these problems.

How MCP Works

MCP follows a client-server architecture:

ComponentRole
MCP HostThe AI application (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, etc.)
MCP ClientProtocol handler within the host
MCP ServerYour service that exposes tools/resources

Only the third box is yours to write. The first two already exist inside the app you're using.

One question, four hops

"search my repo"tools/callresultgrounded answerHostClaude Desktop, Claude Code, Cu…MCP ClientShips inside the host. Speaks t…MCP ServerThe only box you write. Your da…

What MCP Servers Can Expose

Three capability types, and picking the wrong one is the most common design mistake in a first server. The split is about side effects, not about how the data feels.

Tools vs Resources vs Prompts

Actions

Tools

What it isA function the model can call
Who decidesThe model, mid-conversation
Side effectsAllowed — this is the point
Examplesearch_code, create_issue
Pros
  • The model can act, not just read
  • Arguments are validated by your schema
Cons
  • Every tool widens what the model can do to your systems
  • Needs a clear description or it gets called at the wrong moment
Data

Resources

What it isReadable content behind a URI
Who decidesHost or user picks what to attach
Side effectsNone — read-only by contract
Exampledoc://123, file:///var/log/app.log
Pros
  • Safe to expose broadly
  • URIs make content predictable and cacheable
Cons
  • Cannot change anything
  • Large resources eat context fast
Templates

Prompts

What it isA reusable message template
Who decidesThe user picks it from the host UI
Side effectsNone until a tool runs
Exampledraft-followup-post, code_review
Pros
  • Turns tribal knowledge into a repeatable starting point
  • Arguments keep it flexible without rewriting
Cons
  • Easy to forget — hosts surface them less prominently than tools
  • Not invoked by the model on its own

Real-World Examples

The official MCP registry and community now host thousands of servers. A few popular ones:

  • GitHub MCP Server: Search repos, create issues, manage PRs
  • Slack MCP Server: Send messages, search channels
  • Postgres MCP Server: Query and update database records
  • Filesystem MCP Server: Read/write local files
  • Google Drive MCP Server: Read and search Drive documents
  • Puppeteer MCP Server: Browser automation for AI agents
  • Brave Search MCP Server: Web search as a tool

You can browse the official registry at registry.modelcontextprotocol.io.

Build checkpoint — do this before the next lesson

You don't need code yet, but you DO need to commit to:

  1. Which repos will your capstone MCP server expose? Pick 1–3 repos you'd actually want Claude to search/read/file issues in. Can be personal, team, or public — just repos you own.
  2. Generate a GitHub Personal Access Token with repo scope at https://github.com/settings/tokens. Save it somewhere secure — you'll paste it into .env at Module 5's capstone.
  3. Install Claude Desktop (https://claude.ai/download) if you haven't already. All the hands-on work runs through its MCP connection.

In the next lesson, we'll explore MCP's architecture in detail. :::

Quiz

Module 1 Quiz: MCP Fundamentals

Take Quiz
Was this lesson helpful?

Sign in to rate