跳转到主内容

桌面应用中的本地连接

桌面应用可以通过 stdio 启动本地 MCP 服务器。这样,AI 就能访问更丰富的 Google 和 Microsoft 功能、Nextcloud 以及浏览器无法执行的其他工具。内置了本地文件访问,无需 MCP 服务器。

入门指南

首次设置时,请完成以下步骤:

  1. 选择一个本地的 默认文件夹 作为内置文件工具的工作目录。
  2. 可选地,选择一个本地的 Nextcloud 连接。
  3. 可选地,从工具商店添加其他 MCP 服务器。

您可以推迟整个入门流程。默认文件夹和其他连接可以稍后设置。所有文件夹选择仅保存在本地。

工具商店

点击 添加工具添加 MCP 服务器。您首先会看到适合桌面应用的安全预设。只有选择 手动添加 MCP 服务器 时,才会打开手动填写表单。

预设功能登录方式
Nextcloud文件、日历和联系人服务器地址、用户名和应用密码
Memory保存知识并稍后检索本地存储

商店还可能显示适用于 GitHub、Canva、Notion、Supabase、Mailchimp 及其他合适 MCP 服务器的预设。可用性取决于平台、认证和信息安全政策。

Google 和 Microsoft

Google Workspace 和 Microsoft 365 是内置的 AI-Public 连接。它们支持网页、移动和桌面端,不依赖 OpenAI 或本地 MCP 预设。经过一次性 Google 或 Microsoft 授权后,可与 OpenAI、Claude、Gemini 和 Mistral 一起使用可用工具,前提是所选模型支持工具使用。

动态工具选择

一个 MCP 服务器可以提供数十个工具。桌面深度代理会在任务中选择相关工具。因此,可以同时激活多个大型 MCP 服务器,而无需将所有工具同时放入模型上下文。

安全安装

  • 渲染器不会启动任意 shell 命令。
  • 命令、参数、环境变量和请求的访问权限都会被检查。
  • 原生对话框显示启动内容。
  • 通过审核的配置会获得完整性证明。
  • 密钥使用操作系统的安全存储加密。
  • 关闭、删除、注销和退出时会停止进程。

删除服务器时,本地存储的凭据也会被删除。

状态与测试

此电脑上 显示所有活动的本地服务器。聊天设置中,本地和远程连接统一显示在 连接 下。

可用具体问题测试,例如:

  • “我们的 Nextcloud 中有哪些文件夹?”
  • “查找关于此案卷的最新邮件。”
  • “总结此本地文件夹中的文档。”

故障排除

  • 服务器已启动,但无工具:重启本地运行时并检查服务器状态。
  • 缺少登录信息:在 偏好设置 → 工具 中打开服务器,重新连接。
  • Nextcloud 无法使用:使用环境的基础 URL 和单独的应用密码。
  • 本地文件无法访问:检查活动工作目录是否存在,必要时通过仪表盘重新选择。
  • 工具过多激活:保持动态工具选择开启,并在提问时指定所需来源。

手动添加 stdio 服务器

优先使用组织批准的预设。手动安装时,请检查可执行文件、参数、环境变量、文件系统访问权限及读写能力。

另见

访问本地文件夹

内置文件工具只能读取或修改您通过原生文件夹选择器明确授权的工作目录内的文件。

所有路径都会被规范化到标准位置。使用相邻文件夹的相似前缀或符号链接指向未授权文件夹的尝试将被拒绝。重启本地运行时后,权限会重新同步;无授权文件夹时,默认拒绝文件访问。

当您请求 AI 删除文件或子文件夹时,桌面应用会将该项移动到系统回收站。此功能支持 Windows、macOS 和 Linux。授权的主文件夹本身不能通过 AI 移动到回收站。

WhatsApp