Claude Code 的 MCP 配置文件到底在哪：.mcp.json 只在一种情况下才出现，11 月 1 日实测版

很多人给 Claude Code 装好 MCP 服务器后，翻遍项目也找不到 .mcp.json——其实根本没有唯一的 MCP 配置文件。Claude Code 按添加时的作用域把服务器存到不同地方：默认的 local 作用域存在家目录的 ~/.claude.json 里，只在该项目生效；project 作用域才会写出项目根目录的 .mcp.json；user 作用域存在 ~/.claude.json 顶层，所有项目都能用。作者 11 月 1 日用 Claude Code v2.1.312 在 Mac 上实测，三个作用域各加了一个演示服务器，逐一核对了落盘位置。

最容易踩的坑：.mcp.json 只在用 claude mcp add –scope project 加服务器、或自己手写时才会出现，默认命令加的服务器进了 ~/.claude.json。而且文件在项目根目录、跟 package.json 同级，别跟 .claude 文件夹里的设置文件搞混。项目级服务器首次使用会弹窗让选「只用这一次 / 以后都用 / 不用」，你的选择存在 .claude/settings.local.json 里，不存在 .mcp.json 里，所以每个队友都会单独收到一次提示；想清掉选过的决定，跑 claude mcp reset-project-choices。同名服务器出现在多个位置时不合并，按 local → project → user → 插件 → 官方连接器的优先级，只用排最前面的那一份。

不用翻文件也能查：claude mcp list 看全部服务器与状态，claude mcp get <名字> 看单个服务器的作用域与命令，会话里 /mcp 打开管理面板。服务器不显示时先看这几项：是不是在别的项目里加的 local 服务器、是不是从子目录启动的（要从项目根目录启动）、是不是等审批（Pending approval）、是不是之前点过拒绝（看 .claude/settings.local.json 里的 disabledMcpjsonServers）、JSON 有没有少逗号。适合刚开始给 Claude Code 接 MCP 工具的人，先搞清这张位置表再动手。相关阅读：把 Claude Code 关进 Dev Container 里跑：5 步搭好隔离沙箱、10 个现成 Claude Code Hooks 照着抄。原文教程见 AI Parabellum：Where Is the Claude Code MCP Config File?。

来源：AI Parabellum，原文：https://aiparabellum.com/where-is-claude-code-mcp-config-file/