为什么需要在多个工具之间同步 MCP 配置？

Claude Code、Cursor、Windsurf、VS Code、Claude Desktop 各有自己的 MCP 配置文件。同步的目标只有一个：保证所有工具里的 MCP 服务器列表一致，避免「这边能用那边不能用」。本章给的 3 句口诀：先选一个主配置，其它工具复制它；服务器名称必须完全一致；改完一定重启工具，否则不会加载。

每个工具的 MCP 配置文件路径分别在哪？

macOS 速查：Claude Desktop = `~/Library/Application Support/Claude/claude_desktop_config.json`；Cursor = `~/.cursor/mcp.json`；Windsurf = `~/.codeium/windsurf/mcp_config.json`；Claude Code = `~/.claude.json`（不只是 MCP）；VS Code = `~/Library/Application Support/Code/User/settings.json`。Claude Code (CLI) 目前不支持通过 .claude.json 直接配 MCP server，要用 `claude mcp add` 命令。

VS Code 配 MCP 跟 Cursor 写法有什么区别？

结构不同。Claude Desktop 和 Cursor 都用顶层 `mcpServers` 字段，VS Code 必须写成 `mcp.servers`（嵌套在 `mcp` 下）。本章常见问题里点名：“VS Code 看不到 MCP” 通常就是因为写到了 `mcpServers` 里 —— 改成 `mcp.servers` 就好。

怎么用一行命令对比两个工具的 MCP 配置是不是一致？

本章最小化对比脚本：用 `jq -S` 排序后导出再 diff。例如对比 Cursor 和 Claude Desktop：`jq -S '.mcpServers // {}' ~/.cursor/mcp.json > /tmp/cursor-mcp.json` 加同样命令处理 claude_desktop_config.json，最后 `diff -u /tmp/cursor-mcp.json /tmp/claude-mcp.json`。`jq -S` 把 key 排序，diff 才不会被字段顺序干扰。

MCP 配置里的 API key 怎么处理才安全？

本章 3 条安全建议：(1) API keys 优先走环境变量，不要硬编码在 JSON；(2) 配置文件权限设成 600（`chmod 600`），只有自己能读；(3) 不要把含密钥的配置提交到 git。把 key 写在 `~/.zshrc` 用 `export OPENAI_API_KEY=...` 然后在 MCP env 字段引用，比直接贴明文安全得多。

MCP 配置同步 - Vibe Coding

学AI来匠人

📖

Vibe Coding

38 节

·简介

基础篇6

01
Vibe Coding 是什么
5分钟
02
安装 Cursor 与环境准备
10分钟
03
写出第一个 Prompt
10分钟
04
Vibe Coding 思维模型
8分钟
05
高质量 Prompt 模板
12分钟
06
理解与校验 AI 的回复
10分钟

进阶篇18

07
🔒用 AI 做 Debug
20分钟
08
🔒与 AI 结对编程
18分钟
09
🔒多文件协作与项目级修改
25分钟
10
🔒交付一个小功能的全流程
30分钟
11
🔒用 AI 做测试与质量保障
20分钟
12
性能与成本优化
18分钟
13
安全与隐私最佳实践
15分钟
14
🔒团队协作与 PR 流程
18分钟
15
工具与模型最新动态
12分钟
16
🔒AI Agents 与工具调用
25分钟
17
🔒前后端协同与 API 生成
25分钟
18
🔒数据与知识库协作
22分钟
19
持续改进与自动化
18分钟
20
🔒AI 辅助重构与架构演进
22分钟
21
AI 辅助 UX 文案与交互
15分钟
22
🔒可观测性与 Guardrails
18分钟
23
脚手架与自动化交付
15分钟
24
🔒实战：Todo App
45分钟

工具篇13

25
🔒MCP 服务器配置
20分钟
26
🔒MCP 配置同步
15分钟
27
Cursor Rules 编写指南
15分钟
28
Git Commit 规范与 Emoji
10分钟
29
五个为什么分析法
8分钟
30
Mermaid 图表生成
12分钟
31
任务实施方法论
10分钟
32
Claude Code Skills 进阶
15分钟
33
Claude Code + GLM 4.6 配置
15分钟
34
Claude Code 自定义命令
12分钟
35
Claude Code 子代理配置
15分钟
36
Claude Code 全面拆解
25分钟
37
Claude Skill Codebook 简明教程
12分钟

实战篇1

38
Vibe Coding 全流程 SOP
15分钟

🎯学习更高效

让你的学习不被打断

✏️
学习笔记
边学边记，云端同步
📈
进度追踪
自动保存，随时继续
🏅
完课证书
可分享的学习成就
💬
社区答疑
和 2000+ 学员交流

免费注册→已有账号？登录

👥2,847 人正在学习

AI学习面试课程学习中心