Windows上配置Claude MCP完整指南

大多数MCP教程假设你用Mac。Windows有自己的坑。

💡 你将学到

大多数MCP教程假设你用Mac。Windows有自己的坑。

📜 目录

• 在 Windows 2026 上配置 Claude MCP：完整指南及可用配置
• 第一步：安装 Node.js（基于 npx 的服务器必需）
• 第二步：找到正确的配置文件
• 第三步：Windows 特有的坑
• 第四步：重启并验证
• 故障排查表
• 常见问题
• 相关文章

在 Windows 2026 上配置 Claude MCP：完整指南及可用配置

Windows 用户会遇到 Mac 用户从未见过的三个 MCP 问题：npx 路径问题、缺少 Node.js，以及配置文件位置错误。本指南将逐一解决这三个问题。

第一步：安装 Node.js（基于 npx 的服务器必需）

从 nodejs.org 下载 LTS 安装程序。验证安装：

node --version
npx --version

官方合集里的大多数 MCP 服务器都通过 npx 运行，因此 Node.js 是必需的。

第二步：找到正确的配置文件

在 Windows 上，配置文件位于 %APPDATA%/Claude/claude_desktop_config.json —— 通常是 C:/Users/你的用户名/AppData/Roaming/Claude/claude_desktop_config.json

第三步：Windows 特有的坑

Mac 使用 "command": "npx"，而 Windows 需要 cmd /c：

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:/Users/你的用户名/Documents"]
    }
  }
}

注意：在 Windows 上，args 中需要使用正斜杠的实际路径，或使用转义的反斜杠。

第四步：重启并验证

1. 完全退出 Claude Desktop（注意检查系统托盘图标——它其实还在后台运行！）
2. 重新启动
3. 在聊天框中寻找锤子/工具图标
4. 询问：“你有哪些可用的工具？”

故障排查表

常见问题

我需要 WSL 吗？ 基本 MCP 服务器不需要。原生 Windows 即可支持 filesystem、fetch、GitHub 以及大多数服务器。基于 Docker 的服务器则需要 WSL2 或 Docker Desktop。

我可以在 Windows 上使用 Python MCP 服务器吗？ 可以——将 "command" 设置为 "python"，并在 args 中传入脚本路径。

如何在 Windows 上查看服务器日志？ Claude Desktop 会将日志写入 %APPDATA%/Claude/logs/ —— 检查 mcp 日志文件以排查连接错误。

相关文章

• 2026本地大模型部署指南：Windows/Mac/Linux运行AI模型
• 在Mac上本地运行Ollama：Apple Silicon完整指南
• 基于Claude的多智能体系统：2026年构建AI智能体团队

❓ 常见问题

我需要 WSL 吗？

基本 MCP 服务器不需要。原生 Windows 即可支持 filesystem、fetch、GitHub 以及大多数服务器。基于 Docker 的服务器则需要 WSL2 或 Docker Desktop。

我可以在 Windows 上使用 Python MCP 服务器吗？

可以——将 `"command"` 设置为 `"python"`，并在 args 中传入脚本路径。

如何在 Windows 上查看服务器日志？

Claude Desktop 会将日志写入 %APPDATA%/Claude/logs/ —— 检查 mcp 日志文件以排查连接错误。