AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考MCPGetMCPToolset - 查询MCP工具集详情
复制全文
下载 pdfGetMCPToolset - 查询MCP工具集详情
文档反馈
问问助手查询MCP工具集详情。
请求参数
Action string 必选 示例值：GetMCPToolset
要执行的操作，取值：GetMCPToolset。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
MCPToolsetId string 必选 示例值：mt-ye7kx4****
MCP工具集ID。
返回参数
MCPToolset object 示例值：--
MCP工具集信息。
AssociatedRuntimes object[] 示例值：--
关联的运行时信息。
Id string 示例值：r-ye7f6gd7nktv3gi6c***
运行时ID。
Name string 示例值：RuntimeName
运行时名称。
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 示例值：k-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
访问的Endpoint。
NetworkType string 示例值：Public
开启的访问类型，取值：
- Public：公网访问。
- Private：私网访问。
VpcConfiguration object 示例值：--
VPC网络配置信息。
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：不可用。
Tags object[] 示例值：--
MCP服务标签。
Key string 示例值：k1
标签键。
Type string 示例值：env
标签类型。
Value string 示例值：v1
标签值。
UpdatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP服务更新时间。
MCPToolsetId string 示例值：mt-ye7f6gd7nktv3gi6c***
MCP工具集ID。
Mode string 示例值：SemanticSearch
MCP工具集的调用模式。
- SemanticSearch：语义检索。
- AllTools：全量返回。
- TagSearch：标签检索。
Name string 示例值：name-ye7f6gd7nktv3gi6c***
MCP工具集名称。
NetworkConfigurations object[] 示例值：--
MCP工具集网络配置详情。
Endpoint string 示例值：***.apigateway-cn-beijing.volceapi.com
访问的Endpoint。
NetworkType string 示例值：Public
开启的访问类型，取值：
- Public：公网访问。
- Private：私网访问。
VpcConfiguration object 示例值：--
VPC网络配置信息。
SubnetIds string[] 示例值：["subnet-ye7s6jatq8rxg218****"]
子网ID列表。
VpcId string 示例值：vpc-ye7s6jatq8rxg218****
VPC的ID。
EnableSharedInternetAccess boolean 示例值：false
是否启用共享公网访问。
- false：未启用。
- true：已启用。
Path string 示例值：/toolset
MCP工具集访问路径。
ProjectName string 示例值：default
MCP工具集项目名称。
Status string 示例值：Ready
MCP工具集状态，，取值：
- Ready：运行中。
- Creating：创建中。
- Updating：更新中。
- Deleting：删除中。
Tags object[] 示例值：--
MCP工具集标签。
Key string 示例值：k1
标签键。
Type string 示例值：env
标签类型。
Value string 示例值：v1
标签值。
UpdatedAt string 示例值：2006-01-02T15:04:05Z07:00
MCP工具集更新时间。
GatewayInstanceName string 示例值：exclusive-gateway
MCP工具集关联的专属网关实例名称，仅GatewayMode为Exclusive时返回此参数。
GatewayInstanceId string 示例值：gw-********
MCP工具集关联的专属网关实例ID，仅GatewayMode为Exclusive时返回此参数。
GatewayMode string 示例值：Shared
网关模式。
- Shared：共享网关。
- Exclusive：专属网关。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=GetMCPToolset&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
"MCPToolsetId": "mt-ye6xr60ikgq7oi5c***"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "GetMCPToolset",
"Version": "2025-10-30",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"MCPToolset": {
"MCPToolsetId": " mt-xxx",
"Name": " my_mcp_toolset",
"Status": " Ready",
"Path": " /mcp",
"NetworkConfigurations": [
{
"NetworkType": " Public",
"Endpoint": " "
}
],
"AuthorizerConfiguration": {
"AuthorizerType": " ApiKey",
"Authorizer": {
"KeyAuth": {
"ApiKeys": [
{
"Key": " ",
"Name": " "
}
],
"ApiKeyLocation": " HEADER"
}
}
},
"CreatedAt": " 2006-01-02T15:04:05Z07:00",
"UpdatedAt": " 2006-01-02T15:04:05Z07:00",
"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"
}
]
}
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.MCPToolsetId | The required parameter MCPToolsetId is not supplied. | 参数MCPToolsetId不能为空。 |
404 | InvalidResource.NotFound | The specified resource does not exist. | 指定资源不存在。 |
最近更新时间：2026.09.18 14:21:15
这个页面对您有帮助吗？
有用
有用
无用
无用