分页列出 MCP Server
接口说明
请求说明
该 API 用于分页查询当前账号下的所有 MCP Server 列表。支持通过搜索关键词、可见性级别过滤以及设置最大返回条数和分页 Token 来获取特定的 MCP Server 信息。
Q: 可选参数，用于按 MCP Server 名称进行模糊匹配搜索。
Visibility: 可选参数，允许传入多个值以按可见性级别（如
TENANT、PROJECT或USER）过滤结果。MaxResults: 可选参数，指定本次请求返回的最大条数，默认不限制。
NextToken: 可选参数，用于分页查询时传递上一次请求返回的 NextToken 值以获取下一页数据。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Q |
string |
否 |
搜索关键词，按 MCP Server 名称模糊匹配。 |
mcp |
| Visibility |
array |
否 |
按可见性级别过滤，可传多个。 |
- |
|
string |
否 |
可见性级别。可选值：TENANT（账号内可见）、PROJECT（指定项目可见）、USER（指定用户可见）。 |
TENANT |
|
| MaxResults |
integer |
否 |
本次请求返回的最大条数。 |
20 |
| NextToken |
string |
否 |
分页 Token。首次查询不传；后续查询传上一次返回的 NextToken 获取下一页。 |
12345 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数对象。 |
||
| RequestId |
string |
请求 ID。 |
824F80BA-1778-5D8A-BAFF-668A4D9C4CC7 |
| PagingInfo |
object |
分页信息 |
|
| TotalCount |
integer |
符合条件的总条数。 |
100 |
| McpServers |
array<object> |
MCP Server 列表。 |
|
|
array<object> |
|
||
| CreatorId |
string |
创建者 ID。 |
805298765622151 |
| ModifierId |
string |
最近修改者 ID。 |
123456 |
| Name |
string |
MCP Server 名称。 |
my-mcp-server |
| Config |
object |
MCP Server 连接配置。 |
|
| Url |
string |
MCP Server 服务地址。 |
https://example.com/mcp/sse |
| Transport |
string |
传输协议。 |
SSE |
| CustomHeaders |
object |
自定义请求头。 |
{} |
| Visibility |
string |
可见性级别。 |
TENANT |
| GmtCreateTime |
string |
创建时间（毫秒时间戳）。 |
1780555634000 |
| GmtModifiedTime |
string |
最近修改时间（毫秒时间戳）。 |
1780555634000 |
| MaxResults |
integer |
本次返回的最大条数。 |
100 |
| NextToken |
string |
下一页 Token，为空表示已到末页。 |
2 |
示例
正常返回示例
JSON格式
{
"RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
"PagingInfo": {
"TotalCount": 100,
"McpServers": [
{
"CreatorId": "805298765622151",
"ModifierId": "123456",
"Name": "my-mcp-server",
"Config": {
"Url": "https://example.com/mcp/sse",
"Transport": "SSE",
"CustomHeaders": {}
},
"Visibility": "TENANT",
"GmtCreateTime": "1780555634000",
"GmtModifiedTime": "1780555634000"
}
],
"MaxResults": 100,
"NextToken": "2"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。