MCP（Model Context Protocol） 是 Anthropic 推出的开源通信标准，它为 Claude Code 赋予了”手脚”，使其能够与外部工具、API 和数据源无缝交互。本文将手把手教你如何正确配置 MCP 服务器，解锁 Claude Code 的全部潜力。
什么是 MCP？
MCP 全称为 Model Context Protocol（模型上下文协议），是一个用于 AI 工具集成的开源标准。通过 MCP，Claude Code 可以：
- 📁 直接访问和操作本地文件系统
- 🌐 连接各种 API 和网络服务（如 GitHub、Notion、Sentry）
- 🗄️ 查询和操作数据库（PostgreSQL、MySQL 等）
- 🛠️ 集成各种开发工具（Playwright、Airtable 等）
- 🔧 自动化日常任务（创建 Gmail 草稿、分析监控数据等）
30秒快速上手
如果你赶时间，这是最快的添加方法：
# 添加文件系统访问（最常用） claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Desktop # 验证是否成功 claude mcp list
详细配置方法
方法一：命令行添加（推荐新手）
Claude Code 提供了三种主要的 MCP 服务器配置方式：
1. 远程 HTTP 服务器（推荐云服务）
# 基本语法 claude mcp add --transport http <name> <url> # 真实示例：连接 Notion claude mcp add --transport http notion https://mcp.notion.com/mcp # 带认证令牌的示例 claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer your-token"
2. 本地 stdio 服务器（推荐本地工具）
# 基本语法 claude mcp add [options] <name> -- <command> [args...] # 真实示例：添加 Airtable 服务器 claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \ -- npx -y airtable-mcp-server
重要提示：所有选项（
--transport、--env、--scope、--header）必须位于服务器名称之前。双破折号--将服务器名称与实际命令分隔开。
3. 从 JSON 配置添加（推荐批量配置）
# 示例：使用 JSON 配置添加 HTTP 服务器
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'
方法二：直接编辑配置文件（推荐高级用户）
对于熟悉配置文件的开发者，可以直接编辑 .claude.json：
- macOS/Linux:
~/.claude.json - Windows:
%USERPROFILE%\.claude.json
{
"mcpServers": {
"filesystem": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Documents"],
"env": {}
}
}
}
方法三：从 Claude Desktop 导入
如果你已在 Claude Desktop 中配置了 MCP 服务器：
# 导入所有已配置的服务器 claude mcp add-from-claude-desktop
配置作用域管理
MCP 服务器可以在三个不同作用域进行配置：
| 作用域 | 存储位置 | 适用场景 |
|---|---|---|
| local（默认） | ~/.claude.json | 个人项目、实验配置 |
| project | 项目根目录的 .mcp.json | 团队共享、版本控制 |
| user | ~/.claude.json | 跨项目通用工具 |
# 显式指定作用域 claude mcp add --scope project github --transport http https://api.githubcopilot.com/mcp/
实用 MCP 服务器推荐
1. 文件系统访问
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Desktop
2. GitHub 集成
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
3. Sentry 监控
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
4. 数据库查询
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \ --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
常见问题解决
1. Windows 用户注意事项
在原生 Windows（非 WSL）上，需要 cmd /c 包装器：
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
2. 身份验证问题
许多云服务需要 OAuth 2.0 认证：
- 添加服务器后，在 Claude Code 中输入
/mcp - 按照浏览器中的步骤完成登录
3. 输出限制警告
当 MCP 工具输出超过 10,000 个令牌时会显示警告。可通过环境变量调整：
export MAX_MCP_OUTPUT_TOKENS=50000 claude
高级功能
MCP 资源引用
使用 @ 提及来引用 MCP 资源：
> Can you analyze @github:issue://123 and suggest a fix?
MCP 提示命令
MCP 服务器提供的提示可在 Claude Code 中作为命令使用：
> /mcp__github__list_prs > /mcp__github__pr_review 456
安全注意事项
- 第三方风险：使用第三方 MCP 服务器需自担风险，请确保信任所安装的服务器
- 敏感数据：避免在不安全的 MCP 服务器中传输敏感信息
- 权限控制：企业用户可使用
managed-mcp.json进行集中管控