一、作用域合并的工作方式
三个作用域的存储位置
MCP Server 配置存储在三个独立位置,每个位置对应不同的生效范围:
Local 和 User 都写入 ~/.claude.json,但 Claude Code 内部按项目路径将它们隔离为独立的配置段。Project 写入项目根目录的 .mcp.json,可提交到版本控制供团队共享。
三个作用域的命名在历史版本中发生过变更:
阅读早期教程或社区文章时,看到 --scope project 指的是当前的 local(私有项目级配置),不是当前的 project(团队共享 .mcp.json)。
合并规则
Claude Code 启动时,从三个位置收集所有 MCP Server 配置,按以下规则合并为一份最终配置:
不同名 Server:全部合并,都可用。三个作用域中分别配置了 github、sentry、my-tools,启动后三个 Server 同时存在。