修改MCP服务配置。

使用说明

不支持转换MCP服务入站身份认证安全的类型。

请求参数

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

Action string 必选示例值：UpdateMCPService

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

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

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

BackendConfiguration.CustomConfiguration.Domain string 可选示例值：www.***.com

MCP服务的后端服务的域名。

说明

当BackendType取值为Domain时必填。

BackendConfiguration.CustomConfiguration.Port integer 可选示例值：443

MCP服务对接的后端服务的端口。

说明

当BackendType取值为Domain时必填。

BackendConfiguration.CustomConfiguration.ProtocolType string 可选示例值：HTTP

MCP服务对接的后端服务的协议，取值：

HTTP：后端为HTTP服务。

HTTPS：后端为HTTPS服务。

说明

当BackendType取值为Domain时必填。

BackendConfiguration.FunctionConfiguration.FunctionId string 可选示例值：fc65a****

函数服务（veFaaS）ID。

说明

当BackendType取值为Function时必填。

BackendConfiguration.CustomMcpConfiguration.FunctionId string 可选示例值：--

创建的veFaaS Function ID（由系统自动填充，用户无需提供）。

BackendConfiguration.CustomConfiguration.TlsSettings.TlsMode string 必选示例值：SIMPLE

选择TLS（传输层安全协议）模式。当后端服务类型为固定域名时需要配置本参数，取值：

DISABLE：关闭TLS。当后端协议类型为http时，需传入DISABLE。

SIMPLE：开启单向TLS。当后端协议类型为https时，需传入SIMPLE。

BackendConfiguration.FunctionConfiguration.FunctionName string 可选示例值：func-name-****

函数服务（veFaaS）名称。

说明

当BackendType取值为Function时必填。

BackendConfiguration.CustomMcpConfiguration.FunctionName string 可选示例值：--

创建的veFaaS Function名称（由系统自动填充，用户无需提供）。

BackendConfiguration.CustomMcpConfiguration.EnableApmplus boolean 可选示例值：true

是否开启日志服务。取值：

true：开启。

false：未开启。

BackendType string 可选示例值：Function

MCP服务的后端服务的类型，取值：

Function：veFaaS函数。

Domain：固定域名。

ECS：云服务器。

VKE：容器服务。

CustomPublic：公共包（NPX/UVX）。

CustomPrivate：私有包（自定义镜像）。

BackendConfiguration.CustomMcpConfiguration.PrivatePackage.Command string 可选示例值：./run.sh

自定义MCP服务镜像的启动命令，由用户根据镜像自定义，默认 ./run.sh。

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

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

HEADER：当前仅支持HEADER。

说明

当Inbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.CustomMcpConfiguration.PrivatePackage.Envs.N.Key string[] 可选示例值：k1

自定义MCP服务镜像的环境变量键。

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

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

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

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

长度为4-64的字符串。

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

说明

当Inbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.CustomMcpConfiguration.PrivatePackage.Envs.N.Value string[] 可选示例值：v1

自定义MCP服务镜像的环境变量值。

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

使用APIKey进行入站身份认证鉴权时，APIKey的值。取值：

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

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

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

说明

当Inbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.CustomMcpConfiguration.PrivatePackage.ImageUrl string 可选示例值：http://***

自定义MCP服务镜像的URL。

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

使用APIKey进行入站身份认证鉴权时，请求头（Header）中携带的API Key对应的参数名称。

说明

当Inbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.CustomMcpConfiguration.PublicPackage.McpType string 可选示例值：Stdio

自定义MCP 服务类型，取值：

Stdio：标准输入输出。

Remote：远程服务。

InboundAuthorizerConfiguration.AuthorizerType string 必选示例值：ApiKey

MCP服务入站身份认证安全的类型，取值：

ApiKey：使用API Key认证。

CustomJWT：使用OAuth JWT认证。

BackendConfiguration.CustomMcpConfiguration.PublicPackage.PackageManagerType string 可选示例值：UVX

自定义MCP服务的公共包管理器类型，取值：

NPX。

UVX。

MCPServiceId string 必选示例值：m-ye7f6gd7nktv3gi6c***

MCP服务ID。

BackendConfiguration.CustomMcpConfiguration.PublicPackage.RawConfig string 可选示例值：--

自定义MCP服务完整配置（JSON 字符串）。

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

后端服务使用API Key作为出站凭据时，APIKey的传递的位置。取值：

HEADER：当前仅支持HEADER。

说明

当Outbound****.AuthorizerType取值为ApiKey时必填。

OutboundAuthorizerConfiguration.Authorizer.KeyAuth.ApiKeys.N.Name string[] 必选示例值：name-ye7f6gd7nktv3gi6c***

后端服务使用API Key作为出站凭据时，APIKey的名称，取值：

长度为4 ～ 64的字符串。

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

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

说明

当Outbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.EcsConfiguration.Instances.N.InstanceId string[] 可选示例值：i-yeattc3lkw****

云服务器（ECS）实例的ID。

说明

当BackendType取值为ECS时必填。

OutboundAuthorizerConfiguration.Authorizer.KeyAuth.ApiKeys.N.Key string[] 可选示例值：3nr5ibubffg1s931eb5k5***

后端服务使用API Key作为出站凭据时，APIKey的值。取值：

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

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

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

说明

当Outbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.EcsConfiguration.Instances.N.Ip string[] 可选示例值：172.xx.xx.109

云服务器（ECS）实例的私网IP地址。

说明

当BackendType取值为ECS时必填。

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

后端服务使用API Key作为出站凭据时，请求头（Header）中携带的API Key对应的参数名称。

说明

当Outbound****.AuthorizerType取值为ApiKey时必填。

BackendConfiguration.EcsConfiguration.Instances.N.Port integer[] 可选示例值：80

云服务器（ECS）实例的端口。

说明

当BackendType取值为ECS时必填。

OutboundAuthorizerConfiguration.AuthorizerType string 必选示例值：ApiKey

后端服务的出站凭据类型，取值：

ApiKey：使用API Key认证。

Identity：使用身份与权限（Identity）认证。

InboundAuthorizerConfiguration.Authorizer.CustomJwtAuthorizer.DiscoveryUrl string 必选示例值：https://example.com/.well-known/openid-configuration

认证服务地址。

InboundAuthorizerConfiguration.Authorizer.CustomJwtAuthorizer.AllowedClients.N string[] 可选示例值：client1

允许访问的客户端列表。

BackendConfiguration.VkeConfiguration.ClusterId string 可选示例值：cd59nk5v1a****

容器服务（VKE）集群的ID。

说明

当BackendType取值为VKE时必填。

BackendConfiguration.VkeConfiguration.Namespace string 可选示例值：namespace01

容器服务（VKE）集群命名空间的名称。

说明

当BackendType取值为VKE时必填。

BackendConfiguration.VkeConfiguration.Port integer 可选示例值：80

容器服务（VKE）集群的端口。

说明

当BackendType取值为VKE时必填。

BackendConfiguration.VkeConfiguration.ServiceName string 可选示例值：service01

容器服务（VKE）集群服务的名称。

说明

当BackendType取值为VKE时必填。

OutboundAuthorizerConfiguration.Authorizer.IdentityAuthorizer.CredentialProviderName string 可选示例值：Oauth2M2m01

后端服务使用身份与权限（Identity）作为出站凭据时，凭证管理的名称。

说明

当Outbound****.AuthorizerType取值为Identity时必填。

OutboundAuthorizerConfiguration.Authorizer.IdentityAuthorizer.ProviderType string 可选示例值：Oauth2M2m01

后端服务使用身份与权限（Identity）作为出站凭据时，凭证管理的类型。取值：

ApiKey：使用API Key凭据。

Oauth2M2m：使用OAuth Client凭据。

说明

当Outbound****.AuthorizerType取值为Identity时必填。

返回参数

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

MCPServiceId string 示例值：m-ye7f6gd7nktv3gi6c***

MCP服务ID。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidAuthorizerType.Malformed	The specified AuthorizerType is malformed.	指定的AuthorizerType不合法。
400	InvalidApiKeyLocation.Malformed	The specified ApiKeyLocation is malformed.	指定的ApiKeyLocation不合法。
400	InvalidBackendType.Malformed	The specified BackendType is malformed.	指定的BackendType不合法。
400	InvalidMcpType.Malformed	The specified McpType is malformed.	指定的McpType不合法。
400	InvalidNetworkType.Malformed	The specified NetworkType is malformed.	指定的NetworkType不合法。
400	InvalidPackageManagerType.Malformed	The specified PackageManagerType is malformed.	指定的PackageManagerType不合法。
400	MissingParameter.ApiKeyLocation	The required parameter ApiKeyLocation is not supplied.	参数ApiKeyLocation不能为空。
400	InvalidProtocolType.Malformed	The specified ProtocolType is malformed.	指定的ProtocolType不合法。
400	InvalidTlsMode.Malformed	The specified TlsMode is malformed.	指定的TlsMode不合法。
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	LimitExceeded.MaximumPort	The number of specified Port exceeds the maximum limit.	指定的Port超过最大限制。
400	MissingParameter.AuthorizerType	The required parameter AuthorizerType is not supplied.	参数AuthorizerType不能为空。
400	MissingParameter.ApiKeys	The required parameter ApiKeys is not supplied.	参数ApiKeys不能为空。
400	MissingParameter.DiscoveryUrl	The required parameter DiscoveryUrl is not supplied.	参数DiscoveryUrl不能为空。
400	MissingParameter.NetworkType	The required parameter NetworkType is not supplied.	参数NetworkType不能为空。
400	LimitExceeded.MinimumPort	The number of specified Port exceeds the minimum limit.	指定的Port超过最小限制。
400	MissingParameter.MCPServiceId	The required parameter MCPServiceId is not supplied.	参数MCPServiceId不能为空。
400	MissingParameter.Name	The required parameter Name is not supplied.	名称不能为空。
400	MissingParameter.TlsMode	The required parameter TlsMode is not supplied.	参数TlsMode不能为空。
400	MissingParameter.Parameter	The required parameter Parameter is not supplied.	参数Parameter不能为空。
400	MissingParameter.Domain	The required parameter Domain is not supplied.	参数Domain不能为空。
400	MissingParameter.BackendType	The required parameter BackendType is not supplied.	参数BackendType不能为空。

AgentKit