MCP 服务
MCP 把外部工具接进会话:在能力中心添加服务器、通过真实握手验证,启用后在输入框用 # 引用,Agent 就能调用它的工具。
更新于 2026年11月10日
MCP 服务器是给 Agent 加外部工具的方式:查数据库、读工单、调内部接口,都可以包成一个 MCP 服务接进来。入口和能力中心的 Skills 在一起:左侧栏「MCP/Skills」进去,切到页头的「MCP」页签,标题右侧会标「N 个服务器」。
MCP 按项目配置,页头的项目切换下拉换一个项目,列表就换成那个项目的服务。
页面结构
- 我的 MCP:你自己添加的服务器。
- Proma 集成能力:随应用内置、由 Proma 托管的集成,只读展示,没有删除和开关(个别标「已关闭」的可以看配置来源和状态)。
- 连接:可选服务的目录,说明是「选择服务后按提示完成授权、安装或配置。」,卡片状态有「已连接」「待授权」「未配置」「检测中」「暂无法检测」。
内置项的详情面板列出 MCP 名称、分类(系统、自动化、协作、记忆、媒体、浏览器)、注入开关、可用状态、配置来源,以及逐个工具的清单,只读工具带「只读」标记。其中凭据网关那一项写明「凭据网关随 Proma 登录态自动注入,是生图、AI 应用生成等能力的基础设施,因此不提供开关。」
卡片
- 名称,加上「内置」或传输类型徽章(
stdio、HTTP、SSE)。 - 两行描述,或服务器地址;都没有时显示「未配置地址」。
- 右上角启用开关,右侧状态徽章:「已启用」「待配置」(验证失败过)「待验证」(从没测过)。
- 连接结果另有一枚「连接正常」或「连接失败」。
- 需要 OAuth 的服务器在卡片上给一个「OAuth 授权」按钮,参数不全时显示「补全 OAuth」。
添加服务器
右上「添加服务器」的表单只有两项必填:服务器名称(占位「例如: github-mcp」)和传输类型。
- stdio(命令行):命令(占位「例如: npx」)、参数(多个用逗号分隔)、环境变量(每行一个
KEY=VALUE)、启动超时(默认 30 秒)。 - HTTP(Streamable HTTP) / SSE(Server-Sent Events):URL(占位「例如: http://localhost:3000/mcp」)和请求头(每行一个
Key: Value)。
新建时启用开关默认关闭,提交按钮是「创建服务器」。
启用与验证
开关不是纯本地标记:打开时会实际建立一次连接,只有握手和工具发现都成功,才会在 Agent 会话里加载。
- 开关说明写明「保存后会进行真实连接验证;仅验证成功才会在 Agent 会话中加载。」
- 开关先乐观地变成开,后台验证失败会退回原状态并提示「X 启用失败」,附具体原因。
- 失败时的典型提示:凭据或网络问题统一说「MCP握手或工具发现失败,请检查凭据、服务状态及系统网络」;命令找不到说「命令不存在或不可执行: X」;地址写错说「无效的 URL 格式」。
- 详情页的「测试连接」是可选诊断,「测试结果不会影响 MCP 是否启用」;成功会说明「MCP 握手成功,发现 N 个工具」。
OAuth 授权
远程服务需要授权时,卡片上的「OAuth 授权」会打开浏览器走标准流程。
- 缺公开参数时弹「OAuth 参数待补全」,说明「请让 Agent 根据官方文档写入公开 clientId 或 registrationEndpoint;token 和 client secret 不会写入配置。」
- 需要 Client Secret 时先弹「保存 OAuth Client Secret」,并说明只加密保存到系统 Keychain,不写入配置文件、不显示给 Agent、也不回传到页面;点「安全保存并继续授权」后自动接着走浏览器授权。
- 浏览器里授权完会看到「授权完成,可以关闭此页面并返回 Proma。」,失败则是「授权未完成,请返回 Proma 重试。」
- 成功后提示「X 已完成授权」和「OAuth token 已安全保存,并已通过真实连接验证。」;如果授权成功但连不上,会明确区分「OAuth 已完成,但 MCP 握手或工具发现失败」。
编辑与删除
- 详情页的配置改动自动保存,提示「已保存」或「保存失败」,头部说明「配置变更会自动保存」。
- 名称和传输类型创建后不可改;内置项的命令、参数、环境变量、传输类型也不可改。
- 删除前确认「确认删除 MCP 服务器「X」?」和「删除后将无法恢复,确定要删除这个 MCP 服务器吗?」;成功提示「已删除 MCP 服务器:X」,同时清掉保存的凭据。配置删掉但凭据清理失败时会单独说明「MCP 配置已删除,但安全凭据清理失败」。
会话中的引用
- 在输入框输入
#唤起「MCP 服务」候选,只列已启用且验证成功的服务器;一个都没有时提示「没有可引用的 MCP;请先在 MCP 管理中完成启用和连接验证。」 - 选中后输入框里出现
#服务器名的引用块。 - 工具实际被调用时,过程区显示「服务器名 / 工具名」,悬停可以看清完整的工具标识。
注意
- 开关打开不等于接通:状态显示「待配置」就是在提示上次验证没过。
- 环境变量和请求头里不要写明文密钥,用凭据流程保存;配置本身是明文文件。
- 没有单独的启动、停止、重连按钮,出现问题时先测试连接再改配置,或关掉开关重新打开以重新验证。