文档中心

AgentKit

MCP 工具集

创建 MCP 工具集

MCP 工具集是 MCP 服务下的工具管理单元，用于将一组相关 MCP 工具进行统一管理，并向 AI 应用或 Agent 开放调用。工具集支持全量返回、语义检索、标签检索三种工具匹配模式，可根据工具数量与业务场景灵活选用，在提升调用准确性的同时降低 Token 消耗。本文为您介绍如何创建 MCP工具集。

背景信息

MCP 工具集中的工具支持多种调用模式以满足不同的使用场景。

调用模式	说明	适用场景
全量返回	全量返回 MCP 工具集内所有的工具。	MCP 工具集内工具数量较少时（例如 20 个以内）。
语义检索	可传入任务请求让 MCP 工具集基于调用意图与 MCP 工具的描述进行语义匹配，返回匹配程度最高的工具。使用语义检索模式，会单独收取工具索引费用，您可先了解计费粒度和参考价格，详见计费说明。	MCP 工具集内工具数量较多，且调用方为通用类智能体。
标签检索	可传入指定标签准确筛选 MCP 工具，使用前需要在 MCP 工具集内为工具添加标签。	MCP 工具集内工具数量较多，且调用方为垂直领域智能体。

MCP 协议版本

MCP 协议版本用于定义消息格式、能力声明、初始化方式和调用行为，全量返回、语义检索和标签检索是 MCP 工具集提供的工具匹配方式，不代表不同的 MCP 协议版本，客户端应按照所使用协议版本对应的消息格式调用 tools/list 和 tools/call。MCP 工具集兼容以下 MCP 协议版本：

2026-07-28

2025-11-25

2025-06-18

2025-03-26

关于 MCP 2026-07-28协议的兼容性、无状态机制与 MRTR（多轮往返请求）使用方式，详见 MCP 协议版本兼容性说明。

前提条件

已创建 MCP 服务。详情请参见 MCP 服务。

已了解 MCP 工具集相关计费项及其说明。MCP 工具集为收费功能，建议您在创建前先了解相关费用，详见计费说明。

（可选）如需访问私有网络 VPC，请确保已开通火山引擎私有网络，已在 MCP 服务待部署地域创建私有网络、子网。详细操作请参见创建私有网络、创建子网。

操作步骤

在左侧导航树中选择“网关 > MCP 接入”，单击“MCP 工具集”页签。

单击“创建 MCP 工具集”按钮，在创建页面参照下表完成参数配置，配置完成后单击“创建”按钮，完成操作。

参数	说明
基本信息
MCP 工具集名称	配置 MCP 工具集的名称，创建成功后不可修改。
所属网关	选择 MCP 工具集所属的网关类型。专属网关（推荐）：MCP 工具集运行在您独立创建的网关实例上，资源专属不共享，可提供稳定的容量保障，适用于对可靠性要求较高的生产环境。选择后，需指定关联的网关实例，如果没有可用网关实例，单击下拉框中“去创建”按钮创建，详细操作请参见创建网关实例。共享模式：MCP 工具集运行在平台统一提供的共享网关资源上，无需创建网关实例。共享模式下存在 QPS 等限流限制，适用于功能验证（POC）或低流量测试场景，不建议用于生产环境。注意 MCP 工具集创建后，所属网关不可更换，请根据实际业务场景谨慎选择。
访问路径	配置 MCP 工具集的访问路径，默认为/mcp。
网络配置
网络访问	当所属网关选择共享模式时需配置此参数，专属网关模式下MCP 工具集使用所关联网关实例的网络访问配置。配置 MCP 工具集的网络访问方式，即新创建 MCP 工具集能被哪种网络访问。公网访问：希望被 Trae / Codex 等外部服务访问，选择此方式。公网访问为默认访问方式。私网访问：希望被 AgentKit 上的 Agent 访问，不对外提供服务，仅在内部使用，选择此方式。地域下的任意一个 VPC 和子网，每个可用区支持最多选择一个子网。
认证信息
入站身份认证	配置 MCP 工具集的身份认证方式。入站身份认证是构建服务访问的第一道安全屏障，确保只有经过授权的主体才能调用 MCP 工具集，避免非法访问、数据泄露和恶意攻击。 API Key：输入名称后，将自动为 MCP 工具集创建和绑定 API Key，MCP 工具集创建成功后，可在 MCP 工具集详情页查看。 OAuth JWT：使用 OAuth 授权模式完成访问令牌申请和API调用，提升安全性，同时简化配置。配置前，请确认已创建用户池和客户端。注意 API Key 与OAuth JWT 为互斥的认证方式，同一 MCP 工具集仅可启用其中一种。 API Key 模式最多可配置 1 个，OAuth JWT 模式最多可绑定 5 个客户端。
工具管理
调用模式	Agent 调用工具集时支持全量返回工具，也支持通过语义匹配或标签筛选目标工具。全量返回：连接 MCP 工具集后将直接返回内部所有 MCP 工具。当工具数量较少时，例如 20 个以内，建议选择该模式。语义检索：基于调用意图与工具描述进行语义匹配，返回匹配程度最高的工具。当工具数量较多，且调用方为通用类 Agent 时，建议选择该模式。使用语义检索模式，会单独收取工具索引费用，详细介绍请参见计费说明。标签检索：基于工具标签准确筛选所需工具，当工具数量较多，且调用方为垂直领域 Agent 时，建议选择该模式。注意使用“标签检索”模式前，请务必在工具集内为工具添加工具标签，建议所有工具的工具标签不超过 10 个。
工具	在 MCP 工具集中添加工具。单击“添加工具”按钮，在 MCP 服务中选择目标工具。支持从多个 MCP 服务中选择并组合工具，以满足您的实际业务需求。当所属网关为共享模式时，仅支持选择同时满足以下条件的 MCP 服务：MCP 服务的网关模式为共享模式、入站认证方式为 API Key，且网络类型为公网。当所属网关为专属网关时，仅支持选择当前网关实例下的 MCP 服务，且该服务的入站认证方式为 API Key。网络类型不限，公网和私网均可。
高级配置
所属项目	当所属网关选择共享模式时需配置此参数，当所属网关选择专属网关时，MCP 工具集所属项目与关联的网关实例一致。项目是一组资源的集合，您可以将本次创建的 MCP 工具集添加至项目中并按项目维度统一管理，有利于保持资源独立，维护数据安全。有关项目的更多信息请参见项目管理。默认为 default，一个资源只能归属于一个项目。选定项目后，创建的 MCP 工具集只能被具有该项目权限的用户使用。创建 MCP 工具集后，您可以按需更改实例所属项目。若无可用项目，您可单击“新建项目”按钮进行创建，创建完成后，返回本页面即可选择新添加的项目。
标签	标签由一个键-值对（Key-Value）组成，用于标识云资源，可以从不同维度（例如用途、所有者或环境等）对云资源进行分类，便于搜索和聚合。单击“+ 添加标签” 按钮，选择已有标签或输入新的标签，为 MCP 工具集绑定标签。更多信息，请参见标签管理。说明单次操作最多可绑定 20 个标签，单个资源最多可绑定 50 个标签。

创建成功后，在 MCP 工具集列表中可看到新创建的 MCP 工具集。

注意

MCP 工具集创建成功后，对 MCP 工具集发起请求，MCP 工具集会访问关联的 MCP 服务进行工具调用，产生的请求次数将同时计入 MCP 工具集与 MCP 服务的用量统计。详细说明请参见 MCP 请求次数说明。

最近更新时间：2026.09.21 16:56:25

这个页面对您有帮助吗？

有用

无用