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