Windows 环境下 MCP 客户端配置文件没有统一路径，具体位置取决于你使用的宿主软件（如 Claude Desktop、Cursor 或 Gemini CLI）。大多数客户端将配置存放在用户主目录的隐藏文件夹或 AppData 目录中，需先确认具体使用的客户端类型再定位文件。

命令速用版

使用环境变量快速跳转至用户主目录，避免手动查找用户名文件夹。

在文件资源管理器地址栏输入以下内容并回车：

%USERPROFILE%

若要直接打开常见配置目录，可尝试：

%USERPROFILE%\.claude

%USERPROFILE%\.cursor

%USERPROFILE%\.gemini

为什么会这样

MCP 是协议标准而非单一软件，不同客户端实现配置存储的方式不同。Claude、Cursor 和 Gemini 等客户端各自维护独立的配置文件结构，因此不存在唯一的“MCP 配置文件”路径。Windows 系统习惯将用户级配置存放在用户主目录的隐藏文件夹中，以避免干扰普通文件操作。

分步处理

根据你使用的具体客户端，选择对应的配置路径进行修改。

1. Claude Code / Claude Desktop

全局配置文件通常位于用户主目录下的.claude文件夹中。

路径：C:\Users\<用户名>\.claude\config.json

部分版本或配置可能直接使用C:\Users\<用户名>\.claude.json。

在文件中定义mcpServers字段，指定 server 类型为 stdio 及相关命令参数。

2. Cursor 编辑器

Cursor 的 MCP 配置文件位于项目目录或用户配置目录的.cursor文件夹下。

路径：.cursor\mcp.json

需确保已安装 Node.js，并通过 npm 全局安装对应的 MCP 服务器包。

3. Gemini CLI

Gemini 的全局配置文件位于用户主目录的.gemini隐藏文件夹内。

路径：%USERPROFILE%\.gemini\settings.json

在settings.json中添加mcpServers配置项，指定命令和参数。

怎么验证是否生效

修改配置文件后，必须重启对应的客户端软件才能加载新配置。

在客户端界面中查找 MCP 工具列表或状态栏指示，确认新添加的 Server 状态为“Connected”或“Active”。

若客户端支持日志查看，检查启动日志中是否有加载 MCP 配置文件的记录，确认无 JSON 语法报错。

常见坑

Windows 默认隐藏以点（.）开头的文件夹，需在文件资源管理器中开启“隐藏项目”显示选项才能看到.claude、.cursor或.gemini文件夹。

配置文件必须为合法的 JSON 格式，多余的逗号或缺失的引号会导致配置失效。

部分 MCP 服务需要预先安装依赖包（如 npm 包或 Python 环境），仅修改配置文件而不安装对应环境会导致启动失败。

常见问题

找不到配置文件怎么办？

先确认是否已初始化过客户端，部分软件在首次运行前不会生成配置文件。

修改后没有生效？

检查 JSON 语法是否正确，并确认已完全重启客户端软件而非仅刷新界面。

可以使用相对路径吗？

建议在该配置文件中命令参数使用绝对路径，避免因工作目录变化导致命令执行失败。

参考来源

1. 知识库来源：Windows 上用 Claude Code 配 MCP Server,配置文件放哪、怎么写、工具怎么装？

2. 知识库来源：Windows 环境下 MCP 服务安装配置全面总结【mcp】

3. 知识库来源：windows 系统中配置文件在哪

4. 知识库来源：Windows-MCP 安装与使用全指南：让 AI 轻松操控你的电脑

5. 知识库来源：一文掌握:Cursor 新版本 MCP 配置全攻略 (Windows 与 Mac 篇)