Skip to content

服务与工具(MCP) ​

← 使用指南 · English

MCP(Model Context Protocol)是一种标准化的外部工具接入协议。管理员在系统中登记 MCP 服务后,用户按需启用并配置参数,即可让 AI 在对话中调用这些工具(联网搜索、地图查询、数据库检索等)。

左侧菜单工具进入工具页,顶部两个视图:

视图内容
服务与工具系统内全部可用服务
我的工具你已配置的服务

NOTE

用户不能自建 MCP 服务,只能使用管理员预置的服务;服务列表分页加载(提示「超过最大页数限制」时请缩小浏览范围或稍后再试)。

查看与配置服务 ​

  1. 在「服务与工具」中点击服务卡片上的详情,阅读 Markdown 介绍与「相关网址:{url}」;
  2. 点击配置(未配置过的显示启用)打开配置弹窗:
    • 介绍页签:服务说明(Markdown 渲染);
    • 配置页签:服务参数表(请参考「介绍」页签进行配置)——列为参数 / 值 / 敏感信息;无需参数的服务会提示「该服务无需配置参数即可使用。」;
  3. 逐项填写参数值(输入框提示「请输入变量值 {参数名}」);
  4. 状态选择:
    • 启用:保存并生效;
    • 暂存:仅保存草稿,不生效;
  5. 点击确定,提示「保存配置成功」。

NOTE

「敏感信息」标记的参数(问号提示:敏感信息会进行加密存储)如 API Key、token 等,保存后加密落库。打开设置表单时会解密并返回前端供编辑;数据库加密不代表该授权设置响应不包含明文。

示例:

MCP配置
MCP配置

管理员配置 HTTP 参数绑定 ​

对 SSE 和 Streamable HTTP 服务,管理员为预设参数或用户参数定义选择 HTTP 绑定(query / header),并可填写 请求名称。name 仍是关联用户已存值的稳定标识;未设置 bind_type 时按 Query 处理,未设置 bind_name 时使用 name,旧记录无需迁移。STDIO 环境变量名维持原有行为。

用户参数 Header 可配置 bind_name: "Authorization" 和 bind_value_template: "Bearer {value}";{value} 只使用该定义对应的用户值。未设置模板时使用原值,预设 Header 直接使用配置的常量。Header 值不进入 URL;Query 名称和值做 URL 编码。显式绑定要求非空的标量值;空或未知绑定类型、无效模板、非法 Header 及大小写不敏感的重复 Header 名称会被拒绝。显式 Query 同名绑定被拒绝,旧 Query 的用户值覆盖预设值行为保留。

用户仍使用原参数表单。编辑 token 后保存并重新打开核对,再确认服务已启用且由目标角色勾选。HTTP transport 请求/响应日志已关闭;这不会取消上述设置响应的解密回填行为。不要分享设置响应或未脱敏的 token。

在对话中使用 ​

工具需要在角色中勾选才会被调用(问号提示原文:「选中项表示本角色可能会用到该服务中的各种工具」):

  • 在角色进阶设置的「服务与工具(MCP)」中勾选;
  • 或在对话输入栏点击工具标签即时勾选(弹窗标题「配置角色使用的服务与工具」)。

配置好后,AI 会在需要时自动调用相应工具。

WARNING

DeepSeek 模型的深度思考与工具 / 联网搜索互斥:深度思考开启时会提示「DeepSeek 深度思考模式下不支持工具调用,请先关闭深度思考」,或自动关闭工具调用。

API ​

顶栏更多菜单 API 可生成工具类 API Key,通过 /ext/v1/mcp 接口拉取服务清单(全部已支持的 / 当前用户已启用的),详见 API 参考 · MCP 服务。


上一篇:应用与工作流 | 下一篇:模型选择与说明