MCP 工具
读完你能：添加并管好 MCP 工具，让 AI 能调用外部服务和内置的图像、浏览器、桌面自动化能力。
MCP（Model Context Protocol）是给 AI 接外部工具的标准：你把一个「MCP 服务器」配进来，AI 就多一组能调用的工具，比如查数据库、控制浏览器、生成图片。
1. 打开工具设置
Section titled “1. 打开工具设置”入口：设置 → 工具
页面上方是「MCP 工具配置」区，列出所有 MCP 服务器；下方是内置能力的开关区（见第 5 节）。列表为空时会提示「未找到 MCP 服务器」。
2. 添加 MCP
Section titled “2. 添加 MCP”点右上角「添加 MCP」，有三种方式：
| 方式 | 适合谁 | 怎么做 |
|---|---|---|
| 直接添加 | 手上有现成配置 | 在弹窗里粘贴服务文档中的 MCP JSON 配置，保存即可 |
| 从 JSON 导入 | 同上（批量） | 粘贴包含多个服务器的 JSON，一次导入多个 |
| 一键导入 | 本机装过 Claude Code、Gemini CLI 等 CLI 工具 | 见第 4 节「扫描导入」 |
也可以选「通过对话添加」，让管家引导你完成。
粘贴 JSON 时注意页面提示：请将服务文档中的 MCP JSON 配置粘贴到下方输入框。如果配置里使用了 npx、uvx 等命令，请先确认它们已安装并且当前机器可用。支持的接入类型：
| 类型 | 特征 | 例子 |
|---|---|---|
| stdio | 本机命令行程序 | command + args 启动的进程 |
| http / sse | 远程服务地址 | url + 请求头 |
保存后软件会立刻自动检测一次连通性，状态见下一节。
3. 管理与状态
Section titled “3. 管理与状态”每个 MCP 服务器是一行，点开展开配置和工具列表：
| 操作 | 说明 |
|---|---|
| 编辑 | 改名称、配置；编辑时不能修改名称所在的服务器键名 |
| 删除 | 删除前确认「确定要删除此 MCP 服务器吗？」 |
| 检测MCP可用状态 | 服务器行上的刷新按钮；成功提示「连接测试成功」 |
| 登录 | 支持 OAuth 的远程服务会显示「登录」按钮，登录成功提示「OAuth 登录成功」 |
状态图标含义（悬停可看说明和检测时间）：
| 状态 | 含义 |
|---|---|
| 手动检测该 MCP 可用 | 最近一次检测成功，附检测时间 |
| 已认证 | OAuth 已登录 |
| 未测试 | 还没检测过 |
| 失败 | 最近一次检测失败，附检测时间与可能原因 |
4. 扫描导入（一键导入）
Section titled “4. 扫描导入（一键导入）”本机装过 CLI Agent（如 Claude Code、Gemini CLI）的，点「添加 MCP」旁的「一键导入」，按三步向导走：
| 步骤 | 页面做什么 |
|---|---|
| 1 选择Agent | 下拉框列出检测到的 CLI，选一个 |
| 2 获取mcp | 显示「检测到 N 个 MCP」，并标注每个的处置：将导入 / 已跳过 |
| 3 导入成功 | 显示「已导入 N 个 MCP」 |
被跳过的条目会写明原因，常见的有：已经导入、不支持、这是 CLI 插件托管的 MCP，不能在这里导入、它在 CLI 中处于禁用状态、需要先在 CLI 中完成登录或授权、它当前在 CLI 中不可用。
5. 内置 MCP 工具
Section titled “5. 内置 MCP 工具”下面三个能力开箱即带，都在「设置 → 工具」页管理：
| 内置能力 | 它是什么 | 怎么用 |
|---|---|---|
| 图像生成 | 内置的图像生成 MCP 服务器，需要先选一个「图像模型」 | 打开开关；「图像模型」下拉里没有可选项时，点「前往配置」先去模型页配好 |
| 应用内浏览器 | 默认开启。Agent 在应用内浏览器侧边面板里帮你打开网页、点击、填表；它只能操作这一个页面，碰不到 AIPC UP 界面本身，也不会另开 Chrome 窗口 | 用 Agent 对话即可；「允许 Agent 操作 APP 内的浏览器」开关可整体关闭；「清空浏览数据」会退出所有已登录网站并清空缓存，不可恢复 |
| 桌面自动化 MCP | 让 AI 调用 desktop_automation_* 系列工具，操作 Windows 键鼠 | 见下方说明 |
「应用内浏览器」的登录态与 AIPC UP 里看到的浏览器一致，Agent 可直接沿用你已登录的页面；要清空它的 Cookie 与缓存，用「清空浏览数据」按钮并确认。
图像生成支持的图像模型（悬停「图像模型」字段可看同一份说明）：Google Gemini / Vertex AI 图像模型（如 gemini-2.5-flash-image）、OpenRouter 中转的图像 chat 模型（如 nano-banana、gemini-image）、AntigravityTools（gemini-3-pro-image）；gpt-image-* / dall-e-* / Imagen / FLUX 等模型使用不同 API，暂不支持。
6. 绑定到助手与常见报错
Section titled “6. 绑定到助手与常见报错”- 绑定到助手：在 助手中心 的助手详情「默认配置」里选 MCP，可跳转「前往 MCP 设置」；也可以在会话里临时选用，见 权限与安全 对会话权限的说明
- 启动报错：MCP 服务器启动失败时，状态里会直接告诉你缺什么、装什么，照做后重新检测即可。表中状态提示为简写，以应用内实际提示为准；完整消息可能类似「未找到命令 bun。请安装 Bun（包含 bun/bunx），重启 AIPC UP，或把这个 MCP server 改成绝对命令路径。」具体文字以当前应用显示为准。
| 状态提示 | 处理 |
|---|---|
| 未找到命令 bun，请安装 Bun | 安装 Bun 后重启软件再检测 |
| 未找到命令 uv，请安装 uv | 安装 uv 后重启软件再检测 |
| 未找到命令 python，请安装 Python | 安装 Python 后重启软件再检测 |
| 未找到命令（其它） | 安装对应命令，或把该 MCP 服务器改成绝对命令路径 |
| 连接测试超时 / 无法连接 | 检查该服务是否需要网络或代理，确认配置后再检测 |
- 「设置 → 工具」的 MCP 列表里出现你添加的服务器，检测状态为「手动检测该 MCP 可用」
- 支持 OAuth 的服务器登录后状态变为「已认证」
- 内置「图像生成」开关能打开，且图像模型下拉里有可选模型
- 会话里 AI 能实际调用你添加的工具（比如让它操作应用内浏览器，侧边面板能看到动作）