一、为什么需要了解管理命令的行为规则
在快速上手中,claude mcp add 和 claude mcp remove 作为两行命令出现。执行后 Server 确实添加或移除了,但几个现象没有解释:
- 同一条
add命令,加--scope project和不加--scope,Server 出现在不同位置 remove删掉了一个 Server,但下次打开项目时它又出现了list显示的 Server 比.mcp.json里配置的多
这些行为的根源在于:管理命令的操作对象不是 Server 进程,而是配置文件中的 JSON 条目。--scope 参数决定操作哪个文件,不同文件的可见范围不同。
二、管理命令的工作方式
命令与配置文件的对应关系
Claude Code 提供 5 条 MCP 管理命令。每条命令的核心行为是读写配置文件。
添加命令语法:
查看与删除:
--scope 如何决定写入位置
add 和 add-json 的 --scope 参数控制配置写入哪个文件。三个可选值对应三个存储位置: