Header 参数	是否必填	描述
`Authorization`	是	固定取值为 `Bearer {access_token}`。关于如何获取访问令牌，参考鉴权。
`Content-Type`	是	固定取值为 `application/json`。

请求体参数

参数	类型	是否必填	默认值	描述
`start_date`	string	是	-	开始日期。格式：YYYY-MM-DD。
`end_date`	string	是	-	结束日期。格式：YYYY-MM-DD。
`timezone`	string	否	`"Asia/Shanghai"`	时区。需使用 IANA 时区名称。
`user_ids`	string[]	条件必填	-	成员的 ID。与 `emails` 至少传一个。成员的 ID 可以通过 “获取成员列表” 接口获取。
`emails`	string[]	条件必填	-	成员的邮箱。与 `user_ids` 至少传一个。成员的邮箱可以通过 “获取成员列表” 接口获取。
`top_n`	int	否	`20`	指定返回使用量排行前 `top_n` 的 MCP。取值范围：[1, 100]。

响应参数

该接口独有的响应参数如下，参数位于 data 对象中。通用响应参数参考此文档。

参数	类型	描述
`user_mcp_list`	array	按成员组织的 MCP 使用排行列表。
`user_mcp_list[].user_id`	string	成员的 ID。
`user_mcp_list[].email`	string	成员的邮箱。
`user_mcp_list[].account_type`	int	成员的账号类型，`1` 表示全端账号，`2` 表示 Work 专属账号。
`user_mcp_list[].mcp_list`	array	该成员的 MCP 使用排行数据。
`user_mcp_list[].mcp_list[].name`	string	MCP 的名称。
`user_mcp_list[].mcp_list[].use_count`	int64	MCP 被调用的次数。

示例

请求示例

curl -X POST "${HOST}/openapi/v1/statistics/user-mcp" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "start_date": "2026-08-01",
    "end_date": "2026-08-02",
    "emails": [
      "alice@example.com"
    ],
    "top_n": 10
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_xxx",
  "data": {
    "user_mcp_list": [
      {
        "user_id": "123456",
        "email": "alice@example.com",
        "account_type": 1,
        "mcp_list": [
          {
            "name": "search",
            "use_count": 120
          }
        ]
      }
    ]
  }
}

错误码

若该接口的请求返回错误码，参考错误码文档进行排查。

文档对您有帮助吗?