一、配置文件是什么
MCP 配置决定了 Claude Code 启动时连接哪些外部服务。把 MCP Server 的名称、启动命令、认证凭据写入指定的 JSON 文件，Claude Code 下次启动时自动读取并建立连接。
配置文件不是"另一种安装方式"。claude mcp add 命令本身就是向这些文件写入 JSON 条目。理解文件格式后，可以跳过命令行直接编辑，也可以一次配置多个 Server。
二、两种配置文件
MCP 配置分布在两个文件中，对应不同的生效范围。
.mcp.json 是团队共享配置。提交到 Git 仓库后，其他成员 clone 项目即获得相同的 MCP Server 配置，无需逐人运行安装命令。
~/.claude.json 存储个人配置。claude mcp add 默认写入此文件的 local 段（仅当前项目可见），--scope user 写入 user 段（所有项目可见）。
三、配置文件的结构
顶层结构
两个文件共享相同的顶层格式：
mcpServers 是唯一的顶层键。每个子键是 Server 名称，值是该 Server 的配置对象。
stdio 类型配置
本地运行的 MCP Server 使用 stdio 传输方式。Claude Code 启动一个子进程，通过 stdin/stdout 与之通信。