MCP
对接浏览器、数据库、企业内部 API 等外部系统。
路径：系统设置 → 高级管理 → MCP。返回 高级管理总览。
MCP（Model Context Protocol，模型上下文协议）是智能体连接外部工具与数据源的统一方式，例如浏览器、数据库、GitHub、企业内部 API 等。对方提供 MCP Server 后，在本页添加即可被智能体调用。
它和 记忆力 互补：记忆管跨会话「记住什么」；MCP 管「连到哪些外部系统」。
不是人人都要配
写材料、改本地文件、表格分析，用内置读写与命令通常就够。需要对接浏览器、工单、库表或企业系统时再配置 MCP。
高级管理 · MCP · 概览：能力状态、服务器数量与空闲断开
一、为什么用适配器
直接把每个外部工具的完整说明塞进对话，很容易一次烧掉上万 Token。本产品内置 MCP 适配器：
- 对话里默认只有一个代理工具
mcp（搜索 / 查看 / 调用），按需发现能力，更省 Token - 懒连接：第一次真正调用时才启动对应服务器
- 超大输出会截断保护，避免撑爆上下文
MCP 为产品内置能力，不出现在插件管理中，也不能卸载。
二、适合 / 不适合
| 适合用 MCP | 通常不必上 MCP |
|---|---|
| 控制浏览器做打开、摘录、填表 | 只改当前工作目录里的 Word / Excel / Markdown |
| 查企业内部工单、CRM、知识库 API | 本地文件检索、按技能跑固定流程 |
| 连 GitHub / 数据库等已有 MCP Server | 一次性手工复制粘贴数据 |
和 技能库 的差别：技能是「说明书 + 本地脚本」；MCP 是「连上一个正在运行的外部服务」。能用技能或本地文件解决时，优先不要加 MCP，攻击面和排障成本都更低。
三、页面结构
| 标签 | 作用 |
|---|---|
| 概览 | 能力是否就绪、已配置服务器数量、启停状态 |
| 配置 | 快速添加（粘贴 mcpServers 片段）、列表启停与删除 |
| 维护 | 空闲断开、脚本模式、直连工具、自动鉴权；配置预览与恢复默认 |
配置文件一般在本机 Agent 目录：~/.pi/agent/mcp.json。
四、添加服务器
- 打开 配置 标签，点击 快速添加；
- 粘贴常见 MCP 文档中的
mcpServersJSON 片段（也可点 填入示例 看格式）； - 点击 确定添加，写入配置。
列表中可对单个服务器：
| 操作 | 说明 |
|---|---|
| 启用 / 禁用 | 临时停用而不删除配置 |
| 删除 | 从配置中移除该服务器 |
安全提示
MCP Server 可能在本机启动进程或访问远程 API，等同于执行第三方提供的能力。请只添加可信来源，注意密钥与内网地址不要写进会外传的材料。
五、维护参数
| 参数 | 说明 |
|---|---|
| 空闲断开（分钟） | 闲置多久后断开连接；0 表示不自动断开 |
| 脚本调用模式 | 允许一次脚本串联多次 MCP 调用 |
| 全局直连工具 | 开启后把服务器工具直接注册进智能体（更占上下文）；默认关闭，经代理调用更省 Token |
| 自动鉴权 | 需要 OAuth 时，在连接 / 调用时自动发起并重试一次 |
维护页还可 只读预览 当前 mcp.json，或 恢复默认（空服务器列表）。
六、对话中怎么用
配置并启用服务器后，用自然语言说目标即可，例如：
- 「用浏览器打开内部公告页，把今天三条标题摘到
公告.md」 - 「到工单系统查我名下未关闭的单，按优先级列表」
- 「在库里跑这条只读 SQL，结果导出成 csv」
智能体会通过代理工具 mcp 搜索 → 查看说明 → 调用，一般不必手写 JSON 或命令。第一次调用才真正拉起对应 Server，因此首开可能稍慢。
若弹出安全权限确认，按 参数配置 · 安全权限 选择允许一次 / 本会话允许 / 拒绝。
Token 与直连工具
默认代理模式最省上下文。只有个别工具每次都要用、且能接受多占 Token 时，再在维护里打开 全局直连工具。