Mengambil daftar server MCP yang dipaginasi.
Deskripsi operasi
Request
This operation retrieves a paginated list of all MCP Servers within your account. You can filter the list by search keyword and visibility level, and control pagination by specifying the maximum number of results and a next page token.
-
Q: Optional. The search keyword for a fuzzy search on MCP Server names.
-
Visibility: Optional. The visibility level for filtering the results.
-
MaxResults: Optional. The maximum number of results to return per page. By default, no limit is applied.
-
NextToken: Optional. The next page token from a previous response. Use this parameter to retrieve the next page of results.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Q |
string |
No |
Kata kunci pencarian untuk pencarian fuzzy pada nama server MCP. |
mcp |
| Visibility |
array |
No |
Tingkat visibilitas untuk memfilter hasil. |
- |
|
string |
No |
The visibility level. Valid values: TENANT (visible within the account), PROJECT (visible to specified projects), and USER (visible to specified users). |
TENANT |
|
| MaxResults |
integer |
No |
Jumlah maksimum hasil yang dikembalikan per halaman. |
20 |
| NextToken |
string |
No |
Token halaman berikutnya dari tanggapan sebelumnya. Gunakan token ini untuk mengambil halaman hasil berikutnya. Kosongkan parameter ini untuk permintaan pertama. |
12345 |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
The response object. |
||
| RequestId |
string |
The request ID. |
824F80BA-1778-5D8A-BAFF-668A4D9C4CC7 |
| PagingInfo |
object |
The paging information. |
|
| TotalCount |
integer |
The total count of entries that match the filter criteria. |
100 |
| McpServers |
array<object> |
A list of MCP Server objects. |
|
|
array<object> |
|
||
| CreatorId |
string |
805298765622151 |
|
| ModifierId |
string |
123456 |
|
| Name |
string |
my-mcp-server |
|
| Config |
object |
||
| Url |
string |
https://example.com/mcp/sse |
|
| Transport |
string |
SSE |
|
| CustomHeaders |
object |
{} |
|
| Visibility |
string |
TENANT |
|
| GmtCreateTime |
string |
1780555634000 |
|
| GmtModifiedTime |
string |
1780555634000 |
|
| MaxResults |
integer |
The maximum number of results returned on the current page.**** |
100 |
| NextToken |
string |
The token for the next page of results. A null value indicates that all results have been returned.**** |
2 |
Contoh
Respons sukses
JSONformat
{
"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"
}
}Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.