KrystalView Analytics

Name: KrystalView Analytics
Author: McSlaine

本地服务

github.com/McSlaine数据与分析020 周前更新

代码仓库

关于 KrystalView Analytics

KrystalView Analytics 是面向 AI Agent 的 MCP 服务，用于调查网站表现和访客行为。它通过托管或本地连接，以只读方式提供会话回放、转化漏斗、营销活动、错误和异常数据。

主要功能

01搜索访客会话并查看时间线
02查看网站指标和滚动深度
03分析转化漏斗与流失情况
04检查营销归因和 ROAS
05查找浏览器错误和流量异常

适用场景

01调查页面上的愤怒点击
02定位结账漏斗的流失环节
03比较营销活动流量和摩擦情况
04检查流量变化和浏览器错误

MCP 相关

向 MCP 客户端提供只读网站分析工具。可通过 OAuth 或 API 密钥连接托管远程端点，也可运行本地 stdio 程序包。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mcslaine-krystalview": {
      "command": "uvx",
      "args": [
        "krystalview-mcp"
      ],
      "env": {
        "KRYSTALVIEW_API_KEY": "<KRYSTALVIEW_API_KEY>",
        "KRYSTALVIEW_BASE_URL": "<KRYSTALVIEW_BASE_URL>"
      }
    }
  }
}

启动命令uvx krystalview-mcp

需要配置的环境变量

KRYSTALVIEW_API_KEY密钥Your KrystalView API key (generate in console under Settings > API Keys)

KRYSTALVIEW_BASE_URLAPI base URL (default: https://app.krystalview.com/api)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypikrystalview-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。