修改API MCP服务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
PATCH /apimcpserver HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| clientToken |
string |
否 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符，建议使用 UUID。过期时间为 3 天。 |
123e4567-e89b-12d3-a456-426655440000 |
| id |
string |
是 |
API MCP 服务的 ID。 |
v6ZZ7ftCzEILW*** |
| body |
object |
否 |
请求 body。 |
|
| description |
string |
否 |
API MCP 服务器描述信息。 |
这是一个API MCP服务器。 |
| apis |
array<object> |
否 |
修改的 API 列表。 |
|
|
object |
否 |
API 信息。 |
||
| product |
string |
否 |
产品 CODE。
|
Ecs |
| apiVersion |
string |
否 |
透出到 MCP SERVER 的 API 所属的 POP version。 |
2014-05-26 |
| selectors |
array |
否 |
API 名称匹配规则列表。 |
|
|
string |
否 |
API 名称匹配规则。 |
*Bucket |
|
| additionalApiDescriptions |
array<object> |
否 |
补充的 API 描述信息列表。 |
|
|
array<object> |
否 |
补充 API 的描述信息。 |
||
| product |
string |
否 |
产品 CODE。
|
Ecs |
| apiVersion |
string |
否 |
透出到 MCP SERVER 的 API 所属的 POP version。 |
2014-05-26 |
| apiName |
string |
否 |
API 名称。 |
DescribeRegions |
| apiOverrideJson |
string |
否 |
API 元数据 JSON 格式，参考格式 https://api.aliyun.com/meta/v1/products/Ecs/versions/2014-05-26/apis/DescribeInstances/api.json，支持覆盖其中的 summary、parameters。 |
{ "summary": "本接口支持根据不同请求条件查询实例列表，并关联查询实例的详细信息。" } |
| executeCliCommand |
boolean |
否 |
是否返回 CLI 的执行命令，这个模式下，不真实执行 API 调用，返回对应的 CLI 命令，适用于长耗时的任务，需要搭配使用阿里云 CLI 执行。 |
true |
| enableOutputSchema |
boolean |
否 |
是否返回出参的 schema，返回出参 schema 时会增加整个 API MCP SERVER 的体积。默认值为 null，表示不返回出参的 schema。 |
true |
| constParameters |
array<object> |
否 |
常量入参列表，在 API 参数解析时，不再输出这部分参数。 |
|
|
object |
否 |
常量入参。 |
||
| key |
string |
否 |
参数名称。仅支持一级参数名称，对于 ROA 风格的 API，支持设置到 body.xx，不允许设置超出顶级参数的值。 |
InstanceId |
| value |
any |
否 |
参数的值。 |
1234 |
| prompts |
array<object> |
否 |
prompt 配置列表。 |
|
|
array<object> |
否 |
prompt 配置。 |
||
| name |
string |
否 |
prompt 名称。 |
test |
| description |
string |
否 |
描述信息。 |
prompt description |
| content |
string |
否 |
prompt 的内容信息，其变量通过 {{xxx}} 格式指定。xxx 为变量，需要从 arguments 参数中定义。 |
prompt正文，{{name}} |
| arguments |
array<object> |
否 |
prompt 支持的参数列表。 |
|
|
object |
否 |
prompt 支持的参数。 |
||
| name |
string |
否 |
参数名称。 |
test |
| description |
string |
否 |
参数的描述信息。 |
argument description |
| required |
boolean |
否 |
该参数是否必填。 |
true |
| language |
string |
否 |
API MCP 服务的文档语言。支持选择中文或英文 API 文档，不同的语言提示词对 AI 的回复效果可能产生差异。 |
ZH_CN |
| systemTools |
array |
否 |
系统工具列表。 |
|
|
string |
否 |
系统工具名称 |
FetchRamActionDetails |
|
| oauthClientId |
string |
否 |
选择自定义 OAuth 配置时的自定义 OAuth Client ID。
|
403*************370 |
| instructions |
string |
否 |
MCP 指令，用于提示大模型如何使用该 MCP，需要客户端支持 MCP 标准协议的 Instructions 字段。 |
test |
| enableAssumeRole |
boolean |
否 |
是否开启多账号访问。 |
true |
| assumeRoleName |
string |
否 |
开启多账号访问进行跨账号操作时，扮演的目标账号 RAM 角色名称。 |
test |
| assumeRoleExtraPolicy |
string |
否 |
开启多账号访问时，角色扮演额外的策略，该策略存在时，角色扮演的权限以当前值为准，覆盖角色本身的权限定义。 |
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "ecs:Describe*", "vpc:Describe*", "vpc:List*" ], "Resource": "*" } ] } |
| terraformTools |
array<object> |
否 |
Terraform Tool 列表。 |
|
|
object |
否 |
Terraform Tool。 |
||
| code |
string |
否 |
Terraform Tool 代码。HCL 语言概述 |
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 |
否 |
Terraform Tool 名称。 |
test |
| description |
string |
否 |
Terraform Tool 描述信息。 |
Terraform Tool description |
| async |
boolean |
否 |
是否为异步执行，即发起一个任务执行之后会立即处理下一个任务，而不等待每个资源操作完成。 |
true |
| destroyPolicy |
string |
否 |
删除策略，任务执行完成后，系统根据任务执行状态对临时资源采取以下清理策略。
|
ON_FAILURE |
| publicAccess |
string |
否 |
是否开启公网。 |
on |
| enableCustomVpcWhitelist |
boolean |
否 |
是否开启自定义 VPC 白名单，不开启则跟随账户级别的配置。 |
true |
| vpcWhitelists |
array |
否 |
关闭公网访问后，限定来源的 VPC 白名单，不设置或为空表示不限制来源。 |
|
|
string |
否 |
每一个限定的 VPC 白名单，值为来源 VPC ID。 |
vpc-j6cgd2if5lg**0xs6m5se |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
请求结果。 |
||
| requestId |
string |
请求 ID |
9BFC4AC1-6BE4-5405-BDEC-CA288D404812 |
示例
正常返回示例
JSON格式
{
"requestId": "\t\n9BFC4AC1-6BE4-5405-BDEC-CA288D404812\n"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Missing.Id | Id is mandatory for this action. | 缺少必填参数Id。 |
| 400 | Missing.Apis.PopCode | Apis.PopCode is mandatory for this action. | Apis参数中缺少必填参数popCode。 |
| 400 | Missing.Apis.PopVersion | Apis.PopVersion is mandatory for this action. | 缺少必填参数Apis.PopVersion。 |
| 400 | InvalidParam.Apis.PopVersion | Unsupported product version: %s of product code: %s. | 产品%s不支持%s版本。 |
| 400 | InvalidParam.Apis.PopCode | Unsupported product code: %s. | 指定的产品名称不存在。 |
| 400 | Missing.Apis.Selectors | Apis.Selectors is mandatory for this action. | Apis.Selectors是必填参数 |
| 400 | InvalidParam.Language | Unsupported language: %s. | 指定多语言无效。 |
| 400 | InvalidParam.AdditionalApiDescription.PopVersion | Unsupported product version: %s of product code: %s. | 产品%s不支持%s版本。 |
| 400 | InvalidParam.AdditionalApiDescription.PopCode | Unsupported product code: %s. | 指定的产品名称不存在 |
| 400 | InvalidParam.SystemTools | System tool %s is not supported. | 指定的系统工具无效。 |
| 400 | Missing.TerraformTools.Description | TerraformTools.Description is mandatory for this action. | 缺少必填参数TerraformTools.Description |
| 400 | Missing.TerraformTools.Code | TerraformTools.Code is mandatory for this action. | 缺少必填参数TerraformTools.Code。 |
| 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. | 请求使用了与之前请求相同的客户端令牌，但参数不同。请勿在参数不同的请求中重复使用同一令牌，每个独立请求必须使用唯一的令牌。 |
| 400 | InvalidParam.TerraformTools.Name | TerraformTools.Name: %s must be 3 to 64 characters long and can only contain lowercase letters, numbers, underscores, and hyphens. | Terraform工具名称长度必须为 3 到 63 个字符，并且只能包含小写字母、数字、下划线和连字符。 |
| 400 | Missing.TerraformTools.Name | TerraformTools.Name is mandatory for this action. | Terraform工具名称是必填参数。 |
| 400 | InvalidParam.TerraformTools.Code | The Terraform tool code is not valid: %s. Please check the syntax and try again. | 指定的TerraformTools.Code参数无效。 |
| 400 | InvalidParam.ClientToken | The specified client token is not valid. | 该幂等参数有误，请检查。 |
| 403 | OperationNotAllowed.SystemServer | System type servers are not allowed to be updated or deleted. | 系统级别的服务不允许更新或删除操作。 |
| 404 | NotFound.ApiMcpServer | Specified MCP server not found. | 指定id的MCP服务不存在。 |
| 409 | Exists.TerraformTools.Name | The Terraform tool name already exists. | 指定的Terraform 工具名称已经存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。