AISuffer
beginner Engineers Product Managers

What Is MCP and Why You Need It

Introduction to Model Context Protocol — the open standard for connecting AI to external tools and data.

The Problem: AI Lives in Isolation

Large language models are powerful, but by default they’re sealed boxes. They can’t:

  • Read your files
  • Make API requests
  • Interact with databases
  • Send messages or emails
  • Access your calendar or project management tools

Every time you want AI to interact with the real world, you write custom integration code. Different code for each tool, each AI provider, each use case. It’s a mess.

The Solution: Model Context Protocol (MCP)

MCP is an open standard created by Anthropic that defines how AI applications communicate with external services. Think of it as USB for AI — one standard for connecting any tool to any AI model.

Before USB, every device had its own proprietary connector. Before MCP, every AI integration was custom-built. MCP standardizes the interface.

Why it matters:

  • Write one MCP server → it works with Claude, VS Code, Cursor, and any MCP-compatible client
  • Use community servers → connect to GitHub, Slack, databases without writing a line of code
  • Open standard → no vendor lock-in

MCP Architecture

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│    MCP Host      │────>│  MCP Client  │────>│   MCP Server     │
│  (Claude Desktop,│     │  (protocol   │     │  (filesystem,    │
│   Cursor, IDE)   │     │   handler)   │     │   GitHub, DB)    │
└─────────────────┘     └──────────────┘     └──────────────────┘
  • Host: The AI application (Claude Desktop, Cursor, Claude Code)
  • Client: Manages the connection between host and server
  • Server: Provides tools, resources, and prompts to the AI

One host can connect to many servers simultaneously. Claude Desktop talking to GitHub, your database, and your filesystem — all at once.

Three Types of MCP Server Capabilities

1. Tools — Functions AI Can Call

Tools are actions the AI can execute. The AI decides when to call them based on the user’s request.

ToolWhat It Does
search_filesFind files by name or content
create_issueCreate a GitHub issue
run_queryExecute SQL on your database
send_messageSend a Slack message

2. Resources — Data AI Can Read

Resources provide context. The AI reads them to understand your environment.

ResourceWhat It Provides
file://project/README.mdFile contents
db://users/schemaDatabase schema
api://docs/endpointsAPI documentation

3. Prompts — Ready-Made Templates

Prompts are reusable prompt templates that servers can expose.

PromptWhat It Does
review-prCode review template for a pull request
write-testsTest generation template for a function
explain-codeCode explanation template

The MCP ecosystem has grown fast. Here are the most useful servers:

ServerWhat It DoesBest For
FilesystemRead/write local filesDevelopers working with code and data
GitHubRepos, PRs, issues, code searchDevelopment teams
PostgreSQLSQL queries, schema inspectionData analysis, backend work
SlackSend/read messages, channelsTeam communication automation
Google DriveRead/search Google Docs, SheetsContent and document workflows
PuppeteerBrowser automation, screenshotsWeb scraping, testing
Brave SearchWeb searchResearch, fact-checking
MemoryPersistent knowledge graphLong-term AI memory
SentryError tracking, issue analysisDebugging production issues
LinearProject management, issuesProduct team workflows

Full list: MCP Server Registry on GitHub

Getting Started: Your First MCP Server

Let’s connect the Filesystem server to Claude Desktop in 5 minutes.

Step 1: Open Claude Desktop Config

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Create the file if it doesn’t exist.

Step 2: Add the Server

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/projects"
      ]
    }
  }
}

Replace /Users/yourname/projects with the folder you want Claude to access.

Step 3: Restart Claude Desktop

Close and reopen the app. You’ll see a hammer icon — that means MCP tools are loaded.

Step 4: Test It

Type in chat:

Show me the files in my projects folder

Claude reads the filesystem through MCP and responds with actual file listings. No custom code needed.

Adding More Servers

You can run multiple servers. Here’s a config with GitHub and PostgreSQL:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://user:pass@localhost:5432/mydb"
      ]
    }
  }
}

Now Claude can read your files, manage GitHub issues, AND query your database — all in one conversation.

MCP vs Custom Tool Integrations

AspectMCPCustom Integration
Setup timeMinutes (use existing servers)Hours/days
ReusabilityWorks across all MCP clientsOne app only
MaintenanceCommunity-maintainedYou maintain
StandardOpen protocolYour own API
Ecosystem1000+ serversBuild everything yourself

MCP wins when you need to quickly connect AI to existing tools. Custom integrations win when you need fine-grained control or the tool doesn’t have an MCP server yet.

Security Best Practices

MCP servers have access to your data. Take security seriously:

  1. Principle of least access — only grant access to folders and databases you need. Don’t mount your entire home directory.

  2. Read-only where possible — if the AI only needs to read data, use read-only database credentials and filesystem permissions.

  3. Environment variables for secrets — never hardcode tokens in the config file. Use the env field or system environment variables.

  4. Review before executing — Claude always asks for confirmation before executing actions. Don’t auto-approve everything.

  5. Separate dev and prod — never connect MCP servers to production databases or APIs from your development environment.

How MCP Compares to Other Standards

MCPOpenAI PluginsLangChain Tools
CreatorAnthropic (open standard)OpenAI (proprietary)LangChain (open source)
ScopeUniversal AI-to-tool protocolChatGPT onlyPython framework only
AdoptionClaude, Cursor, VS Code, etc.ChatGPTLangChain apps
Server count1000+DeprecatedVaries
Transportstdio, HTTP/SSEHTTPIn-process

MCP is the most widely adopted standard. OpenAI’s plugin system was deprecated in favor of GPTs and function calling. LangChain tools are framework-specific.

Next Steps