Agentkit MCP工具集通过语义搜索自动匹配与调用意图最相关的工具，提高工具调用准确性并降低Token消耗。 ## MCP自动匹配通过对用户或Agent工具调用的意图和MCP tool描述进行语义匹配，返回匹配程度最高的Server/Tool，提高tools匹配准确度同时降低大模型调用Token消耗。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1718de162aaa54f098f74f06b5e38470.png =662x) 当MCP Tool数量较大时，MCP工具集可以满足动态选择最优Tool，仅暴露Search和Use 2个工具，由LLM提供任务描述搜索到对应的工具，避免遇到MCP Tool数量上限瓶颈（例如，IDE工具目前只支持最大50 MCP Tool ）。 |开启前 |开启后 | |---|---| |大模型会看到所有的MCP tool|大模型会看到两个封装后的tool|\ |Tool 001||\ |……|* search_tool|\ |Tool 300 |* use_tool | ## 前提条件 * 已创建MCP服务。详情请参见[MCP服务](https://www.volcengine.com/docs/86681/1844857)。 * （可选）如需访问私有网络 VPC，请确保已开通火山引擎私有网络，已在MCP服务待部署地域创建私有网络、子网。详细操作请参见 [创建私有网络](https://www.volcengine.com/docs/6401/69467)、[创建子网](https://www.volcengine.com/docs/6401/67823)。 ## 创建MCP自动搜索服务 1. 登录[AgentKit控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中选择“网关 \> MCP中心”。 3. 在 “MCP工具集” 页签，单击“创建MCP工具集”，在创建页面参照下表完成参数配置。 |参数 |说明 | |---|---| |MCP工具集名称 |配置MCP工具集的名称。 | |访问路径 |配置MCP工具集的访问路径，默认为`/mcp`。 | |网络访问 |配置MCP工具集的网络访问方式，包括：|\ | ||\ | |* 公网访问：默认访问方式。|\ | |* 私网访问：选择地域下的任意一个VPC和子网，每个可用区支持最多选择一个子网。 | |入站身份认证 |配置MCP工具集的身份认证方式。入站身份认证是构建服务访问的第一道安全屏障，确保只有经过授权的主体才能调用 MCP 服务，避免非法访问、数据泄露和恶意攻击。包括如下配置方式：|\ | ||\ | |* API Key：输入名称后，将自动为MCP服务创建和绑定API Key，MCP服务创建成功后，可在MCP服务详情页查看。|\ | |* OAuth JWT：使用OAuth授权模式完成访问令牌申请和API调用，提升安全性，同时简化配置。配置前，请确认已[创建用户池](https://www.volcengine.com/docs/86681/1873447?lang=zh#Gzz7rgDs)和[客户端](https://www.volcengine.com/docs/86681/1873447?lang=zh#Gzz7rgDs)。 | |MCP服务 |将多个MCP服务的Tool组合，通过工具调用的意图和MCP Tool描述进行语义匹配，返回匹配程度最高的服务或Tool。|\ | |:::warning|\ | |当前仅支持添加APIKey入站类型的MCP服务。|\ | ||\ | |:::| |所属项目 |项目是一组资源的集合，您可以将本次创建的MCP服务工具集添加至项目中并按项目维度统一管理，有利于保持资源独立，维护数据安全。有关项目的更多信息请参见[项目管理](https://www.volcengine.com/docs/86681/2075078)。|\ | ||\ | |* 默认为default，一个资源只能归属于一个项目。|\ | |* 选定项目后，创建的MCP服务工具集只能被具有该项目权限的用户使用。创建MCP服务工具集后，您可以按需[更改实例所属项目](https://www.volcengine.com/docs/6649/94336)。|\ | |* 若无可用项目，您可单击“新建项目”按钮进行创建，创建完成后，返回本页面即可选择新添加的项目。 | |标签 |标签由一个键\-值对（Key\-Value）组成，用于标识云资源，可以从不同维度（例如用途、所有者或环境等）对云资源进行分类，便于搜索和聚合。|\ | |单击“+ 添加标签” 按钮，选择已有标签或输入新的标签，为MCP工具集绑定标签。更多信息，请参见[标签管理](https://www.volcengine.com/docs/86681/2075077)。|\ | |:::tip|\ | |单次操作最多可绑定20个标签，单个资源最多可绑定50个标签。|\ | ||\ | |:::| 4. 单击“创建”按钮，完成操作。 ## 获取调用示例和Access Token MCP工具集创建完成后，单击目标工具集操作列的“调用示例”，即可获得该MCP工具集的域名、调用示例和生成Access Token的代码示例。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_383e938a171d7690d18709831aa5114c.png) * 调用示例 * Gemini CLI调用示例：适用于Gemini CLI等CLI工具。 * Trae调用示例：适用于Trae、Cursor等IDE工具。 * Access token :::tip 仅入站身份认证为OAuth JWT的MCP工具集需要获取Access Token作为验证凭证。 ::: 单击“如何获取Access Token”查看生成Access Token的代码示例。 ## 调试MCP工具集 :::tip 仅当**网络访问**选择**公网访问**的MCP工具集，支持调试功能。 ::: 1. MCP工具集创建完成后，在列表中选择目标工具集，单击工具集名称，进入工具集详情页面。 2. 选择“调试”页签，根据导航提示验证MCP工具集中的工具。 * 域名：MCP工具集的公网访问域名。 * API Key或Access Token：MCP工具集的入站身份认证。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d9ed51cbd707059fa7da7e948ad7a5f8.png =557x) 若回显 **测试成功**，则表示MCP服务工具连接正常。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_19e29d3f574eab43b0e8c9a1d88f282e.png =554x) ## 其他操作 |操作 |步骤 | |---|---| |更新标签 |1. 在MCP工具集列表中选择目标工具集，单击工具集名称，进入工具集详情页面。|\ | |2. 单击“标签”旁的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b4ebe7d87f46b77eb8bff52c9709ebfd.png =20x) 。|\ | |3. 在“编辑标签”弹框中更新标签。|\ | |4. 单击“确定”，完成操作。 | |更新入站身份认证 |1. 在MCP工具集列表中选择目标工具集，单击工具集名称，进入工具集详情页面。|\ | |2. 单击“身份认证”旁的“编辑”。|\ | |3. 在“编辑身份认证”面板中更新访问用户。 | |更新MCP服务 |1. 在MCP工具集列表中选择目标工具集，单击工具集名称，进入工具集详情页面。|\ | |2. 单击“MCP服务”旁的“编辑”。|\ | |3. 在“编辑MCP服务”弹框中更新MCP服务。|\ | |4. 单击“确定”，完成操作。 | |删除MCP工具集 |在MCP工具集列表列表中，单击目标工具集操作列的“删除”，删除服务。|\ | |:::warning|\ | |删除MCP工具集后，无法恢复，请谨慎操作，避免因误删除导致Agent运行失败。|\ | ||\ | |:::|