Skip to main content
This is where Claude Code goes from “smart editor” to “team member with access.” MCP (Model Context Protocol) connects Claude to your external tools and data sources — GitHub, databases, project management, Slack, and more. No more copy-pasting context. Claude reads the issue, queries the schema, writes the code, and opens the PR.
Official reference — For the full MCP API, authentication flows, and server registry, see the official MCP docs. This page covers the three connections worth setting up first.

​
The Three Most Impactful Connections

The highest-ROI MCP connection. Claude can read issues, understand requirements, write code, and create PRs in a single flow.
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
What it enables:
  • “Implement the feature described in issue #42 and open a PR”
  • “Review the comments on PR #15 and address them”
  • “Search for related issues before implementing this change”
This alone transforms the workflow. Start here.

​
How to Add MCP Servers

Three methods, from simplest to most configurable: 
# Remote HTTP server (most common)
claude mcp add --transport http <name> <url>

# Local stdio server
claude mcp add --transport stdio <name> -- <command> [args]

# From JSON (for complex config)
claude mcp add-json <name> '{"type": "http", "url": "..."}'

​
Scoping: Team vs. Personal

Config FileScopeUse For
.mcp.json (project root)Team — committed to gitShared tools (GitHub, DB, CI)
~/.claude.jsonPersonal — all projectsYour Slack, your Linear, personal API keys
Rule of thumb: If every developer on the team needs it, put it in .mcp.json. If it’s tied to your personal accounts or preferences, keep it in ~/.claude.json.

​
Practical Tips

  • Start with one. GitHub MCP alone transforms the workflow. Add more as you find friction.
  • Read-only first. Give Claude read access to your database, not write. Expand permissions as trust grows.
  • Check what’s available. Run claude mcp list to see your active connections.
  • OAuth flows are supported. Many MCP servers handle auth automatically — Claude will prompt you to authenticate on first use.