MCP 配置同步

为什么需要同步？

当你同时用 Claude Code、Cursor、Windsurf、VS Code、Claude Desktop 时，每个工具都有自己的 MCP 配置文件。同步的目标只有一个：保证所有工具里的 MCP 服务器列表一致，避免「这边能用那边不能用」。

你要记住的三句话

先选一个“主配置”，其它工具全部复制它。
服务器名称必须完全一致，否则会被当作不同服务。
改完一定重启工具，否则新配置不会加载。

配置文件位置速查

工具	macOS	Windows	Linux
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`	`%APPDATA%\Claude\claude_desktop_config.json`	`~/.config/Claude/claude_desktop_config.json`
Cursor	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`	`~/.codeium/windsurf/mcp_config.json`
Claude Code	`~/.claude.json` (不只是 MCP)	`~/.claude.json` (不只是 MCP)	`~/.claude.json` (不只是 MCP)
VS Code (User)	`~/Library/Application Support/Code/User/settings.json`	`%APPDATA%\Code\User\settings.json`	`~/.config/Code/User/settings.json`

配置结构差异

Claude Desktop / Cursor

{
	"mcpServers": {
		"server-name": {
			"command": "npx",
			"args": ["-y", "package-name"],
			"env": {
				"ENV_VAR": "value"
			}
		}
	}
}

VS Code

{
	"mcp": {
		"servers": {
			"server-name": {
				"command": "npx",
				"args": ["-y", "package-name"],
				"env": {
					"ENV_VAR": "value"
				}
			}
		}
	}
}

注意：Claude Code (CLI) 目前不支持通过 .claude.json 配置 MCP 服务器。

最小化对比脚本（可选）

只想确认配置是否一致？用最短脚本比较：

jq -S '.mcpServers // {}' ~/.cursor/mcp.json > /tmp/cursor-mcp.json
jq -S '.mcpServers // {}' ~/Library/Application\ Support/Claude/claude_desktop_config.json > /tmp/claude-mcp.json
diff -u /tmp/cursor-mcp.json /tmp/claude-mcp.json

常见问题

VS Code 看不到 MCP：确认写在 mcp.servers 里，不是 mcpServers。
同名服务不生效：检查 command / args 是否一致，大小写也要一致。
复制后仍无效：必须重启应用，很多工具不会热加载。

安全建议

API Keys：优先走环境变量
权限：配置文件建议 600
版本控制：不要提交包含密钥的配置

下一步

学习 Cursor Rules 编写指南来创建自定义的 AI 规则。

MCP 配置同步

注册解锁完整内容