故障排除
这里按大致出现顺序列出了用户实际遇到的问题及解决方法。如果都无法解决,请让你的 AI 运行诊断——它可以代你报告问题。
工具未显示在我的 AI 客户端中
- 安装后重启一次 AI 应用——MCP 客户端在启动时读取配置。
- Cursor / VS Code:工具仅在 Agent 模式下显示(Chat 和 Edit 模式不提供 MCP 工具)。
- 确认 Mac 菜单栏或 Windows 系统托盘中存在 LMCP 图标,且状态点为绿色。
菜单栏或系统托盘图标缺失
在 Mac 上从“应用程序”打开 Local MCP,或在 Windows 上从“开始”菜单打开。Mac 用户可以按照托盘未运行指南重置 LaunchAgent;在 Windows 上,请从任务管理器退出 LMCP,然后从“开始”菜单重新打开。
“权限被拒绝”或结果为空
缺少操作系统或应用权限。请查看权限指南。在 Mac 上,Mail、iMessage 和本地消息缓存可能需要完全磁盘访问权限,而在应用中执行操作可能需要自动化权限。在 Windows 上,请检查设置 → 隐私和安全性,并确认相关桌面应用已登录且本地数据可用。
ChatGPT / Claude.ai 无法访问我的计算机
- 在菜单栏应用中开启网页访问(Your web AI · Cloud Relay)——默认关闭。
- 确保 Mac 或 Windows PC 处于唤醒且联网状态;中继会自动重新连接。
- 如果连接器显示身份验证错误,请从菜单栏重新复制连接 URL/令牌——参见连接你的 AI。
工具失败或返回了异常内容
让你的 AI “报告此问题”——LMCP 内置了报告工具,可捕获完整的诊断快照(版本、权限状态、近期错误),并一步发送给团队。你会收到一个案例 ID。
在 Mac 上,你还可以让 AI 运行 lmcp_doctor。它会先预览针对 AI 客户端配置、权限、集成和更新的检查,然后只修复你明确确认的安全项目。Windows 的同等引导式修复流程仍在开发中。
日志位置
Mac:
~/Library/Application Support/Local MCP/server.logWindows:从系统托盘使用 LMCP → Diagnostics → Open logs。