跳到正文

故障排除

这里按大致出现顺序列出了用户实际遇到的问题及解决方法。如果都无法解决,请让你的 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 的钥匙串中,挡住了新的密钥。

  1. 从菜单栏图标退出 LMCP。
  2. 在“终端”中运行 security delete-generic-password -s com.local-mcp.tunnel-device-key.v1,或打开“钥匙串访问”,搜索 com.local-mcp.tunnel-device-key.v1 并删除该项目。
  3. 从“应用程序”中重新打开 LMCP。
  4. 在你的 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.log

Windows:从系统托盘使用 LMCP → Diagnostics → Open logs。

仍未解决?

搜索帮助中心(你的问题会帮助我们改进),或联系我们。