通过自定义筛选条件批量查询MCP服务详情。

请求参数

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

Action string 必选示例值：ListMCPServices

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

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

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

Filters.N.Name string[] 可选示例值：name1

精确过滤的字段名。

参数 - N：表示过滤条件的序号，取值范围：1～10。

多个字段名之间用&分隔，为“或”的关系。

取值：

name：MCP服务名称。

status：MCP服务状态。

说明

当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。

Filters.N.NameContains string[] 可选示例值：name1

模糊过滤的字段名。

参数 - N：表示过滤条件的序号，取值范围：1～10。

多个字段名之间用&分隔，为“或”的关系。

取值：

name：MCP服务名称。

status：MCP服务状态。

说明

当Filters.N.Name和Filters.N.NameContains同时传入时，仅Filters.N.Name生效。

Filters.N.Values.N string[] 可选示例值：mcp-****

过滤字段的值。

参数 - N：表示过滤条件的序号，取值范围：1～10。

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

当过滤字段为status时，取值：

Ready：运行中。

Creating：创建中。

Updating：更新中。

Deleting：删除中。

Error：不可用。

MaxResults integer 可选示例值：100

分页查询时设置的每页行数。

最小值：1。

最大值：100。

默认值：10

NextToken string 可选示例值：bS15ZTcwMjZiaWY0cTdvaTVjc3****==

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

ProjectName string 可选示例值：default

所属项目名称。

TagFilters.N.Key string[] 可选示例值：TagFilters.1.Key=k1

根据标签查询资源时指定的标签键，不允许重复。

参数 - N：表示标签键的序号，取值范围：1～10。

多个标签键之间用&分隔。

TagFilters.N.Values.N string[] 可选示例值：TagFilters.1.Values.1=v1

根据标签查询资源时指定的标签值。

第一个N：表示标签键的序号，取值范围：1～10。

第二个N：表示标签值的序号，取值范围：1～3，即同一标签键最多支持同时查询3个标签值。

多个标签值之间用&分隔。

说明

如果传入该参数，则必须先传入TagFilters.N.Key。

不传则表示查询同一标签键下的所有标签值。

传入空字符串时，表示查询标签值为空的标签。

GatewayInstanceId string 可选示例值：gw-********

MCP服务关联专属网关的实例ID。您可在AgentKit控制台“网关 > 网关实例 > 专属网关”中获取专属网关实例ID。

若传入此参数，仅返回该专属网关下的MCP服务。

若不传入此参数，则返回所有符合查询条件的MCP服务。

返回参数

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

MCPServices object[] 示例值：--

MCP服务详情。

IsAllTools boolean 示例值：true

是否添加了所有的工具。

CreatedAt string 示例值：2006-01-02T15:04:05Z07:00

MCP服务创建时间。

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

MCP服务ID。

Name string 示例值：mcp-name-***

MCP服务名称。

NetworkConfigurations object[] 示例值：--

MCP服务网络配置详情。

Endpoint string 示例值：***.apigateway-cn-beijing.volceapi.com

MCP服务访问的Endpoint。

NetworkType string 示例值：Public

MCP服务开启的访问类型，取值：

Public：公网访问。

Private：私网访问。

VpcConfiguration object 示例值：--

VPC网络配置信息。

SecurityGroupIds string[] 示例值：["sg-w08tvkc3e****"]

安全组ID列表。

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 示例值：MCP

MCP服务访问方式，取值：

HTTP：HTTP 转 MCP。

MCP：直接访问 MCP。

Status string 示例值：Ready

MCP服务状态，取值：

Ready：运行中。

Creating：创建中。

Updating：更新中。

Deleting：删除中。

Error：不可用。

Tags object[] 示例值：--

MCP服务标签。

Type string 示例值：system

标签类型。

system：系统标签。

custom：用户标签。

Key string 示例值：k1

标签键。

Value string 示例值：v1

标签值。

UpdatedAt string 示例值：2006-01-02T15:04:05Z07:00

MCP服务更新时间。

CanDelete boolean 示例值：true

MCP服务是否可以删除。

true：可以删除。

false：不可删除，MCP服务被MCP工具集引用时不可删除。

GatewayMode string 示例值：Shared

MCP服务的网关模式。

Shared：共享网关。

Exclusive：专属网关。

InboundAuthorizerConfiguration object 示例值：--

MCP服务入站认证配置。

AuthorizerType string 示例值：ApiKey

MCP服务出站身份认证安全的类型。

ApiKey：使用API Key认证。

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

Authorizer object 示例值：--

认证配置详情。

KeyAuth object 示例值：--

后端服务使用API Key进行出站凭据时，API Key的配置。

ApiKeys object[] 示例值：8b02f2e2-ae83-11f0-b6e5-******&In

API Key信息。

Key string 示例值：65a075a2-aeff-11f0-****-00163e72f914

API Key值。

Name string 示例值：key-ye7f6gd7nktv3gi6c***

API Key名称。

ApiKeyLocation string 示例值：HEADER

API Key的传递位置。

Parameter string 示例值：Authorization

请求头（Header）中携带的API Key对应的参数名称。

CustomJwtAuthorizer object 示例值：--

后端服务使用OAuth JWT进行出站凭据时，OAuth JWT的认证配置。

DiscoveryUrl string 示例值：https://example.com/.well-known/openid-configuration

认证服务地址。

AllowedClients string[] 示例值：["client1","client2"]

允许访问的客户端列表。

IdentityAuthorizer object 示例值：--

后端服务使用身份与权限（Identity）进行出站凭据时，凭证管理的配置。

ProviderType string 示例值：Oauth2M2m

凭据管理的类型。取值：

ApiKey：使用API Key凭据。

Oauth2M2m：使用OAuth Client。

CredentialProviderName string 示例值：Oauth2M2m01

凭证管理的名称。

NextToken string 示例值：bS15ZTcwMjZiaWY0cTdvaTVjc***w==

本次调用返回的查询凭证值，返回为空表示该页为末页。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	LimitExceeded.MaximumMaxResults	The number of specified MaxResults exceeds the maximum limit.	指定的MaxResults超过最大限制。