Skip to guide
AI Field Guide

MCP Explained Without the Hype

MCP is how AI stops guessing and starts using tools.

A builder's field guide to MCP, what it connects, when to use it, and how to start without overbuilding.

Keyword: MCP AI Fluency Education 8 minute reference Updated for the current MCP ecosystem
The big picture

A connection contract. Not a permission slip.

Select a topic to unpack it. Keep the full reference close.

01 / The connection

The connection

The host contains a client. The server exposes capabilities.

Your builder move

Name the app, connector, and service in your own workflow.

Full explanation and resources ↓
AI hostMCP clientMCP serverTools: actionsResources: contextPrompts: patternsAuthentication + scoped authorization + human review
The connection: AI host / MCP client / MCP server
02 / Capabilities

Capabilities

Tools act. Resources inform. Prompts guide.

Your builder move

Pick only the capability your repeated task needs.

Full explanation and resources ↓
AI hostMCP clientMCP serverTools: actionsResources: contextPrompts: patternsAuthentication + scoped authorization + human review
Capabilities: Tool / Resource / Prompt
03 / When it fits

When it fits

Repeated tool access is the reason to connect.

Your builder move

Use chat for one-off answers; connect one useful workflow first.

Full explanation and resources ↓
AI hostMCP clientMCP serverTools: actionsResources: contextPrompts: patternsAuthentication + scoped authorization + human review
When it fits: Repeated task / Shared contract / Useful access
04 / Start safely

Start safely

One read-only integration is a better first win.

Your builder move

Define predictable inputs, outputs, authentication, and logs.

Full explanation and resources ↓
AI hostMCP clientMCP serverTools: actionsResources: contextPrompts: patternsAuthentication + scoped authorization + human review
Start safely: Read-only / Test + inspect / Controlled rollout
05 / Permissions

Permissions

Tool access changes the risk of the work.

Your builder move

Authorize per capability and require human review before writes.

Full explanation and resources ↓
AI hostMCP clientMCP serverTools: actionsResources: contextPrompts: patternsAuthentication + scoped authorization + human review
Permissions: Least privilege / Human approval / Audit trail
Keep going

The complete field reference.

All original explanations, checklists, prompts, and reading links. Open only what you need.

Key context

The plain-English version

MCP gives AI apps a standard way to reach tools, files, data, and workflows through controlled servers.

The builder move

Do not start by connecting everything. Start with one repeated workflow and one safe tool.

The risk to manage

Tool access turns AI from drafting partner into operator. Permissions, review, and logs matter.

The model asks. The client brokers. The server exposes capabilities.
Mental model

The model asks. The client brokers. The server exposes capabilities.

MCP is an open protocol for connecting AI hosts to servers that expose capabilities. The point is not magic. The point is a shared contract, so builders do not need custom glue code for every app, tool, and data source.

  • Host: the AI app or agent experience where the user works.
  • Client: the protocol-speaking connector inside that host.
  • Server: the service that exposes capabilities over MCP.
  • Capability: a tool, resource, or prompt the assistant can discover and use.
Tools, resources, and prompts are the core pieces.
Building blocks

Tools, resources, and prompts are the core pieces.

A useful MCP setup is not magic. It is a small menu of capabilities the assistant can call when the workflow needs them.

Tool

An action with defined inputs and outputs, like search issues, query a database, create a branch, or open a browser page.

Resource

Readable context, like a file, schema, document, ticket, or knowledge base entry.

Prompt

A reusable instruction pattern, like summarize this repo, draft a release note, or analyze this issue queue.

  • If the model needs to do something, think tool.
  • If the model needs to read something, think resource.
  • If the team needs a repeatable instruction pattern, think prompt.
Use MCP when the workflow repeats.
Decision rule

Use MCP when the workflow repeats.

If you only need one answer, chat may be enough. If the assistant repeatedly needs the same tool, file, API, or system of record, MCP starts to make sense.

  • Good fit: repeated work with clear inputs and outputs.
  • Good fit: read-only access to context the assistant needs often.
  • Good fit: team workflows where the same tool connection can be reused.
  • Bad fit: one-off tasks, unclear data boundaries, or sensitive writes without approval.
Start with one safe integration.
Builder checklist

Start with one safe integration.

The first win is not a giant agent stack. The first win is a narrow capability that removes repeated copy-paste and still gives humans control.

  • Name one workflow you repeat every week.
  • Write the outcome in one sentence.
  • List the minimum context the assistant needs.
  • Define the exact jobs the server should support.
  • Start with the minimum set of tools and resources.
  • Write tight input schemas and predictable outputs.
  • Choose read-only access first.
  • Decide transport and authentication before rollout.
  • Add a human review point before any write action.
  • Log what the tool did and what it touched.
  • Test with an inspector or low-risk workflow before broader use.
MCP makes permissions a product decision.
Trust layer

MCP makes permissions a product decision.

Once an assistant can use tools, security stops being an afterthought. The safest MCP workflow is scoped, inspectable, and easy to turn off.

  • Use authentication for every sensitive endpoint.
  • Authorize per tool and per resource, not only per server.
  • Use least privilege credentials.
  • Add explicit allowlists for dangerous actions.
  • Keep secrets out of prompts and generated content.
  • Prefer read-only until the workflow proves value.
  • Require approval before writes, deletes, payments, or messages.
  • Use rate limits, timeouts, and clear failure behavior.
  • Keep logs so a human can understand what happened.
Use this to plan your first workflow
Starter prompt

Use this to plan your first workflow

I want to design one safe MCP workflow. Ask me for the workflow, the tool or data source, the minimum context needed, the action the assistant should take, the risk level, the approval point, and the log I should keep. Then give me a small first version that starts read-only.

Keep these terms straight
Glossary

Keep these terms straight

MCP
Model Context Protocol, a standard for connecting AI apps to external capabilities.
Host
The AI app or agent environment where the user works.
Client
The protocol layer that connects the host to MCP servers.
Server
The service that exposes tools, resources, or prompts.
Tool
A callable action the assistant can use.
Resource
Context the assistant can read.
Prompt
A reusable workflow instruction.
Transport
How the client and server communicate, often local stdio or remote HTTP.
Scope
The boundary around what the assistant can access or do.
Repos worth studying
GitHub repo patterns

Repos worth studying

modelcontextprotocol/servers
88,988 stars | TypeScript

Reference servers show the core patterns and also warn that examples are not production-ready by default.

github/github-mcp-server
31,793 stars | Go

GitHub's server shows how issues, pull requests, files, and reviews become an AI-accessible workflow surface.

modelcontextprotocol/inspector
10,511 stars | TypeScript

Inspector-style tooling reminds builders to test the server before putting it inside real work.

Read next
Sources

Read next

MCP Example Servers

Use examples to see how different servers expose real capabilities, then decide what belongs in your own workflow.

modelcontextprotocol/servers

Reference servers are useful for learning patterns, but the repo warns that examples are not production-ready by default.

GitHub MCP Server

A practical example of turning issues, pull requests, files, and reviews into an AI-accessible workflow surface.

Technology has seven layers. We're the eighth.
Layer8Culture

Technology has seven layers. We're the eighth.

Follow Layer8Culture for practical AI fluency, creator systems, and build-in-public experiments.

← All AI Field Guides