AI for Automation
🔌 Claude Code MCP Complete Guide

Step 15 / 22

🔌 Claude Code MCP Complete Guide

Connect external tools to Claude Code via MCP

MCP = Adding Apps to Claude Code

What happens if you ask Claude Code to “check my GitHub issues”? In its default state, it can’t do anything — it has no way to access GitHub.

But if you add an MCP server? It just works. Just like installing a messaging app on your phone lets you send messages, installing a GitHub app on Claude Code lets it check your issues.

MCP stands for Model Context Protocol, but you don’t need to remember the name. The important thing is that it’s “how you add apps to Claude Code.”

SmartphoneClaude Code
Search for an app in the app storeSearch for a tool in the MCP server list
Install the app (one tap)Add MCP (one command)
Open the app and use itTell Claude and it uses it automatically
Install a chat app to send messagesInstall GitHub MCP to manage issues
Install a payment app to transfer moneyInstall Notion MCP to manage documents

One-line summary

MCP = Claude Code’s app store. Install the apps (servers) you need and Claude can directly use those services.

What Apps Are Available?

Just like smartphones have SNS apps, banking apps, and shopping apps, Claude Code has various types of apps (MCP servers). Let’s explore by category.

📋

Productivity Tools

Notion, Linear, Asana, etc. Have Claude handle task management, project management, and document creation.

💻

Developer Tools

GitHub. Manage code, create issues, and review PRs through conversation.

📊

Data

PostgreSQL, Supabase, etc. Ask questions about your database in plain English and get results.

📬

Communication

Slack, Gmail, etc. Let Claude organize emails and send messages on your behalf.

🔍

Monitoring

Sentry, etc. When errors occur, Claude analyzes the cause and suggests fixes.

🎨

Design

Figma, etc. Read design files and convert them to code.

All free to connect

Adding MCP servers themselves is free. One command in Claude Code and you’re done. (However, the connected service’s own paid plans are separate.)

Real-World Usage Examples

What’s different with MCP? Let’s compare specifically.Without MCP vs. with MCP.

1. GitHub — Code Management

Without MCP

Open GitHub in browser, find PR list, click through each one

With MCP

“Show me the PR list” — done in one sentence

Just say this
Show me the open PRs in my GitHub repo.
Sort by oldest first.

2. Sentry — Error Tracking

Without MCP

Log into Sentry, find error log page, read stack traces

With MCP

“Analyze recent errors” — identifies causes in one sentence

Just say this
Fetch errors from the last 24 hours in Sentry,
categorize them by cause, and suggest solutions.

3. Notion — Document Management

Without MCP

Copy content from Notion, paste into Claude, copy result back to Notion

With MCP

“Read and summarize this Notion page” — one sentence

Just say this
Find the "Meeting Notes" page in my Notion workspace
and summarize the key points in 3 lines.

4. Gmail — Email Management

Without MCP

Open Gmail, check each email one by one, manually pick out important ones

With MCP

“Organize today’s important emails” — one sentence

Just say this
From today's emails, pick out the ones that need a reply.
Give me a one-line summary and a draft reply for each.

5. PostgreSQL — Data Queries

Without MCP

Study SQL syntax, write queries manually, interpret results

With MCP

“Show me last month’s top 10 sales” — ask in plain English

Just say this
Show me the top 10 products by revenue last month.
Include revenue, units sold, and month-over-month change in a table.

The real power is in combining them

MCP’s true strength shows when you use multiple apps simultaneously. “Check the error on Sentry, fix it on GitHub, and notify the team on Slack” — complex workflows like this work with a single instruction.

MCP = Claude Code’s App Store

The more apps you install, the more Claude can do

Installation — Just 2 Methods to Know

There are exactly 2 ways to add MCP servers. Don’t overthink it.

1. Remote Server (most common)

Connects to a service on the internet. GitHub, Notion, Sentry — all use this method.

Add a remote server
claude mcp add --transport http name URL

2. Local Server (special cases)

Runs on your own computer. Used for accessing local files or a local database.

Add a local server
claude mcp add name -- command

3 Common Examples

GitHub (remote)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Notion (remote)
claude mcp add --transport http notion https://mcp.notion.com/mcp
Sentry (remote)
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

The commands look complex, but

No need to memorize them. Just copy and paste from the official docs. We’ve compiled all the popular server commands below for easy copy-paste.

Install One Right Now

You need to try it to get the feel. Let’s install the easiest one: GitHub MCP.

1
Run Claude Code in your terminal

Type claude in any folder

2
Copy-paste the command below

Run it outside the Claude Code session, in a regular terminal

3
Type /mcp to verify

Check connection status inside the Claude Code session

4
Try it out

Say "Show me my GitHub PR list" and if it works, success!

Step 2: Add GitHub MCP (run in terminal)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Step 3: Verify inside Claude Code
/mcp
Step 4: Try it
Show me my GitHub repository list.

If you’ve gotten this far, you’re done! Want to add other servers? Same process.

3 Management Commands — All You Need

CommandDescription
claude mcp listView installed MCP server list
claude mcp get nameCheck details of a specific server
claude mcp remove nameRemove an unneeded server

Install once, done forever

Once added, MCP servers are automatically saved. Next time you start Claude Code, they reconnect automatically. No need to reinstall each time.

Servers That Require Login

Services like GitHub and Notion need access to your account data. So the first time you connect, you need to log in. Just like signing in with Google or Apple — “Is it okay for this app to use my account?”

The Entire Process — 3 Steps

1
Add the MCP server (what you did above)

Run the claude mcp add command in your terminal

2
Type /mcp inside Claude Code

If a server needs authentication, it will tell you here

3
Log in + click "Allow" in browser

The browser opens automatically. Log in, click allow, and you're done!

Once you log in, it’s automatic from then on. No need to log in again each time.

Browser not opening?

A URL will appear in the terminal. Copy that URL and paste it directly into your browser’s address bar.

Installation Scope — Default Is Usually Enough

When installing an MCP server, you can choose whether it’s “just for me” or “shared with my team.” There are 3 options, but the default is fine to start.

Default (Local)

Just for you. No extra flags needed — this is automatic. Start with this.

claude mcp add name ...

Team Shared (Project)

Teammates can use it too. Add --scope project at the end.

claude mcp add --scope project name ...

All Projects (User)

For all your work. Add --scope user.

claude mcp add --scope user name ...

You can change it later

Start with the default (Local). If you need to share with a team later, remove it and re-add with Project scope.

Using It More Conveniently

Once MCP servers are installed, there are 2 ways to use them more easily.

@ Mentions — Pull In Data Directly

Type @ followed by a server name in the chat to reference that server’s data directly. No need to copy or download files — pull them right into the conversation.

@ mention examples
# Type this in your Claude Code session
@github Analyze this issue

@notion Summarize this page

/ Slash Commands — Access Extra Features

Installing MCP servers may add new slash commands. Type / to see the available command list.

Don't know the commands? Just ask

You don’t need to know @ mentions or slash commands. Just say “Check my GitHub issues” or “Summarize the Notion page” in plain English and Claude will automatically use the right tool.

How MCP Has Evolved

MCP is still a new technology. Short history, but rapid progress.

2024.11
MCP first launched

Anthropic released MCP as open source. Called "the USB-C standard for AI."

2025.11
1st anniversary — ecosystem explosion

Countless services started supporting MCP. GitHub, Notion, Slack, and more joined.

2026.01
The remote connection era

One-command remote server connections became possible. Installation got much simpler.

2026.03
2026 roadmap announced

Plans to make it faster, more secure, and enterprise-ready.

It keeps getting better

New MCP servers are added every month. Learn it now and you’ll keep gaining new capabilities over time.

Try It Yourself

Reading alone won’t give you the feel. Follow the exercises below.

Exercise 1: Connect GitHub MCP (Easiest)

If you have a GitHub account, you can do this right away.

Step 1: Add MCP server
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Step 2: Type /mcp in Claude Code
/mcp
# If github shows up in the list, success!
# If auth is required, log in via the browser.
Step 3: Try it
Show me my GitHub repository list.

Exercise 2: Add Notion MCP Too

If you use Notion, connect this one as well.

Add Notion MCP
claude mcp add --transport http notion https://mcp.notion.com/mcp

# In Claude Code:
Show me the 5 most recent pages in my Notion workspace.

Verification Checklist

Errors are fine. Check the status with claude mcp list, and if something isn’t working, remove it with claude mcp remove nameand re-add it.

Tips + Sources

Practical tips to know when using MCP.

1. If it’s not working, check /mcp

If an MCP tool isn’t functioning, type /mcp in Claude Code. You can see connection status and auth status at a glance.

2. Multiple servers work fine together

Connecting GitHub + Notion + Sentry simultaneously is no problem. In fact, MCP shines brightest when combining multiple servers.

3. Remove what you don’t use

Remove unused servers with claude mcp remove name. Too many servers can slow down loading.

4. If npx doesn’t work on Windows

When adding local servers, npx sometimes doesn’t work. Try cmd /c npx instead. Updating to the latest Node.js (22+) also helps.

5. Finding more servers

Beyond the 8 listed above, hundreds of MCP servers exist. github.com/modelcontextprotocol/servers has the full list.

MCP = Claude Code’s App Store

Install apps (servers) and Claude directly manages GitHub, organizes emails, and analyzes data. You just give instructions in plain English.

Even one installation makes a difference

No need to install a bunch at once. Even just connecting GitHub will give you that “wait, this actually works?” moment. Then add more one at a time.

References

Previous

Build Free Surveys

Next

Claude Code Skills Complete Guide