随着 Agent 应用逐步从知识问答扩展到业务查询、数据获取和外部系统调用，开发人员需要管理的内容也在发生变化。

在仅依赖大模型能力时，Agent 的主要工作是理解问题、结合上下文生成内容并返回结果。但当 Agent 需要查询实时数据、调用业务接口或连接外部服务时，就需要通过工具扩展自身能力。

工具数量较少时，开发人员可以分别记录接口地址、参数说明和调用方式。但随着 Agent 数量和工具数量持续增加，分散维护方式容易产生重复配置和信息不一致等问题。

>**qKnow 开源版 v2.4.0 新增 MCP 远程工具管理模块，支持通过 HTTP 方式接入 MCP 服务，并可以在 Agent 编排中选择已经启用的 MCP 工具。除 MCP 模块外，本次版本还增加了开源协议提示，并对系统名称、Skills 菜单图标、初始化脚本和初始数据文件进行了调整。**

本文将按照远程工具管理、HTTP 接入、Agent 编排、工具同步和能力边界等环节，对 qKnow 开源版 v2.4.0 的主要更新进行说明。

----
# 一、新增 MCP 管理模块：集中查看和维护远程工具

qKnow 开源版 v2.4.0 在系统中增加了独立的 MCP 菜单。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11809485/3faef021b02a532f7d587dc5a2d07941.png)
主要包括：
- MCP 名称；
- MCP 描述；
- 工具数量；
- 当前启用状态；
- 相关管理操作。

围绕 MCP 的日常维护，当前版本支持：
- 新增 MCP；
- 修改 MCP 配置；
- 同步远程工具列表；
- 启用或管理 MCP；
- 将已启用的 MCP 工具用于 Agent 编排。

过去，远程工具地址和调用说明可能分散在多个外部文档中。
通过 MCP 管理页面，用户可以先确认平台已经接入了哪些远程服务，再查看每个服务包含的工具数量和基础说明。
这种方式可以形成相对清晰的工具管理入口：
```
远程 MCP 服务
      ↓
qKnow MCP 管理模块
      ↓
同步工具列表
      ↓
启用 MCP
      ↓
Agent 编排选择工具
```


----
## 四、为什么需要同步 MCP 工具列表？

远程 MCP 服务中的工具并不一定长期保持不变。
随着服务端持续更新，可能发生以下变化：
- 新增一个或多个工具；
- 修改工具名称；
- 调整工具描述；
- 修改调用参数；
- 调整参数类型；
- 删除已经停用的工具。

如果 qKnow 中保存的仍然是旧工具信息，那么 Agent 编排页面中展示的工具，就可能与远程服务实际提供的能力不一致。
通过“同步工具列表”功能，可以重新获取远程 MCP 服务中的工具信息，并更新平台内的工具展示内容。
其主要作用可以概括为：
```
获取远程工具信息
        ↓
更新平台中的工具名称、描述和列表
        ↓
供 Agent 编排时选择
```
需要注意的是，同步工具列表只能解决工具信息更新问题，并不能自动判断这些工具是否适合当前业务。
同步完成后，仍然需要人工确认：
- 工具的实际用途；
- 输入参数要求；
- 返回数据格式；
- 是否涉及敏感操作；
- 是否适合当前 Agent；
- 实际调用是否能够正常完成。

因此，“工具同步成功”和“工具可以稳定用于业务”是两个不同概念。


----
# 五、支持通过 HTTP 接入 MCP 服务

qKnow 开源版 v2.4.0 支持通过 HTTP 地址接入 MCP 服务。
用户可以在新增 MCP 时填写远程服务 URL，并将符合接入要求的 MCP 服务添加到平台中。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11809485/d9e5c39abe5e1a2ef116d39cf032cc95.png)
与在多个 Agent 中分别保存接口信息相比，这种方式可以把以下内容放到统一入口中维护：
- MCP 服务地址；
- 服务名称；
- 服务说明；
- 工具列表；
- 启用状态；
- Agent 使用关系。

整个接入过程可以概括为：
```
填写 MCP 地址
      ↓
保存服务配置
      ↓
同步工具列表
      ↓
检查工具信息
      ↓
启用 MCP
```
填写 URL 只是完成了基础服务配置。
MCP 服务能否正常使用，还需要结合网络连接、服务状态和实际调用结果进行验证。


----
## 六、接入 MCP 前需要检查哪些内容？

在新增 MCP 服务前，建议至少确认以下事项。
### 1. URL 地址是否正确

需要确认填写的 URL 是否完整，协议、端口和访问路径是否正确。
错误的服务地址会直接导致连接失败或工具列表同步失败。
### 2. qKnow 部署环境是否能够访问远程地址

浏览器能够访问某个服务，并不代表 qKnow 所在服务器也一定能够访问。
需要结合实际部署环境检查：
- 网络是否连通；
- 域名是否能够解析；
- 防火墙是否允许访问；
- 目标端口是否开放；
- 是否存在内网和公网访问限制；
- 是否需要代理配置。

### 3. MCP 服务是否正常运行

即使网络可以访问，如果远程 MCP 服务本身未启动、运行异常或响应超时，也无法完成正常接入。
### 4. 服务能否返回工具列表

MCP 服务需要按照相应方式提供工具信息。
如果远程服务无法返回工具列表，qKnow 就无法同步并展示具体工具。
### 5. 工具描述和参数是否完整

Agent 在选择和调用工具时，需要依赖工具名称、功能描述和参数信息进行判断。
如果工具描述过于模糊，或者参数定义不完整，可能影响模型选择工具和生成调用参数。
### 6. 工具是否符合实际业务需求

远程服务可以正常接入，并不代表其中的全部工具都适合当前 Agent。
仍然需要结合业务目标判断：
- Agent 是否确实需要该能力；
- 工具返回结果是否可信；
- 调用成本是否可接受；
- 是否存在数据安全风险；
- 是否允许执行写入或修改操作。


----
# 七、MCP 工具如何配置到 Agent 中？

完成 MCP 服务接入后，还需要将具体工具配置到对应的 Agent 中。
在 qKnow 开源版 v2.4.0 中，整体使用流程可以概括为：
```
新增 MCP
    ↓
同步工具列表
    ↓
确认并启用 MCP
    ↓
进入 Agent 编排
    ↓
导入或选择 MCP 工具
    ↓
进行问答和调用测试
```
首先，在 MCP 管理页面中完成远程服务配置，并同步当前服务中的工具列表。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11809485/8265b87a94f518d80a25ad08461cb290.png)
随后确认需要使用的 MCP 处于启用状态，再进入 Agent 编排页面选择对应工具。
这种方式带来的一个直接变化是：
>远程服务地址不再需要在每个 Agent 中重复维护。

同一个 MCP 服务可以根据实际需求配置给不同的 Agent。
同时，一个 MCP 中即使包含多个工具，也不需要将全部工具都加入同一个 Agent。
例如，一个 MCP 服务可能同时提供：
- 用户信息查询；
- 订单查询；
- 库存查询；
- 数据统计；
- 业务记录写入。

如果某个 Agent 只负责订单咨询，就可以只选择与订单查询相关的工具，而不必导入全部能力。
这有助于降低 Agent 工具选择的复杂度。


----
## 八、Agent 接入 MCP 后，处理流程发生了什么变化？

在没有配置外部工具时，一个 Agent 的基础处理过程通常是：
```
接收用户问题
      ↓
模型理解问题
      ↓
模型生成内容
      ↓
返回回答
```
这种方式主要依赖模型自身已有知识和上下文信息。
当 Agent 配置 MCP 工具后，部分任务可以形成新的处理流程：
```
接收用户问题
      ↓
判断是否需要外部工具
      ↓
选择对应 MCP 工具
      ↓
生成调用参数
      ↓
向远程服务发起请求
      ↓
获取工具返回结果
      ↓
组织最终回答
```
例如，用户询问某个订单的当前状态时，Agent 可以调用订单查询工具，获取远程业务系统返回的数据，再将结果整理成自然语言回答。
这使 Agent 从单纯的内容生成，扩展到可以结合外部数据完成任务。
但需要注意，工具接入后能否正常工作，仍然受到多个因素影响：
- 模型是否正确识别调用意图；
- Agent 是否选择了正确工具；
- 模型是否生成了正确参数；
- 远程服务是否能够正常响应；
- 工具返回内容是否完整；
- Agent 是否能够正确理解返回结果。

因此，配置 MCP 工具后仍然需要进行完整测试。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11809485/0f31e342ebfcac82d3bd9b823d4dd6ac.png)


----
# 九、MCP 模块解决的不只是“保存工具地址”

从页面功能来看，MCP 模块提供的是远程服务配置和工具列表管理入口。
但从 Agent 建设流程来看，它主要解决的是远程工具如何接入、复用、同步和持续维护的问题。
## 1. 为远程工具提供统一入口

MCP 名称、描述、工具数量和启用状态可以在统一列表中查看。
这可以减少工具信息分散在接口文档、配置文件和开发人员本地记录中的情况。
## 2. 减少多个 Agent 之间的重复配置

同一个已经接入并启用的 MCP，可以根据需要配置给多个 Agent。
开发人员不需要为每个 Agent 单独维护一套远程服务地址。
## 3. 将工具管理连接到 Agent 编排

远程工具完成接入、同步和启用后，可以继续进入 Agent 编排流程。
由此形成一条相对清晰的管理链路：
```
先接入远程服务
      ↓
再同步和检查工具
      ↓
确认服务状态
      ↓
为 Agent 选择工具
      ↓
完成实际调用测试
```
## 4. 为远程工具更新提供同步机制

当 MCP 服务端的工具发生变化时，可以通过同步工具列表更新平台中的相关信息。
这样可以降低平台工具信息长期落后于远程服务的风险。
## 5. 支持工具按需复用

同一个 MCP 服务可以包含多个工具，不同 Agent 可以根据业务职责选择不同工具。
这比把全部外部能力直接绑定到所有 Agent 更容易维护。


----
# 十、增加开源协议提示

除 MCP 模块外，qKnow 开源版 v2.4.0 还增加了开源协议提示弹窗。
用户首次进入系统时，页面会展示：
- 开源协议类型；
- 版权声明；
- 使用规范等信息。

这一调整主要是将开源项目相关说明放到更加明确的系统入口中。
用户在部署、使用或进行二次开发前，可以先查看对应的开源协议和使用要求。
本次版本还将系统标题正式调整为：
```
qKnow 开源智能体构建平台
```
对于计划二次开发或将系统用于实际项目的用户，建议在使用前完整阅读对应协议内容，并根据实际应用场景确认相关要求。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11809485/0e714d2699f5faa0234913925c06e826.png)


----
# 十一、系统界面与初始化内容调整

本次版本还对部分界面和初始化文件进行了调整。
## 1. Skills 菜单图标调整

AI 工具台中的 Skills 菜单图标进行了修改，使其与当前系统中的其他图标保持相对统一。
这一变化主要涉及界面展示，不改变 Skills 模块原有的功能和操作流程。
## 2. 初始化脚本和数据文件调整

v2.4.0 同步调整了：
- 系统初始化脚本；
- 初始数据；
- 相关配置文件；
- 部署所需的部分基础文件。

对于准备重新部署或从旧版本升级的用户，建议以 v2.4.0 正式发布包和对应部署说明为准。
操作前应备份已有配置和业务数据，避免直接覆盖导致原有内容丢失。


----
# 写在最后

>**qKnow 开源版 v2.4.0 的主要变化，是新增 MCP 远程工具管理模块，将远程服务接入、工具列表同步、启用状态管理和 Agent 编排连接到相对统一的使用流程中。**

用户可以通过独立的 MCP 菜单新增和修改服务配置，通过 HTTP 方式接入远程 MCP 服务，并同步服务端提供的工具列表。
当 MCP 处于启用状态后，相应工具可以在 Agent 编排中按需选择，用于连接外部查询服务、业务接口或其他远程能力。
从 Agent 建设角度来看，MCP 模块带来的变化可以概括为：
```
从每个 Agent 分别维护接口
              ↓
转变为平台统一接入远程服务
              ↓
同步和管理工具信息
              ↓
再按需配置给不同 Agent
```
这种方式可以减少重复配置，使远程工具的接入、维护和 Agent 使用之间形成更加清晰的管理路径。
但 MCP 模块主要解决的是工具管理和连接问题，并不会自动保证外部工具的稳定性、安全性和业务适用性。
在实际使用中，仍然需要重点验证：
- 网络是否可达；
- 远程服务是否稳定；
- 工具参数是否完整；
- Agent 是否能够正确选择工具；
- 调用权限是否合理；
- 异常情况是否有处理机制；
- 工具是否真正适合当前业务。

建议先完成数据备份，在测试环境中验证初始化脚本、MCP 接入和 Agent 调用流程，再结合实际业务需求逐步配置远程工具。

随着 Agent 应用逐步从知识问答扩展到业务查询、数据获取和外部系统调用，开发人员需要管理的内容也在发生变化。

qKnow 智能体构建平台开源版 v2.4.0 版本解析：新增 MCP 远程工具管理，打通 Agent 与外部服务

qKnow 开源版 v2.4.0 新增 MCP 远程工具管理模块，支持通过 HTTP 方式接入 MCP 服务，同步工具列表，并可在 Agent 编排页面中直接选择已启用的 MCP 工具。版本还增加了开源协议提示，调整系统名称、Skills 菜单图标及初始化脚本。MCP 模块将分散的接口地址统一管理，减少不同 Agent 间的重复配置，使远程工具从接入到 Agent 调用形成清晰链路。

人工智能

开发工具

后端

qKnow开源版v2.4.0新增MCP远程工具管理模块，支持HTTP接入MCP服务、同步工具列表并在Agent编排中按需选择。该版本解决远程工具分散维护问题，提供统一入口管理服务配置、工具信息和启用状态，减少重复配置，同时调整开源协议提示、Skills图标及初始化文件。

数据安全

数据备份

代码解释

服务器

防火墙

智能体

Agent

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

qKnow 智能体构建平台开源版 v2.4.0 版本解析：新增 MCP 远程工具管理，打通 Agent 与外部服务-腾讯云开发者社区-腾讯云

qKnow 智能体构建平台开源版 v2.4.0 版本解析：新增 MCP 远程工具管理，打通 Agent 与外部服务

qKnow 智能体构建平台开源版 v2.4.0 版本解析：新增 MCP 远程工具管理，打通 Agent 与外部服务

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐