服务与工具(MCP)
MCP(Model Context Protocol)是一种标准化的外部工具接入协议。管理员在系统中登记 MCP 服务后,用户按需启用并配置参数,即可让 AI 在对话中调用这些工具(联网搜索、地图查询、数据库检索等)。
左侧菜单工具进入工具页,顶部两个视图:
| 视图 | 内容 |
|---|---|
| 服务与工具 | 系统内全部可用服务 |
| 我的工具 | 你已配置的服务 |
NOTE
用户不能自建 MCP 服务,只能使用管理员预置的服务;服务列表分页加载(提示「超过最大页数限制」时请缩小浏览范围或稍后再试)。
查看与配置服务
- 在「服务与工具」中点击服务卡片上的详情,阅读 Markdown 介绍与「相关网址:{url}」;
- 点击配置(未配置过的显示启用)打开配置弹窗:
- 介绍页签:服务说明(Markdown 渲染);
- 配置页签:服务参数表(请参考「介绍」页签进行配置)——列为参数 / 值 / 敏感信息;无需参数的服务会提示「该服务无需配置参数即可使用。」;
- 逐项填写参数值(输入框提示「请输入变量值 {参数名}」);
- 状态选择:
- 启用:保存并生效;
- 暂存:仅保存草稿,不生效;
- 点击确定,提示「保存配置成功」。
NOTE
「敏感信息」标记的参数(问号提示:敏感信息会进行加密存储)如 API Key、token 等,保存后加密落库。打开设置表单时会解密并返回前端供编辑;数据库加密不代表该授权设置响应不包含明文。
示例:

管理员配置 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 服务。