
# 分页查询MCP列表（AK/SK认证）
#### 功能介绍
通过传入的limit参数查询资产中心MCP列表。
- 传输limit参数，则表示需要分页。查询首页时，marker为null。
- 未传输limit参数，则查询全部资产。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-appstage/appstage_07_0008.html)。
#### URI
GET https://aiae.appstage.myhuaweicloud.com/v1/routes/open/user/mcp/list
表1Query参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|:---|
| limit  | 否    | String | **参数解释：** 分页条数。 - 传输limit参数，则表示需要分页。查询首页时，marker为null。 - 未传输limit参数，则查询全部资产。 **约束限制：** 不涉及。 **取值范围：** 数字，最大1000。 **默认取值：** 不涉及。 |
| marker | 否    | String | **参数解释：** 页码。查询首页时，marker为null。 **约束限制：** 不涉及。 **取值范围：** 数字。最大100000。 **默认取值：** 不涉及。                                            |
#### 请求参数
表2请求Header参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-User-Info | 是    | String | **参数解释：** 鉴权信息。示例：{"iam_user_info":{"domain_id":"087708f382d2471bbd4649a97346530d","domain_name":"","user_id":"fb55057381ff41748cbdbc3c9ea8df0a","user_id_type":"0","user_name":"","project_id":"","project_name":""}}。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数        | 参数类型                                                                   | 描述                                               |
|:---|:---|:---|
| data      | Array of [data] objects | **参数解释：** 不同响应类型的响应体中包含不同的参数，见示例。 **取值范围：** 不涉及。 |
| page_info | [page_info] object | **参数解释：** 不同响应类型的响应体中包含不同的参数，见示例。 **取值范围：** 不涉及。 |
   
 表4data 
| 参数                      | 参数类型                                                                           | 描述                                                                                      |
|:---|:---|:---|
| name                    | String                                                                         | **参数解释：** agent名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                         |
| asset_id                | String                                                                         | **参数解释：** 资产的唯一ID。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                         |
| asset_type_display_name | String                                                                         | **参数解释：** 资产类型的国际化展示名。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                     |
| asset_type_name         | String                                                                         | **参数解释：** 资产类型名称，对应URL请求参数中的{assetType}。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。   |
| description             | String                                                                         | **参数解释：** 资产相关描述。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                          |
| created_by              | String                                                                         | **参数解释：** 资产创建人。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                           |
| create_time             | Number                                                                         | **参数解释：** 资产创建时间，13位毫秒级时间戳。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                |
| updated_by              | String                                                                         | **参数解释：** 资产的最新更新人，新创建的Agent最新更新人默认为资产创建人。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| update_time             | Number                                                                         | **参数解释：** 资产的最近一次更新时间，13位毫秒级时间戳。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。           |
| properties              | [McpProperties] object | MCP属性对象。                                                                                |
   
 表5McpProperties 
| 参数                 | 参数类型   | 描述                                                                           |
|:---|:---|:---|
| fc_instance_status | String | **参数解释：** 托管的MPC服务函数实例在FG侧的状态。 **取值范围：** 枚举值： - deletionFail：失败 - success：成功 |
| view_times         | Number | **参数解释：** 查看次数。 **取值范围：** 不涉及。                                               |
| install_times      | Number | **参数解释：** 安装次数。 **取值范围：** 不涉及。                                               |
| icon               | String | **参数解释：** 图标信息。 **取值范围：** 不涉及。                                               |
| deploy_type        | String | **参数解释：** MCP安装类型。 **取值范围：** 枚举值： - NPX：JS类型。 - UVX：python类型。 - SSE：远程连接类型。  |
| type               | String | **参数解释：** 类型。 **取值范围：** 枚举值： - inner：内置 - private：个人                         |
| fc_instance_id     | String | **参数解释：** 托管的MPC服务函数实例在FG侧的ID。 **取值范围：** 不涉及。                                |
   
 表6page_info 
| 参数              | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|
| next_marker     | String | **参数解释：** 下一页标记，用于下次调用请求入参中的marker使用，标识要翻到本次请求的下一页。如果是末页，此项为null。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                  |
| previous_marker | String | **参数解释：** 前一页标记，用于下次调用请求入参中的marker使用，标识要翻到本次请求的前一页。如果是首页，此项为null。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                  |
| current_count   | Number | **参数解释：** 当前页的元素实际个数。 例如，单页个数为10，元素总数为93，那前9页的current_count为10，末页的current_count为3。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
**状态码：400**
表7响应Body参数 
| 参数         | 参数类型   | 描述                             |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 不涉及。  |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述                             |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 不涉及。  |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
- 表示接口调用成功，正常响应。- 响应采用Server-Sent Events（SSE）机制进行流式输出，数据内容用data字段表示，示例如下：data: message。
![](https://support.huaweicloud.com/api-appstage/public_sys-resources/note_3.0-zh-cn.png)
data字段并不是一个JSON数据。此外，还可以有冒号开头的行，表示注释，通常可忽略。
```
{
  "data" : [ {
    "name" : "WeLink考勤服务_B4",
    "asset_id" : "2c307014a85a4c2f84e2923613bc3f7b",
    "asset_type_name" : "ai-mcp",
    "asset_type_display_name" : "资产中心mcp",
    "description" : "我的服务：\n1. 请假申请\n2. 出差申请\n3. 加班申请\n4. 补卡申请\n5. 外出申请\n6. 查询我的待处理考勤申请",
    "created_by" : "fb55057381ff41748cbdbc3c9ea8df0a",
    "create_time" : 1751105847000,
    "updated_by" : "fb55057381ff41748cbdbc3c9ea8df0a",
    "update_time" : 1751105848000,
    "properties" : {
      "name_en" : "",
      "description_en" : "",
      "deploy_type" : "sse",
      "fc_instance_status" : "success",
      "view_times" : 0,
      "install_times" : 0
    }
  } ],
  "page_info" : {
    "next_marker" : "1",
    "previous_marker" : null,
    "current_count" : 10
  }
}
```
**状态码：400**
缺少请求体。
```
{
  "error_code" : "AIAE.00001400",
  "error_msg" : "Request body is missing"
}
```
**状态码：500**
服务器内部错误或三方服务器内部错误。
```
[ {
  "error_code" : "AIAE.00001500",
  "error_msg" : "Internal Server Error."
}, {
  "error_code" : "AIAE.00001500",
  "error_msg" : "Internal Server Error2."
} ]
```
#### 状态码
| 状态码 | 描述                                                                                                                                      |
|:---|:---|
| 200 | - 表示接口调用成功，正常响应。- 响应采用Server-Sent Events（SSE）机制进行流式输出，数据内容用data字段表示，示例如下：data: message。 说明： data字段并不是一个JSON数据。此外，还可以有冒号开头的行，表示注释，通常可忽略。 |
| 400 | 缺少请求体。                                                                                                                                  |
| 500 | 服务器内部错误或三方服务器内部错误。                                                                                                                      |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-appstage/ErrorCode.html)。
