AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考MCPListMCPToolsets - 批量查询MCP工具集详情
复制全文
下载 pdfListMCPToolsets - 批量查询MCP工具集详情
文档反馈
问问助手通过自定义筛选条件批量查询MCP工具集详情。
请求参数
Action string 必选 示例值：ListMCPToolsets
要执行的操作，取值：ListMCPToolsets。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
Filters.N.Name string[] 可选 示例值：name1
精确过滤的字段名。
- 参数 - N：表示过滤条件的序号，取值范围：1～10。
- 多个字段名之间用&分隔，为“或”的关系。
- 取值：
- name：MCP工具集的名称。
- status：MCP工具集的状态。
说明
当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。
Filters.N.NameContains string[] 可选 示例值：name1
精确过滤的字段名。
- 参数 - N：表示过滤条件的序号，取值范围：1～10。
- 多个字段名之间用&分隔，为“或”的关系。
- 取值：
- name：MCP工具集的名称。
- status：MCP工具集的状态。
说明
当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。
Filters.N.Values.N string[] 可选 示例值：mcp-****
过滤字段的值。
- 参数 - N：表示过滤条件的序号，取值范围：1～10。
- 多个字段名之间用&分隔。
当过滤字段为status时，取值：
- Ready：运行中。
- Creating：创建中。
- Updating：更新中。
- Deleting：删除中。
MaxResults integer 可选 示例值：100
分页查询时设置的每页行数。
- 最小值：1。
- 最大值：100。
- 默认值：10。
NextToken string 可选 示例值：bS15ZTcwMjZia***cTdvaTVjc3hvZw==
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。
ProjectName string 可选 示例值：default
MCP工具集所属项目名称。
TagFilters.N.Key string[] 可选 示例值：TagFilters.1.Key=k1
根据标签查询资源时指定的标签键，不允许重复。
- 参数 - N：表示标签键的序号，取值范围：1～10。
- 多个标签键之间用&分隔。
TagFilters.N.Values.N string[] 可选 示例值：TagFilters.1.Values.1=v1
根据标签查询资源时指定的标签值。
- 第一个N：表示标签键的序号，取值范围：1～10。
- 第二个N：表示标签值的序号，取值范围：1～3，即同一标签键最多支持同时查询3个标签值。
- 多个标签值之间用&分隔。
说明
- 如果传入该参数，则必须先传入TagFilters.N.Key。
- 不传则表示查询同一标签键下的所有标签值。
- 传入空字符串时，表示查询标签值为空的标签。
GatewayInstanceId string 可选 示例值：gw-********
MCP工具集关联专属网关的实例ID。您可在AgentKit控制台“网关 > 网关实例 > 专属网关”中获取专属网关实例ID。
- 若传入此参数，仅返回该专属网关下的MCP工具集。
- 若不传入此参数，则返回所有符合查询条件的MCP工具集。
返回参数
MCPToolsets object[] 示例值：--
MCP工具集详情。
AuthorizerConfiguration object 示例值：--
MCP工具集认证配置。
Authorizer object 示例值：--
认证器具体配置详情。
CustomJwtAuthorizer object 示例值：--
OAuth JWT认证配置。
AllowedClients string[] 示例值：["client1"]
允许访问的客户端列表。
DiscoveryUrl string 示例值：https://example.com/.well-known/openid-configuration
认证服务地址。
KeyAuth object 示例值：--
API Key认证配置。
ApiKeyLocation string 示例值：HEADER
API Key的传递位置。
ApiKeys object[] 示例值：--
API Key信息。
Key string 示例值：65a075a2-aeff-11f0-****-00163e72f914
API Key值。
Name string 示例值：key-ye7f6gd7nktv3gi6c***
API Key名称。
Parameter string 示例值：Authorization
携带的Header的API Key对应的名称。
AuthorizerType string 示例值：ApiKey
MCP 工具集身份认证安全的类型，取值：
- ApiKey：使用API Key认证。
- CustomJWT：使用OAuth JWT认证。
CreatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP工具集的创建时间。
MCPServices object[] 示例值：--
MCP工具集关联的MCP服务详情。
CreatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP服务创建时间。
IsAllTools boolean 示例值：true
是否添加了所有MCP工具。
MCPServiceId string 示例值：m-ye7f6gd7nktv3gi6c***
MCP服务ID。
Name string 示例值：name-ye7f6gd7nktv3gi6c***
MCP服务名称。
NetworkConfigurations object[] 示例值：--
MCP服务网络配置详情。
Endpoint string 示例值：***.apigateway-cn-beijing.volceapi.com
安全组ID列表。
NetworkType string 示例值：Public
子网ID列表。
VpcConfiguration object 示例值：--
VPC网络配置信息。
SecurityGroupIds string[] 示例值：["sg-w08tvkc3e****"]
安全组ID列表。
SubnetIds string[] 示例值：["subnet-ye7s6jatq8rxg218****"]
子网ID列表。
VpcId string 示例值：vpc-ye7s6jatq8rxg218****
VPC的ID。
EnableSharedInternetAccess boolean 示例值：false
是否启用共享公网访问。
- false：未启用
- true：已启用
Path string 示例值：/mcp
MCP服务访问路径。
ProjectName string 示例值：default
MCP工具集项目名称。
ProtocolConfiguration object 示例值：--
MCP服务协议配置详情。
ProtocolConvertConfiguration string 示例值：--
MCP服务后端类型为HTTP时，根据接口信息解析结果。
ProtocolType string 示例值：HTTP
MCP服务访问方式，取值：
- HTTP：HTTP 转 MCP。
- MCP：直接访问 MCP。
Status string 示例值：Ready
MCP服务状态，取值：
- Ready：运行中。
- Creating：创建中。
- Updating：更新中。
- Deleting：删除中。
- Error：不可用。
UpdatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP服务更新时间。
MCPToolsetId string 示例值：mt-ye7f6gd7nktv3gi6c***
MCP工具集的ID。
Mode string 示例值：AllTools
工具集调用工具的检索模式。
- AllTools：全量返回工具。
- SemanticSearch：语义检索，通过语义匹配工具。
- TagSearch：标签检索。通过标签精准搜索工具。
Name string 示例值：name-ye7f6gd7nktv3gi6c***
MCP工具集名称。
NetworkConfigurations object[] 示例值：--
MCP工具集网络配置详情。
Endpoint string 示例值：***.apigateway-cn-beijing.volceapi.com
MCP工具集访问的Endpoint。
NetworkType string 示例值：Public
MCP工具集开启的访问类型，取值：
- Public：公网访问。
- Private：私网访问。
VpcConfiguration object 示例值：--
VPC网络配置信息。
SecurityGroupIds string[] 示例值：["sg-w08tvkc3e****"]
安全组ID列表。
SubnetIds string[] 示例值：["subnet-ye7s6jatq8rxg218****"]
子网ID列表。
VpcId string 示例值：vpc-ye7s6jatq8rxg218****
VPC的ID。
EnableSharedInternetAccess boolean 示例值：false
是否启用共享公网访问。
Path string 示例值：/toolset
MCP工具集访问路径。
ProjectName string 示例值：default
MCP工具集项目名称。
Status string 示例值：Ready
MCP工具集状态，取值：
- Ready：运行中。
- Creating：创建中。
- Updating：更新中。
- Deleting：删除中。
Tags object[] 示例值：--
MCP工具集标签。
Key string 示例值：k1
标签键。
Type string 示例值：system
标签类型。
- system：系统标签。
- custom：用户标签。
Value string 示例值：v1
标签值。
UpdatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP工具集更新时间。
GatewayInstanceId string 示例值：gw-********
所属的专属网关实例ID，仅专属网关模式返回。
GatewayMode string 示例值：Shared
网关模式。
- Shared：共享网关。
- Exclusive：专属网关。
NextToken string 示例值：bS15ZTcwMjZiaWY0cTdvaTVjc3****==
本次调用返回的查询凭证值，返回为空表示该页为末页。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=ListMCPToolsets&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
"MaxResults": 10
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "ListMCPToolsets",
"Version": "2025-10-30",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"ListMCPToolsetsResNextToken": {
"MCPToolsets": [
{
"MCPToolsetId": " mt-yeu6s34mww3lr3r2****",
"Name": " my_mcp_toolset",
"Status": " Ready",
"NetworkConfigurations": [
{
"NetworkType": " Public",
"Endpoint": " ",
}
],
"AuthorizerConfiguration": {
"AuthorizerType": " ApiKey",
"Authorizer": {
"KeyAuth": {
"ApiKeys": [
{
"Key": " ",
"Name": " "
}
],
"ApiKeyLocation": " HEADER"
}
}
},
"MCPServices": [
{
"MCPServiceId": " mcp-xxx",
"Name": " mcp-service-x",
"Path": " /mcp",
"Status": " Ready",
"NetworkConfigurations": [
{}
],
"ProtocolType": " HTTP",
"ProtocolConfiguration": {
"ProtocolConvertConfiguration": " "
},
"CreatedAt": " 2006-01-02T15:04:05Z07:00",
"UpdatedAt": " 2006-01-02T15:04:05Z07:00"
}
],
"CreatedAt": " 2006-01-02T15:04:05Z07:00",
"UpdatedAt": " 2006-01-02T15:04:05Z07:00",
"Path": " /mcp"
}
],
"NextToken": " eyJwYWdlIj****"
}
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | LimitExceeded.MaximumMaxResults | The number of specified MaxResults exceeds the maximum limit. | 指定的MaxResults超过最大限制。 |
最近更新时间：2026.09.14 19:28:45
这个页面对您有帮助吗？
有用
有用
无用
无用