MCP 工具管理用于把外部 MCP 服务接入对话。管理员可以开启 MCP 能力、配置服务端点、同步工具列表、编辑工具展示信息，并限制单次对话中的选择数量和调用次数。
使用入口#
进入管理端后打开“工具”。页面包含 MCP 工具全局设置、MCP 服务列表和 MCP 工具列表。
用户能否在对话中选择 MCP 工具，取决于全局开关、服务状态、工具状态和管理员设置的调用限制。
全局设置#
全局设置用于控制 MCP 是否对用户开放，以及单次消息的执行边界。
| 设置 | 影响 |
|---|---|
| 启用 MCP 工具 | 关闭后，用户不能在对话中选择 MCP 工具。 |
| 单消息可选工具数量 | 限制用户一次消息最多选择多少个工具。 |
| 最大 LLM 请求次数 | 限制一次工具链中模型请求的总次数，包含初始请求和总结请求。 |
| 最大 Tool 调用次数 | 限制一次消息内工具调用总数，失败调用也会计入。 |
| 并发上限 | 限制单个服务实例同时执行的工具调用数量。 |
| 调用超时 | 限制单次工具调用最长等待时间。 |
| 重试次数 | 控制工具调用失败后的重试次数。 |
这些限制用于保护平台稳定性。工具数量和调用次数过高，可能导致响应变慢、成本上升或外部服务压力过大。
MCP 服务#
MCP 服务列表展示服务名称、地址、状态、工具数量和同步时间。管理员可以新增、编辑、启停、删除服务，或对服务执行工具同步。
新增服务时，需要填写服务名称、服务地址、状态、鉴权密钥和请求头。鉴权密钥保存后不会完整展示；编辑时留空通常表示不修改原密钥。
停用服务后，该服务下的工具不会继续提供给用户选择。删除服务前应确认相关工具不再被业务依赖。
工具同步#
同步工具会从 MCP 服务读取工具名称、描述和参数 Schema，并更新后台工具列表。首次新增服务后应先同步，再逐个检查工具是否适合开放。
当外部 MCP 服务新增、删除或修改工具时，也需要重新同步。同步不会自动判断业务安全性，管理员仍需要检查工具描述、参数和启用状态。
工具列表#
工具列表支持搜索工具名称和描述，并按状态筛选、排序。管理员可以启用或停用单个工具，也可以批量启用或停用当前选中的工具。
停用工具适合临时下线高风险能力、外部服务异常、参数不稳定或工具结果质量不可靠的情况。重新启用前建议先确认服务端已经恢复。
编辑工具展示#
管理员可以编辑工具展示名称和描述。展示名称影响用户在工具选择器里看到的名称，描述会帮助用户判断工具适合处理什么任务。
描述应写清楚工具适合做什么、不适合做什么、需要哪些输入。不要把内部密钥、私有地址或敏感流程写进展示描述。
查看 Schema#
工具 Schema 用于查看工具需要的输入参数结构。管理员可以通过它判断工具是否容易被用户正确使用，以及是否存在不适合开放的敏感参数。
如果工具参数复杂，建议在展示描述中补充使用场景；如果工具参数涉及高风险操作，应默认停用，等完成权限和审计策略后再开放。
使用建议#
先开启少量只读、低风险工具，验证服务稳定性和用户体验，再开放写入或外部执行类工具。为每个服务设置合理超时和并发，避免单个工具拖慢整轮对话。工具变更后及时同步并复核启用状态。