文档能力扩展
文档目录

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 管理中完成启用和连接验证。」
  • 选中后输入框里出现 #服务器名 的引用块。
  • 工具实际被调用时,过程区显示「服务器名 / 工具名」,悬停可以看清完整的工具标识。

注意

  • 开关打开不等于接通:状态显示「待配置」就是在提示上次验证没过。
  • 环境变量和请求头里不要写明文密钥,用凭据流程保存;配置本身是明文文件。
  • 没有单独的启动、停止、重连按钮,出现问题时先测试连接再改配置,或关掉开关重新打开以重新验证。
本页内容