在使用 Claude Code 的过程中，我遇到这样的问题：
👉 “我安装了一个 MCP Server，但它到底把配置文件放哪儿去了？”
👉 “我能不能让团队共享同一个 MCP 配置？”
别急，这篇文章就带你从零搞清楚——Claude Code 的 MCP（Model Context Protocol）服务器配置机制。
🧭 一、MCP Server 是什么？
MCP，全称 Model Context Protocol，是 Claude Code 用来扩展能力的插件协议。
简单来说，它让 Claude 能通过外部工具（例如 Chrome DevTools）访问额外的上下文，实现更智能的代码分析和调试功能。
当你安装一个 MCP Server 时，其实就是告诉 Claude：
“嘿，给我加上这个扩展，启动时一起加载。”
⚙️ 二、安装命令
安装 MCP Server 的基本命令格式如下（官方文档说明：Installing MCP Servers）：
claude mcp add <server-name> <command> [args...]
Claude 会自动检测传输方式（通常是 stdio），并自动配置。
例如，下面是一个安装 Chrome DevTools MCP Server 的示例：
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
💡 注意：
chrome-devtools-mcp只是一个示例 MCP Server，用来说明配置结构。
实际使用中，你可以安装任何符合 MCP 协议的服务器（例如数据库、文档检索或测试工具）。
🗂 三、配置存储范围（Scope）
Claude Code 的 MCP 配置共有三种“范围”（Scope），用于不同的使用场景：
| 范围 | 文件位置 | 是否共享 | 适用场景 |
|---|---|---|---|
| Local（默认） | ~/.claude.json（按项目路径存） |
❌ 不共享 | 个人项目配置 |
| Project | .mcp.json（项目根目录） |
✅ 可共享 | 团队协作推荐 |
| User | ~/.claude.json（全局） |
❌ 仅个人 | 跨项目全局使用 |
下面分别来看它们的作用。
① 本地范围（Local Scope）
文件位置：~/.claude.json
特点：项目私有，不会提交到 Git。
配置示例：
{"projects": {"/path/to/your/project": {"mcpServers": {"chrome-devtools": {"type": "stdio","command": "npx","args": ["chrome-devtools-mcp@latest"],"env": {}}}}}
}
适合单人开发或临时调试时使用。
② 项目范围（Project Scope）
文件位置：项目根目录下的 .mcp.json
创建命令：
claude mcp add --scope project chrome-devtools npx chrome-devtools-mcp@latest
特点：
- 可提交到版本控制系统
- 团队成员共享相同配置
- 最推荐用于团队协作环境
换句话说，你配置一次，团队成员拉取代码后即可直接使用相同的 MCP 设置。
③ 用户范围（User Scope）
文件位置：~/.claude.json（根层级）
创建命令：
claude mcp add --scope user chrome-devtools npx chrome-devtools-mcp@latest
特点：
- 全局可用，跨项目生效
- 仅对当前用户有效
- 适合常用的通用工具（如 DevTools、Lint 等）
🔍 四、查看当前配置
查看某个 MCP Server 的配置详情：
claude mcp get chrome-devtools
它会显示：
- 该 MCP 属于哪个 Scope；
- 它的配置路径；
- 以及完整的参数信息。
查看所有已安装的 MCP Servers：
claude mcp list
🧩 五、配置文件结构
所有 Scope 下的配置文件结构保持一致：
{"mcpServers": {"server-name": {"type": "stdio","command": "npx","args": ["-y", "package-name@latest"],"env": {}}}
}
字段解释：
| 字段 | 含义 |
|---|---|
type |
通信方式（通常为 stdio） |
command |
启动命令（如 npx） |
args |
启动参数 |
env |
环境变量（可选） |
💡 六、快速总结
| 场景 | 推荐命令 | 结果 |
|---|---|---|
| 默认安装（单人使用） | claude mcp add ... |
写入 ~/.claude.json（Local） |
| 团队共享 | claude mcp add --scope project ... |
写入 .mcp.json（Project） |
| 全局通用 | claude mcp add --scope user ... |
写入全局配置（User） |
一句话来说：Local 给自己，Project 给团队，User 给所有项目。
📚 七、参考资料
- Claude Code 官方 MCP 文档（含安装命令语法）
- Chrome DevTools MCP Server GitHub 仓库
✅ 写在最后
理解 MCP Server 的配置范围，看似细节，却是你能否顺利协作和快速调试的关键。
下次当你安装 MCP Server 时，不妨先想想：
“这是只给我用，还是要让整个团队共享？”
答案决定了你该用哪个 Scope，也让你的 Claude Code 开发体验更丝滑。