Skip to main content
POST
查询 MCP 服务器列表

限制说明

使用说明

  • 响应不包含实时工具列表;工具列表在创建/更新后异步探测并缓存供运行时使用。
  • query 会对名称、描述、AI 生成描述、服务器 ID、传输协议、URL、命令及市场模板名称进行不区分大小写的子串匹配。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

MCP 服务器列表的分页、范围与搜索过滤条件。

p
integer
默认值:1

页码,从 1 开始。

limit
integer
默认值:20

每页数量。

scope
enum<string>

结果范围:account 仅返回账户级记录,team 仅返回调用者可见的团队级记录,省略则默认为 all(返回两者,仍受 team_ids/include_account 约束)。

可用选项:
all,
account,
team
query
string

对名称、描述、AI 生成描述、服务器 ID、传输协议、URL、命令、市场模板名称进行不区分大小写的子串搜索。

Maximum string length: 128
team_ids
integer<int64>[]

按团队 ID 过滤;为空则使用调用者可见范围。

include_account
boolean | null

是否包含账户级(team_id=0)记录,默认 true。

响应

成功

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

分页的 MCP 服务器列表。