修改MCP工具集配置。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：UpdateMCPToolset

要执行的操作，取值：UpdateMCPToolset。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

AuthorizerConfiguration.Authorizer.KeyAuth.ApiKeyLocation string 可选示例值：HEADER

使用API Key进行入站身份认证鉴权时，API Key传递的位置。取值：

HEADER：当前仅支持Header。

AuthorizerConfiguration.Authorizer.CustomJwtAuthorizer.DiscoveryUrl string 必选示例值：-

默认参数描述

AuthorizerConfiguration.Authorizer.KeyAuth.ApiKeys.N.Name string[] 必选示例值：ark-authkey

使用API Key进行入站身份认证鉴权时，API Key的名称。

参数 - N：表示APIKey名称的序号，取值范围：1～5。

多个字段名之间用&分隔。

长度为4 ～ 64的字符串。

由字母、数字、“-”和“_”组成。

AuthorizerConfiguration.Authorizer.CustomJwtAuthorizer.AllowedClients.N string[] 可选示例值：-

默认参数描述

AuthorizerConfiguration.Authorizer.KeyAuth.ApiKeys.N.Key string[] 可选示例值：8b02f2e2-ae83-11f0-b6e5-******

使用API Key进行入站身份认证鉴权时，API Key的值。

参数 - N：表示APIKey值的序号，取值范围：1～5。

多个字段名之间用&分隔。

不填则默认随机生成一个字符串。

AuthorizerConfiguration.Authorizer.KeyAuth.Parameter string 可选示例值：Authorization

使用API Key进行入站身份认证鉴权时，访问MCP工具集需要携带的Header的API Key对应的名称。

AuthorizerConfiguration.AuthorizerType string 必选示例值：ApiKey

MCP服务访问后端服务时的认证类型，取值：

ApiKey：当前仅支持API Key。

ClientToken string 可选示例值：65a075a2-aeff-11f0-****-00163e72f914

保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。

取值：仅支持ASCII字符，且不能超过64个字符。

MCPServiceIds.N string[] 可选示例值：m-ye7f4f7gu8q7oi5cu***

MCP服务。

参数 - N：表示MCP服务的序号，取值范围：1～100。

多个字段名之间用&分隔。

MCPToolsetId string 必选示例值：mt-ye7f6gd7nktv3gi6c***

MCP工具集ID。

MCPServices.N.IsAllTools boolean[] 必选示例值：true

是否包含MCP服务下所有工具。

MCPServices.N.MCPServiceId string[] 必选示例值：m-ye7f6gd7nktv3gi6c***

MCP服务的ID。

MCPServices.N.MCPTools.N.Name string[] 必选示例值：add-comments

MCP工具的名称。

MCPServices.N.MCPTools.N.Description string[] 可选示例值：add comments

MCP工具的描述。

MCPServices.N.MCPTools.N.Tags.N string[] 可选示例值：1

MCP工具的标签。

Mode string 可选示例值：AllTools

工具集调用工具的检索模式。

AllTools：全量返回工具。

SemanticSearch：语义检索，通过语义匹配工具。

TagSearch：标签检索。通过标签精准搜索工具。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

MCPToolsetId string 示例值：mt-ye7f6gd7nktv3gi6c****

MCP工具集ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidApiKeyLocation.Malformed	The specified ApiKeyLocation is malformed.	指定的ApiKeyLocation不合法。
400	InvalidAuthorizerType.Malformed	The specified AuthorizerType is malformed.	指定的AuthorizerType不合法。
400	InvalidParameter.MCPServices	The parameter MCPServices is invalid.	参数MCPServices不合法。
400	LimitExceeded.MaximumApiKeys	The number of specified ApiKeys exceeds the maximum limit.	指定的ApiKeys超过最大限制。
400	LimitExceeded.MinimumApiKeys	The number of specified ApiKeys exceeds the minimum limit.	指定的ApiKeys超过最小限制。
400	MissingParameter.ApiKeyLocation	The required parameter ApiKeyLocation is not supplied.	参数ApiKeyLocation不能为空。
400	MissingParameter.AuthorizerType	The required parameter AuthorizerType is not supplied.	参数AuthorizerType不能为空。
400	MissingParameter.DiscoveryUrl	The required parameter DiscoveryUrl is not supplied.	参数DiscoveryUrl不能为空。
400	MissingParameter.IsAllTools	The required parameter IsAllTools is not supplied.	参数IsAllTools不能为空。
400	MissingParameter.MCPServiceId	The required parameter MCPServiceId is not supplied.	参数MCPServiceId不能为空。
400	MissingParameter.MCPToolsetId	The required parameter MCPToolsetId is not supplied.	参数MCPToolsetId不能为空。
400	MissingParameter.Name	The required parameter Name is not supplied.	名称不能为空。
404	InvalidMCPService.NotFound	The specified MCPServiceId does not exist.	指定的MCPServiceId不存在。

AgentKit