AI导哈

网站分析查询服务

KrystalView MCP Server 为AI代理提供直接访问网站分析数据的功能，包括查询访客会话、分析转化漏斗、审查营销活动和错误以及获取异常警报。

  • by KrystalView
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 KrystalView/krystalview-mcp

使用说明

KrystalView MCP服务器

让您的AI代理直接访问网站分析。查询访问者会话，调查用户体验摩擦，分析转化渠道，审查活动和错误，并获取异常警报——所有这些都来自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控制台 在...之下 设置>API密钥.

克劳德桌面版

添加到您的 claude_desktop_config.json:

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

克劳德代码

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

光标

添加到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 人工智能检测到异常并给出解释（流量峰值/下降、摩擦激增）
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密钥的作用域为单个站点-代理只能访问为其创建密钥的站点的数据
  • 由托管的MCP端点颁发的OAuth令牌是只读的，其作用域仅限于所选站点
  • 托管OAuth支持刷新令牌轮换和令牌撤销
  • 根据显式可信来源检查浏览器发起的MCP/Outh请求
  • 工具是只读的
  • 所有请求都使用HTTPS
  • 可以在KrystalView控制台中旋转或撤销密钥
  • 本地stdio包不存储任何数据-它直接代理到KrystalView API

许可证

麻省理工学院

相关 MCP