「工具」用于把外部 MCP 服务接入对话。你可以在管理端开启 MCP、登记 Streamable HTTP 服务、同步工具、编辑工具展示信息，并限制单条消息能触发的调用量。

使用入口#

进入管理端后打开 工具。页面分为三部分：

1. 顶部的 MCP 全局设置。
2. MCP 服务 列表。
3. 点击工具数量后打开的单个服务 MCP 工具 面板。

启用 MCP 工具 关闭时，全局设置以下的内容会隐藏。只有开关开启、服务为「开启」、工具为「已启用」，且单消息限制允许时，用户才能在对话中选择 MCP 工具。

开启 MCP 并设置限制#

1. 打开 启用 MCP 工具。
2. 设置 单消息可选工具数量。默认 32，最大 128。
3. 设置 最大 LLM 请求次数。默认 5，最小 2。它包含单条消息的首次请求和最终总结。
4. 设置 最大 MCP Tool 调用次数。默认 8。失败调用也计入次数。
5. 设置 MCP Tool 并发上限。默认 8，按服务实例计算。
6. 设置 MCP Tool 调用超时，单位秒。默认 10。
7. 设置 MCP Tool 重试次数。默认 0。
8. 可选填写 MCP Tool 调用提示词，控制模型何时以及如何调用工具。留空使用内置默认提示词。
9. 点击 保存。只有字段发生变化后才会出现该按钮。

关闭开关只会隐藏服务与工具列表，已登记的服务和工具记录会保留。

新增 MCP 服务#

1. 在服务列表上方点击 新增。
2. 填写 服务名称。
3. 选择 服务状态：开启 或 关闭。
4. 填写 服务地址，即 MCP Streamable HTTP 端点，例如 https://example.com/mcp。
5. 可选填写 鉴权密钥。新增时占位提示为「可留空」，编辑时为「留空则不变」。
6. 可选填写 请求头，格式为 JSON，例如 {"X-API-Key": "..."}。
7. 点击 创建。保存后系统会自动同步该服务的工具。

点击 请求头 旁的 快速填入，选择 签名用户上下文，会写入：

{  "X-Deeix-User-Context": "${DEEIX_SIGNED_USER_CONTEXT}"}

如果同名请求头已存在且值不同，预设不会覆盖，并提示「请求头已存在且内容不同，未覆盖」。

同步工具#

1. 在服务行点击同步图标，或打开服务的工具面板后点击 同步。
2. 如果该服务已有自定义名称或说明，选择处理方式：
   • 保留当前内容 —— 名称和说明不变，其他信息正常同步。
   • 使用服务端内容 —— 同步 MCP 服务返回的名称和说明。
3. 等待提示「MCP 工具已同步」。

外部服务新增、删除或修改工具后，都需要重新同步。同步只读取服务端的工具列表和 Schema，不会判断工具是否适合开放。

管理工具#

点击服务的工具数量（例如 3/8，表示已启用/总数）打开工具面板。

• 按工具名称或描述搜索。
• 按 状态 筛选：全部、已启用、已停用。
• 按 自定义顺序、名称 A-Z、名称 Z-A、状态、最近更新 或 最早更新 排序。
• 用 启用 开关单独切换一个工具。
• 勾选多个工具后，用 启用 或 停用 批量修改。确认框会显示已选数量。

服务从未同步时，面板显示「暂无工具，请先同步」。服务同步失败时，错误信息会显示在工具表格上方。

编辑工具展示与图片处理#

1. 点击工具行上的铅笔图标。
2. 编辑 展示名称。它是用户在对话工具选择器中看到的名字，最长 160 个字符。
3. 编辑 描述。用户据此判断工具适合处理什么任务，最长 4096 个字符。
4. 点击 保存。

对于可接收图片数据的工具，打开 图片附件处理。开启后，后台先调用此工具，主模型只接收文本结果。参数需要按工具 Schema 手动映射，系统不会自动识别字段。

所有必填参数都映射到图片参数或用户问题参数后，保存按钮才可用。未映射的必填参数会以「未映射必填参数：{names}」列出。Schema 中没有字符串参数时会提示「当前工具 Schema 没有可接收图片数据的字符串参数，无法启用此能力」。

点击 Schema 图标打开 工具 Schema，查看输入参数 JSON Schema，并可在弹窗中复制。

调整对话选择器顺序#

1. 在服务列表上方点击 顺序。
2. 在 MCP 服务 列表中拖拽调整服务顺序。
3. 选中一个服务，在 工具 列表中拖拽调整该服务内工具的顺序。
4. 点击 保存。保存后工具排序会重置为 自定义顺序。

配置参考#

全局设置#

服务地址、鉴权密钥、请求头和工具 Schema 属于服务与工具记录，不是这些全局 mcp.* 设置。

服务字段#

常见问题#

相关#

• 计费：MCP 工具按次定价。
• 能力与透传：原生工具行为。
• 日志：工具调用事件和失败记录。