怎么用 MCP 把 AI 智能体接到统计数据？

简短回答

在 配置 › 设置 › API 密钥 创建一个权限范围为「读取报表」（stats:read）的密钥，再到 全端分析 › 智能运营 › AI 助手 的「MCP 接入」页签复制端点和客户端配置，填进你的 MCP 客户端。智能体会拿到 10 个只读的查询工具。

1. 创建只读密钥

1. 打开 配置 › 设置 › API 密钥，新建一个密钥。
2. 权限范围选「读取报表」（stats:read）。没有这个范围，每次调用工具都会失败。
3. 密钥只显示 wck_ 前缀。放在客户端的密钥设置里，不要写进共享文件。

2. 复制端点和配置

在 AI 助手页的「MCP 接入」页签复制端点（路径 /api/v1/mcp）、客户端配置和命令行示例。协议是 Streamable HTTP，响应是 JSON，没有服务端推流。

接进智能体之前先测一下。示例请求，端点放在 TAPCUB_MCP_URL 里，项目编号是示例值：

curl -X POST "$TAPCUB_MCP_URL" \
  -H "Authorization: Bearer wck_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ask","arguments":{"site_id":123,"question":"近 7 天访客，对比上一周期"}}}'

成功时结果在 content 的文本里，多为 JSON。

3. 智能体能调用什么

除 list_sites 外，工具都要 site_id，所以让智能体先调用 list_sites。时间可用预设或 from / to（站点时区的日期）。

4. 它不会做什么

• 工具只读：不写事件、不改定义、不创建监控。
• 没有资源和提示词模板，不要假设还有别的工具。
• 每次调用都按 site_id 检查访问权，并计入开放 API 用量和频率限制。
• ask 看不懂问题时返回澄清，不执行查询。

常见问题

想在控制台里直接问，见问 AI 助手。

相关阅读

• 怎么用 SQL 查询我的数据？
• 怎么导出原始数据？