MCP 接入与查询参考

通过 Streamable HTTP MCP 将 Asklear 接入你的 Agent，并验证第一次认证工具调用。

{
  "mcpServers": {
    "asklear": {
      "type": "http",
      "url": "<YOUR_API_BASE_URL>/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
      }
    }
  }
}

1. query_metrics
2. search_values
3. describe(dataset)
4. list_datasets

• 当前或最新对每个 dataset 分别发送 time.last_complete_months=1。JD/Tmall 跨数据集比较使用分开的 query_metrics 调用，分别报告 meta.resolved_query 中的实际月份，不假设共用数据水位。
• 用户明确指定公共时间范围时，将原范围分别发送给每个数据集，不得静默裁剪。
• 向用户解释 data_range_unavailable；不得裁剪、替换月份、补零或静默省略不可用数据。这是范围错误，不是 503 能力不可用。
• 契约声明的指标、可分组维度、筛选和排序可自由组合；recipe 是示例，不是白名单。
• group_by 即实际结果粒度；趋势包含 month，店铺或商品结果包含实体身份字段。

• 每次 Asklear 业务工具调用都必须携带有效 task_query；缺失或无效会被 task_query_required 或 invalid_task_query 拒绝且不执行。按错误 hint 修正 task_query 后，使用原请求参数重试。
• JD 与 Tmall 的数据水位相互独立。跨数据集比较必须对每个数据集分开调用 query_metrics，并分别报告 meta.resolved_query 中各自的实际月份；不得假设共用数据水位。
• data_range_unavailable 是范围错误，不是 503 能力不可用，不要当故障重试；应向用户解释不可用月份，不得裁剪、替换月份、补零或静默省略不可用数据。
• 收到 approval_required 时，将费用上界 upper_bound_credits 表述为最多消耗，实际 Credits 以执行结果为准。用户同意后，使用 max_credits，并把返回的 plan_digest 赋给 approved_plan_digest，对完全相同的请求重试一次。
• 对 dataset=tmall，2026-06 是首发数据水位（首个已发布覆盖月份），不是订阅起始月份；不要把它解释成租户订阅的开始时间。
• 不确定具体规则、字段名、数据集限制或错误恢复方式时，先在会话内调用只读 `docs` 工具查文档，不要靠猜。它与开发者文档站同源，免费、不计入 Usage、也不触发数据集查询。

把这份模板放入客户端，完成 Asklear MCP 配置并验证第一次查询。

Integrate the Asklear MCP data service for me, then run a first verified
query. Follow these steps in order:

1. Fetch <YOUR_DASHBOARD_ORIGIN>/docs/agent/llms.txt from the Asklear docs
   site to get the index of all Asklear agent documentation, and fetch any
   linked .md page you need while you work. <YOUR_DASHBOARD_ORIGIN> is the
   Asklear dashboard origin, which may differ from the MCP origin below.
2. Ask me for my business scenario and my target dataset:
   jd (JD), tmall (Tmall), or both.
3. Generate the MCP configuration (mcp.json) for my coding agent client,
   with my values filled into this template:

{
  "mcpServers": {
    "asklear": {
      "type": "http",
      "url": "<YOUR_API_BASE_URL>/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ASKLEAR_API_KEY>"
      }
    }
  }
}

4. Accept the integration only after one authenticated connection_status
   call succeeds, and show me its result.
5. Run the first query with query_metrics on my target dataset, then report
   the business conclusion and the resolved month from meta.resolved_query.