分頁列出 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"
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。