Windows原生环境配置Claude Code MCP(通过JSON)
Windows原生环境配置Claude Code MCP(通过JSON)
一、环境准备
-
操作系统要求:Windows 10 或 Windows 11。
-
工具版本要求:
- 使用 Claude Code 最新版;
- 非WSL版本。
二、JSON 配置步骤说明
在 Windows 系统中,Claude Code 的配置信息存储于用户主目录下的 .claude.json
文件中。具体操作如下:
-
打开文件路径
C:/Users/[UserName]/.claude.json
-
在 JSON 中定位到
mcpServers
节点:- 通常存在一个全局的
mcpServers
配置节点,位于整个 JSON 的顶层; - 如果没有配置,则可以在该位置手动添加一条记录
- 通常存在一个全局的
-
项目特定 MCP 配置:
- 在
Projects
节点下找到对应项目的子节点 - 为该项目单独设置
mcpServers
- 在
解决方案说明
如果直接复制粘贴命令行中的参数到 Claude Code 中,可能会遇到连接超时的问题。这是因为默认配置方式不适用于 Windows 原生命令行环境。
解决方法:
- 将
npx
作为第一个参数放在args
数组的最前面 - 在其之前添加
/c
参数(表示在 CMD 中执行一次命令后关闭窗口) - 同时将
command
字段设置为cmd
示例配置
"mcpServers": {"context7": {"command": "cmd","args": ["/c","npx","-y","@upstash/context7-mcp@latest"]}}