深入理解 Claude Code 的 MCP Server 配置机制

在使用 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 开发体验更丝滑。