文档反馈
获取指定时间范围内，企业整体的 MCP 使用排行。
所需权限
statistics:read
请求说明
- 请求方式：
GET - 请求地址：
{域名}/openapi/v1/statistics/mcp
注意事项
时间跨度最长为 180 天。
请求参数
请求头参数
| Header 参数 | 是否必填 | 描述 |
|---|---|---|
Authorization |
是 | 固定取值为 Bearer {access_token}。关于如何获取访问令牌，参考鉴权。 |
查询参数
| 参数 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date |
string | 是 | - | 开始日期。格式：YYYY-MM-DD。 |
end_date |
string | 是 | - | 结束日期。格式：YYYY-MM-DD。 |
timezone |
string | 否 | "Asia/Shanghai" |
时区。需使用 IANA 时区名称。 |
top_n |
int | 否 | 20 |
指定返回使用量排行前 top_n 的 MCP。取值范围：[1, 100]。 |
响应参数
该接口独有的响应参数如下，参数位于 data 中。通用响应参数参考此文档。
| 参数 | 类型 | 描述 |
|---|---|---|
mcp_list |
array | MCP 使用排行列表。 |
mcp_list[].name |
string | MCP 的名称。 |
mcp_list[].use_count |
int64 | MCP 被调用的次数。 |
示例
请求示例
curl -X GET "${HOST}/openapi/v1/statistics/mcp?start_date=2026-08-01&end_date=2026-08-15&top_n=20" \
-H "Authorization: Bearer ${ACCESS_TOKEN}"
响应示例
{
"code": 0,
"message": "success",
"request_id": "req_xxx",
"data": {
"mcp_list": [
{
"name": "search",
"use_count": 3200
},
{
"name": "browser",
"use_count": 1800
}
]
}
}
错误码
若该接口的请求返回错误码，参考错误码文档进行排查。
文档对您有帮助吗?