在 Claude Desktop 中配置 MCP
High Contrast
Dark Mode
Light Mode
Sepia
Forest
3 min read631 words

在 Claude Desktop 中配置 MCP

Claude Desktop 是目前对 MCP 支持最完整的客户端。本节从零开始，带你完成第一次 MCP 配置，5 分钟内让 Claude 能够读取你的本地文件。

前提条件

配置文件位置

graph TD A[操作系统] --> B{平台} B -- macOS --> C["~/Library/Application Support/
Claude/claude_desktop_config.json"] B -- Windows --> D["%APPDATA%\\Claude\\claude_desktop_config.json"] B -- Linux --> E["~/.config/Claude/
claude_desktop_config.json"]

如果文件不存在，Claude Desktop 首次运行时会创建该目录，你需要手动创建 claude_desktop_config.json。

第一步：打开配置文件

macOS：

# 方式一：命令行
open ~/Library/Application\ Support/Claude/
# 方式二：直接用编辑器打开
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows（PowerShell）：

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

第二步：写入 MCP Server 配置

以文件系统 MCP 为例，这是最常用的起点：

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/yourname/Documents",
"/Users/yourname/Projects"
]
}
}
}

字段说明：

字段 必填 说明
command ✅ 启动 Server 的命令（通常是 npx 或 python）
args ✅ 命令参数数组
env ❌ 传递给 Server 进程的环境变量
cwd ❌ 工作目录，通常不需要设置

第三步：添加多个 MCP Server

一个配置文件可以同时激活多个 Server：

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/yourname/Documents"
]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
}
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "BSA_your_key"
}
}
}
}

第四步：重启 Claude Desktop

必须完全退出再重启——直接关闭窗口不够，需要从菜单栏/系统托盘退出：

重启后，MCP Server 会在后台自动启动。

第五步：验证配置成功

在 Claude Desktop 新建对话，发送：

请列出 ~/Documents 目录下的文件

如果配置正确，你会看到：

我可以使用文件系统工具来查看这个目录。让我为你列出内容...
[工具调用：list_directory]
路径：/Users/yourname/Documents
结果：
- report.pdf
- notes.md
- projects/

另一个验证方法：点击 Claude Desktop 对话框下方的工具图标（🔧），应该能看到已注册的 MCP 工具列表。

完整配置示例（推荐起手套装）

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/yourname/ai-workspace"
]
},
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
},
"sqlite": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sqlite",
"--db-path",
"/Users/yourname/ai-workspace/data.db"
]
}
}
}

这三个 Server 组合覆盖了：本地文件读写 + 网页自动化 + 本地数据库查询，是日常工作的高频需求。

常见配置错误

错误现象 可能原因 修复方法
Claude 没有工具可用 配置未生效或语法错误 用 JSON 验证器检查格式
工具调用返回 "Server not found" Server 未能启动 检查 command 和 args 是否正确
文件路径报 "Permission denied" 路径不在允许范围内 检查配置中的根目录路径
npx 命令找不到 Node.js 未安装或路径问题 使用 Server 的完整路径替代 npx

本节执行清单

下一节：在 Cursor 和 IDE 中配置 MCP