KrystalView Analytics

KrystalView MCP 服务

让你的 AI Agent 直接访问网站分析数据。查询访客会话、调查 UX 阻碍、分析转化漏斗、查看营销活动和错误，并获取异常提醒——这一切都可以通过 Claude、Cursor 或任何兼容 MCP 的客户端完成。

连接选项

托管远程 MCP

如果你的客户端支持远程 MCP 服务或连接器式 OAuth，请使用此选项。 无需在本地安装软件包。

字段	值
端点	https://krystalview.com/mcp
传输方式	streamable-http
身份验证	OAuth 授权码 + PKCE
OAuth 元数据	https://krystalview.com/.well-known/oauth-authorization-server
受保护资源元数据	https://krystalview.com/.well-known/oauth-protected-resource

在 OAuth 流程中，KrystalView 会要求已登录用户选择 MCP 客户端可读取的网站。签发的令牌为只读令牌，且仅限访问该网站。 托管 OAuth 服务支持动态客户端注册、授权码 + PKCE、资源指示器、 刷新令牌轮换和令牌撤销。

对于支持使用自定义标头而非 OAuth 的客户端，托管端点 也接受 KrystalView 只读 API 密钥，格式如下：

Authorization: Bearer kv_live_...

或：

X-API-Key: kv_live_...

本地 stdio MCP 软件包

如果你的 MCP 客户端运行本地 stdio 服务，请使用此选项，例如 Claude Desktop、 Claude Code、Cursor 或类似的开发工具。

安装

pip install krystalview-mcp

配置

在 KrystalView 控制台的 Settings > API Keys 下生成 API 密钥。

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "krystalview": {
      "command": "krystalview-mcp",
      "env": {
        "KRYSTALVIEW_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add krystalview -- krystalview-mcp
# Then set your API key:
export KRYSTALVIEW_API_KEY="your-api-key-here"

Cursor

添加到 MCP 设置中：

{
  "krystalview": {
    "command": "krystalview-mcp",
    "env": {
      "KRYSTALVIEW_API_KEY": "your-api-key-here"
    }
  }
}

可用工具

工具	说明
get_sessions	使用筛选条件（设备、位置、阻碍、愤怒点击）列出／搜索访客会话
get_session_detail	深入查看特定会话——完整时间线、事件、导航路径
get_site_stats	汇总性能指标——会话、阻碍、设备、热门页面
get_scroll_depth	特定页面路径的滚动深度区间
get_live_visitors	当前活跃访客数量和近期实时会话
get_anomalies	AI 检测到的异常及其说明（流量激增／下降、阻碍激增）
get_funnels	列出已定义的转化漏斗
get_funnel_analysis	逐步分析漏斗转化率和流失情况
get_campaign_summary	UTM 营销活动归因摘要
get_campaign_sessions	特定营销活动带来的访客会话
get_campaign_roas	已连接时显示付费营销活动支出、转化和 ROAS
get_errors	汇总客户端浏览器错误
get_notifications	近期 KrystalView 通知和洞察

示例提示词

连接后，可以尝试询问你的 AI 助手：

• “我这个网站本周表现如何？”
• “显示过去 24 小时内感到沮丧的移动端用户”
• “我们的流量昨天为什么下降了？”
• “用户在哪一步退出了结账漏斗？”
• “查找在定价页面上发生愤怒点击的会话”
• “哪些营销活动带来了阻碍最多的会话？”
• “显示包含示例会话 ID 的未解决浏览器错误”
• “有没有什么我应该了解的异常？”

环境变量

变量	必需	默认值	说明
KRYSTALVIEW_API_KEY	是	—	你的 KrystalView API 密钥
KRYSTALVIEW_BASE_URL	否	https://krystalview.com/api	API 基础 URL
KRYSTALVIEW_TIMEOUT	否	15	请求超时时间（秒）

速率限制

API 密钥的速率限制可配置（默认值：每分钟 60 个请求）。每个响应都包含速率限制标头。如果达到限制，服务会返回明确的错误，并说明重试时间。

安全性

• API 密钥仅适用于单个站点 — Agent 只能访问创建该密钥的站点的数据
• 托管 MCP 端点签发的 OAuth 令牌为只读，且仅适用于所选站点
• 托管 OAuth 支持刷新令牌轮换和令牌撤销
• 会根据明确列出的可信来源检查源自浏览器的 MCP/OAuth 请求
• 工具为只读
• 所有请求均使用 HTTPS
• 可在 KrystalView 控制台中轮换或撤销密钥
• 本地 stdio 软件包不存储数据 — 它直接代理 KrystalView API

许可证

MIT