第十七章：常见问题 FAQ（30 个普通用户最常问）

A. 安装 / 配置类（10 题）

Q1. 装完 Claude Desktop，找不到"开发者 → 编辑配置"按钮？

症状：菜单里没有这一项。 原因：版本太老。 解决：升级 Claude Desktop 到 2025 年中之后版本即可。

Q2. claude_desktop_config.json 在哪儿？

Mac：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

打不开就先在 Claude 设置里点"编辑配置"按钮自动创建。

Q3. 我改了 JSON 但 Claude 一直没反应？

90% 是因为：

• 没完全退出 Claude——Mac 用 Cmd+Q，Windows 关托盘图标；
• JSON 语法错了——多/少了逗号，去 jsonlint.com 校验；
• 路径不存在——args 里写的目录必须存在。

Q4. 我用 npx 但提示 "command not found"？

原因：Node.js 没装或没加 PATH。 解决：去 nodejs.org 下载 LTS 安装包重装，安装时勾选"Add to PATH"。

Q5. Windows 上 args 里的路径要怎么写？

要用双反斜杠 C:\\Users\\you\\Desktop， 或用正斜杠 C:/Users/you/Desktop。 绝不能写单反斜杠 C:\Users\you\Desktop。

Q6. 我配了 MCP，工具图标出现了，但点开是空的？

原因：MCP 服务器启动失败但 Claude 没明确报错。 解决：去日志目录看：

• Mac：~/Library/Logs/Claude/
• Windows：%APPDATA%\Claude\logs\

最常见错误：包名拼错、API key 没填、依赖没装。

Q7. 装 uvx 是干嘛的？必须装吗？

uvx 是 Python 包管理器 uv 的"运行任意工具"命令。 很多 Python MCP 服务器需要它。 不装就用不了 fetch / time / git / sqlite 等官方 Python MCP——所以建议装。

Q8. 公司电脑装不了软件 / 命令行被限制？

最简方案：

• 走远程 MCP（飞书 / Notion / GitHub 等官方版本，OAuth 即可）；
• 走 Claude Desktop 内置 Connectors——通常不需要安装额外软件；
• 找 IT 申请 Node.js / Python 安装权限。

Q9. Mac 上提示 "无法验证此应用 / 损坏的应用程序"？

去 系统设置 → 隐私与安全性，手动允许它运行； 或终端运行 xattr -dr com.apple.quarantine /Applications/Claude.app。

Q10. 我能在手机上用 MCP 吗？

可以。

• Claude iOS / Android App 已支持远程 MCP；
• ChatGPT App 通过 Connectors；
• 本地 stdio MCP 一般跑不了（手机上没 Node.js / uv），可以让家里电脑跑 MCP，再用 mcp-remote 暴露给手机。

B. 使用 / 提示词类（10 题）

Q11. 怎么知道我装的 MCP 都能干啥？

直接问 Claude：「告诉我所有可用 MCP 工具，按服务器分类列出来，每个工具一句话功能描述。」

Q12. AI 老忘记调用某个 MCP 怎么办？

提示词里显式提示工具名："请用 brave-search 搜……" / "用 notion MCP 写到……"。 AI 看到工具名会更主动调用。

Q13. AI 调了错的工具 / 调多次怎么办？

更精确的提示词 + 让它先列计划： "先告诉我你计划用哪些工具、按什么顺序；我确认后再执行。"

Q14. 我希望 AI 自动判断用哪个 MCP，怎么办？

把"目标 + 资源 + 约束"模板用上（详见第十三章）： 列出它有哪些 MCP，让它自己规划。

Q15. AI 老问"是否同意调用工具"，能不能批量同意？

可以但慎用：在 Claude Desktop / Cursor 设置里能配某个工具"自动允许"， 只对你绝对信任、操作低风险的工具开启（如 list_directory、read_file）。 任何写 / 删 / 发的工具，永远人工。

Q16. AI 调用工具时报"权限拒绝"？

• filesystem：你没把那个目录写进 args 的允许列表；
• 远程 MCP：OAuth scope 不够；
• 数据库 MCP：账号权限不够。

按对应路径加权限即可。

Q17. 一个 MCP 调用慢、卡住怎么办？

• 网络类（fetch / search）通常是网络抖动；
• 本地 MCP 卡住可能是它内部死循环——重启 Claude 解决；
• 远程 MCP 看一下服务状态页（status page）。

Q18. 我可以让 AI 同时调多个 MCP 吗？

可以，且这正是 MCP 的强项。 提示词里多写几个明确步骤，AI 会并行 / 串行调用多个工具。

Q19. 我能"撤销" AI 已经做过的事吗？

文件操作可看回收站； GitHub 提交可 revert； 邮件已发的撤回多数不能； 所以一定要养成"先 dry-run 再执行"的习惯——见第十三章三道闸。

Q20. AI 给我返回的内容怎么转成 PDF / Word？

让它直接写一份 markdown， 然后用 pandoc your-file.md -o your-file.pdf 转， 或装一个"export to PDF" MCP / 或用 macOS 自带的"打印 → 存为 PDF"。

C. 性能 / 体验类（5 题）

Q21. 装了 10 个 MCP，Claude 启动很慢？

正常。MCP 太多会拖慢启动 5-15 秒。 解决：临时不用的 MCP 在 JSON 里加 _disabled_ 前缀禁用。

Q22. AI 每次都要"装一遍" MCP 包，烦死了？

npx -y 每次跑会下载，第一次慢，之后会缓存，后续几乎瞬时。 要彻底避免，可以全局安装包：

npm i -g @modelcontextprotocol/server-filesystem

然后改 args 直接调用全局命令。

Q23. AI 老生成"假"的工具调用？

那是模型在 hallucinate（幻觉）。 解决：

• 升级到最新模型版本；
• 提示词里强调"必须真实调用 MCP，不要捏造"；
• 看 Claude / Cursor 是否真有调用记录（界面会显示）。

Q24. 远程 MCP 连不上 / OAuth 卡住？

• 检查代理 / VPN；
• 浏览器单独测一下能不能打开对应服务网址；
• 删掉旧的 OAuth token 重新授权；
• 看服务端 status page。

Q25. 我能给一个 MCP 切换到不同账号吗？

最干净的做法：在 OAuth 授权页撤销旧账号，重新走一次 OAuth； 或者在配置文件里改 token / 加 --profile 参数。

D. 安全 / 合规类（5 题）

Q26. AI 通过 MCP 看到的文件，会不会上传到云端？

• 本地 stdio MCP：文件内容会被发给 AI 模型（在云端），所以模型方能看见；
• 远程 MCP：内容也会先到 AI 模型那里再处理。

如果你对此担心，用本地模型 + 本地 MCP（如 Ollama + 本地客户端）。

Q27. 在公司用个人 token 配 MCP 合法吗？

通常不合法或违反公司政策。 公司账号必须用公司渠道。 最好让 IT 部门统一规划企业 MCP 网关。

Q28. MCP 会泄露我的隐私吗？

只有当你主动给它权限时才会，并且权限是你给的范围。 所以：永远只授予最小权限。

Q29. 怎么知道 AI 实际做了什么？

• Claude Desktop：界面里会显示每次工具调用的参数和结果；
• 看日志目录；
• 重要操作可在提示词里要求 AI"做完后写一份操作总结到文件"。

Q30. 我离职 / 换公司了，怎么撤销所有 MCP？

按下面顺序：

1. 删除所有公司账号配的 MCP；
2. 去对应平台撤销 OAuth；
3. 删除本地缓存（Claude / Cursor 配置文件）；
4. 把所有公司相关数据从你的 Notion / Memory MCP 里清掉；
5. 把 token / API Key 全部 rotate（让公司侧无效化）。

五、错误信息查询表（按关键字）

六、本章小结

1. 30 个 FAQ + 错误关键字表，覆盖 95% 普通用户的真实问题；
2. 遇到问题先 Ctrl+F 这一章；
3. 还查不到，去附录 C「故障排查手册」按"症状 → 排查路径"走。

七、动手任务（5 分钟）

把这一章打印或截图保存—— 任何时候 MCP 出问题，先看这一章。