作用域管理

MCP 三级作用域的合并与覆盖机制,让多项目环境下的 MCP 配置互不干扰。

综合7 分钟

一、作用域合并的工作方式

三个作用域的存储位置

MCP Server 配置存储在三个独立位置,每个位置对应不同的生效范围:

作用域存储位置--scope 参数值生效范围
Local~/.claude.json(按项目路径隔离)local(默认值)仅当前用户 + 仅当前项目
Project项目根目录 .mcp.jsonproject所有用户 + 仅当前项目
User~/.claude.json(全局段)user仅当前用户 + 所有项目

Local 和 User 都写入 ~/.claude.json,但 Claude Code 内部按项目路径将它们隔离为独立的配置段。Project 写入项目根目录的 .mcp.json,可提交到版本控制供团队共享。

三个作用域的命名在历史版本中发生过变更:

当前名称(v1.2)早期名称CLI 兼容性
localproject--scope project 仍可用,等同于 --scope local
project(v1.2 新增)
userglobal--scope global 仍可用,等同于 --scope user

阅读早期教程或社区文章时,看到 --scope project 指的是当前的 local(私有项目级配置),不是当前的 project(团队共享 .mcp.json)。

合并规则

Claude Code 启动时,从三个位置收集所有 MCP Server 配置,按以下规则合并为一份最终配置:

不同名 Server:全部合并,都可用。三个作用域中分别配置了 githubsentrymy-tools,启动后三个 Server 同时存在。

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 无需续费,持续更新