桌面应用中的本地连接
桌面应用可以通过 stdio 启动本地 MCP 服务器。这样，AI 就能访问更丰富的 Google 和 Microsoft 功能、Nextcloud 以及浏览器无法执行的其他工具。内置了本地文件访问，无需 MCP 服务器。
入门指南
首次设置时，请按以下步骤操作：
- 选择一个本地的 默认文件夹 作为内置文件工具的工作目录。
- 可选地，选择一个本地的 Nextcloud 连接。
- 可选地，从工具商店添加其他 MCP 服务器。
你可以推迟整个入门流程。默认文件夹和其他连接可以稍后设置。所有文件夹选择仅保存在本地。
工具商店
点击 添加工具 或 添加 MCP 服务器。你首先会看到适合桌面应用的安全预设。只有选择 手动添加 MCP 服务器 时，才会打开手动填写表单。
常用预设包括：
| 预设 | 功能 | 登录方式 |
|---|---|---|
| Nextcloud | 文件、日历和联系人 | 服务器地址、用户名和应用密码 |
| Memory | 保存知识并稍后检索 | 本地存储 |
商店还可能展示 GitHub、Canva、Notion、Supabase、Mailchimp 以及其他合适 MCP 服务器的预设。可用性取决于平台、认证和当前目录。
Google 和 Microsoft
Google Workspace 和 Microsoft 365 是内置的 AI-School 连接。它们支持网页、移动和桌面端，不依赖 OpenAI 或本地 MCP 预设。经过一次性 Google 或 Microsoft 授权后，可与 OpenAI、Claude、Gemini 和 Mistral 一起使用可用工具，前提是所选模型支持工具使用。
动态工具选择
一个 MCP 服务器可能提供数十个工具。桌面深度代理因此先加载简洁的工具信息，并在任务执行时选择相关工具。这样可以同时激活多个大型 MCP 服务器，而无需将所有工具全部放入模型上下文。
安全安装
本地 MCP 安装在 Angular 界面和 Electron 之间有严格的边界：
- 渲染器不启动任意 shell 命令；
- 命令、参数、环境变量键和请求的访问权限均受控；
- 原生对话框显示启动内容；
- 经过批准的配置拥有完整性证明；
- 密钥使用操作系统的安全存储加密；
- 关闭、删除、注销和退出时进程会停止。
删除服务器时，本地存储的凭据也会被删除。
状态与测试
在 此电脑上 可查看所有活动的本地服务器。聊天设置中，本地和远程连接统一显示在 连接 下。
用具体问题测试服务器，例如：
- “我的 Nextcloud 中有哪些文件夹？”
- “查找关于该项目的最新邮件。”
- “这个本地文件夹里有哪些文件？”
遇到问题时，请检查桌面日志。成功连接会显示服务器名称和加载的工具数量。
故障排除
- 服务器已启动但 AI 看不到工具：重启本地运行时，检查聊天请求中是否包含服务器 ID。
- 缺少登录信息：在 偏好设置 → 工具 中打开服务器，重新连接。
- Nextcloud 无法使用：使用 Nextcloud 环境的基础 URL 和单独的应用密码。
- 本地文件无法访问：确认活动工作目录仍存在，必要时通过仪表盘重新选择。
- 工具过多：保持动态工具选择开启，并在提问时明确指定所需来源。
手动添加 stdio 服务器
优先使用预设。仅当你信任来源和命令时，才手动添加服务器。批准前请检查：
- 可执行文件和参数；
- 环境变量键；
- 文件系统访问权限；
- 读写能力。
另见
访问本地文件夹
内置文件工具只能读取或修改你通过原生文件夹选择器明确授权的工作目录内的文件。
所有路径都会被解析到规范位置。使用相似前缀的邻近文件夹或超出授权文件夹范围的符号链接将被拒绝。重启本地运行时后，权限会重新同步；无授权文件夹时，默认拒绝文件访问。
当你请求 AI 删除文件或子文件夹时，桌面应用会将该项移动到系统回收站。此功能支持 Windows、macOS 和 Linux。已授权的主文件夹本身不能通过 AI 移动到回收站。
