UpdateApiMcpServer-OpenAPI Explorer(OpenAPI)-阿里云帮助中心

Modifies an API MCP service.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

openapiexplorer:UpdateApiMcpServer

update

*ApiMcpServer

acs:openapiexplorer::{#accountId}:apimcpserver/{#id}

None

Request syntax

PATCH /apimcpserver HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
clientToken	string	No	The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. We recommend that you use a UUID. The token expires after 3 days.	123e4567-e89b-12d3-a456-426655440000
id	string	Yes	The ID of the API MCP service.	v6ZZ7ftCzEILW***
body	object	No	The request body.
description	string	No	The description of the API MCP server.	This is an API MCP server.
apis	array<object>	No	The list of APIs to modify.
	object	No	The API information.
product	string	No	The product code.	Ecs
apiVersion	string	No	The POP version of the API exposed to the MCP server.	2014-05-26
selectors	array	No	The list of API name matching rules.
	string	No	The API name matching rule.	*Bucket
additionalApiDescriptions	array<object>	No	The list of supplementary API descriptions.
	array<object>	No	The supplementary description of an API.
product	string	No	The product code.	Ecs
apiVersion	string	No	The POP version of the API exposed to the MCP server.	2014-05-26
apiName	string	No	The API name.	DescribeRegions
apiOverrideJson	string	No	The API metadata in JSON format. Refer to the format at https://api.aliyun.com/meta/v1/products/Ecs/versions/2014-05-26/apis/DescribeInstances/api.json. You can override the summary and parameters fields.	{
executeCliCommand	boolean	No	Specifies whether to return the CLI execute command. In this mode, the API is not actually called. Instead, the corresponding CLI command is returned. This is suitable for long-running tasks that require execution with Cloud Assistant CLI.	true
enableOutputSchema	boolean	No	Specifies whether to return the output parameter schema. Returning the output parameter schema increases the overall size of the API MCP server. Default value: null, which indicates that the output parameter schema is not returned.	true
toolAlias	string	No	The tool alias. You can set a custom name, such as list_ecs_regions. The alias can contain letters, digits, hyphens (-), and underscores (_). Duplicate aliases are not allowed.	list_ecs_regions
constParameters	array<object>	No	The list of constant parameters. These parameters are not included in the API parameter output during parsing.
	object	No	The constant parameter.
key	string	No	The parameter name. Only first-level parameter names are supported. For ROA-style APIs, you can set the parameter to body.xx. You cannot set values beyond top-level parameters.	InstanceId
value	any	No	The parameter value.	1234
prompts	array<object>	No	The list of prompt configurations.
	array<object>	No	The prompt configuration.
name	string	No	The prompt name.	test
description	string	No	The description.	prompt description
content	string	No	The content of the prompt. Variables are specified in the {{xxx}} format, where xxx is a variable that must be defined in the arguments parameter.	Prompt body, {{name}}
arguments	array<object>	No	The list of parameters supported by the prompt.
	object	No	The parameter supported by the prompt.
name	string	No	The parameter name.	test
description	string	No	The parameter description.	argument description
required	boolean	No	Specifies whether the parameter is required.	true
language	string	No	The documentation language of the API MCP service. You can select Chinese or English API documentation. Different languages may produce different AI response results. Valid values: EN_US : English. ZH_CN : Chinese.	ZH_CN
systemTools	array	No	The list of system tools.
	string	No	The system tool name.	FetchRamActionDetails
oauthClientId	string	No	The custom OAuth Client ID used when a custom OAuth configuration is selected.	403*************370
instructions	string	No	The MCP instructions that guide the large language model on how to use this MCP. The client must support the Instructions field in the MCP standard protocol.	test
enableAssumeRole	boolean	No	Specifies whether to enable multi-account access.	true
assumeRoleName	string	No	The name of the RAM role to assume in the target account when performing cross-account operations with multi-account access enabled.	test
assumeRoleExtraPolicy	string	No	The additional policy for role assumption when multi-account access is enabled. If this policy is specified, the permissions for role assumption are based on this value, overriding the permissions defined in the role itself.	{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "ecs:Describe", "vpc:Describe", "vpc:List" ], "Resource": "" } ] }
publicAccess	string	No	Specifies whether to enable public network access. Valid values: follow: follows the account-level public network access configuration. off: disables public network access. on: enables public network access. Valid values: follow : follows the account-level public network access configuration. off : disables public network access. on : enables public network access.	on
enableCustomVpcWhitelist	boolean	No	Specifies whether to enable a custom VPC whitelist. If not enabled, the account-level configuration is used.	true
terraformTools	array<object>	No	The list of Terraform tools.
	object	No	Terraform Tool。
code	string	No	The Terraform tool code. HCL language overview	variable "name" { default = "terraform-example" } provider "alicloud" { region = "cn-beijing" } resource "alicloud_vpc" "default" { ipv6_isp = "BGP" description = "test" cidr_block = "10.0.0.0/8" vpc_name = var.name enable_ipv6 = true }
name	string	No	The Terraform tool name.	test
description	string	No	The Terraform tool description.	Terraform Tool description
async	boolean	No	Specifies whether the execution is asynchronous. When enabled, the system proceeds to the next task immediately after initiating a task, without waiting for each resource operation to complete.	true
destroyPolicy	string	No	The deletion policy. After a task is completed, the system applies the following cleanup policies to temporary resources based on the task execution status. Valid values: ON_FAILURE: Deletes temporary resources only when the task fails. NEVER: Does not delete temporary resources. ALWAYS: Always deletes temporary resources. Valid values: ON_FAILURE : Deletes temporary resources only when the task fails. NEVER : Does not delete temporary resources. ALWAYS : Always deletes temporary resources.	ON_FAILURE
vpcWhitelists	array	No	The VPC whitelist that restricts the source when public network access is disabled. If not set or empty, no source restriction is applied.
	string	No	The VPC whitelist entry. The value is the source VPC ID.	vpc-j6cgd2if5lg**0xs6m5se

Response elements

Element	Type	Description	Example
	object	The request result.
requestId	string	The request ID.	9BFC4AC1-6BE4-5405-BDEC-CA288D404812

Examples

Success response

JSON format

{
  "requestId": "\t\n9BFC4AC1-6BE4-5405-BDEC-CA288D404812\n"
}

Error codes

HTTP status code	Error code	Error message	Description
400	Missing.Id	Id is mandatory for this action.
400	Missing.Apis.PopCode	Apis.PopCode is mandatory for this action.	The required parameter popCode is missing in the Apis parameter.
400	Missing.Apis.PopVersion	Apis.PopVersion is mandatory for this action.	Apis.PopVersion is mandatory for this action.
400	InvalidParam.Apis.PopVersion	Unsupported product version: %s of product code: %s.	Product% s does not support xxx version.
400	InvalidParam.Apis.PopCode	Unsupported product code: %s.	The specified product name does not exist
400	Missing.Apis.Selectors	Apis.Selectors is mandatory for this action.	Apis.Selectors is a required parameter
400	InvalidParam.Language	Unsupported language: %s.	Specify multilingual wu'xi
400	InvalidParam.AdditionalApiDescription.PopVersion	Unsupported product version: %s of product code: %s.	Product% s does not support version% s.
400	InvalidParam.AdditionalApiDescription.PopCode	Unsupported product code: %s.	The specified product does not exist
400	InvalidParam.SystemTools	System tool %s is not supported.
400	Missing.TerraformTools.Description	TerraformTools.Description is mandatory for this action.	Missing required parameter TerraformTools.Description
400	Missing.TerraformTools.Code	TerraformTools.Code is mandatory for this action.	The required parameter TerraformTools.Code is missing.
400	IdempotentParameterMismatch	The request uses the same client token as a previous request but with different parameters. Client tokens should not be reused across non-identical requests. Each unique request must have a distinct client token.	The request used the same client token as the previous request, but with different parameters. Do not reuse the same token in requests with different parameters. Each request must use a unique token.
400	InvalidParam.TerraformTools.Name	TerraformTools.Name: %s must be 3 to 64 characters long and can only contain lowercase letters, numbers, underscores, and hyphens.	The Terraform tool name must be 3 to 63 characters in length and can contain only lowercase letters, numbers, underscores, and hyphens.
400	Missing.TerraformTools.Name	TerraformTools.Name is mandatory for this action.
400	InvalidParam.TerraformTools.Code	The Terraform tool code is not valid: %s. Please check the syntax and try again.	The specified TerraformTools.Code parameter is invalid.
400	InvalidParam.ClientToken	The specified client token is not valid.	The idempotent parameter is incorrect, please check.
400	InvalidParam.AdditionalApiDescription.ToolAlias	ToolAlias '%s' is invalid. It must be 1-64 characters, start with a letter, and contain only letters, digits, underscores, and hyphens.
403	OperationNotAllowed.SystemServer	System type servers are not allowed to be updated or deleted.	System-level services do not allow update or delete operations.
404	NotFound.ApiMcpServer	Specified MCP server not found.	The MCP service with the specified ID does not exist.
409	Exists.TerraformTools.Name	The Terraform tool name already exists.	The specified Terraform tool name already exists.
409	Exists.ToolAlias	Duplicate tool alias '%s' found. Each tool alias must be unique within an MCP server.
409	Conflict.ToolAlias	Tool alias '%s' conflicts with an existing tool name in this MCP server.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.