KrystalView Analytics

io.github.KrystalView由 GitHub 账号 KrystalView 发布v0.1.6更新于 Oct 24, 2026

Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

以只读方式通过 MCP 访问 KrystalView 网站分析数据：访客会话、漏斗、营销活动、错误、实时访客与异常。

可以做什么
  • 列出并查看访客会话，可按网址、国家、设备、时长、摩擦和暴怒点击筛选，并查看完整会话时间线与事件
  • 读取站点汇总指标、指定页面路径的滚动深度分布，以及当前活跃访客
  • 列出转化漏斗，并分析各步骤到达率、流失与完成证据
  • 查看按 UTM 来源和媒介归因的营销活动汇总、特定活动的会话，以及已接入广告数据时的花费与 ROAS
  • 获取聚合的浏览器错误及受影响路径和示例会话，以及流量、摩擦、跳出和转化异常与近期通知
适用场景
适合让助手回答网站流量与体验质量问题：流量为何下降、用户在漏斗哪一步流失、哪些活动带来高摩擦会话、哪些浏览器错误尚未解决，而无需打开 KrystalView 后台。
运行要求
可使用托管远程端点并通过 OAuth 连接（无需本地安装），或使用 PyPI 包 krystalview-mcp 以 stdio 本地运行，需要 Python 及 KRYSTALVIEW_API_KEY 环境变量；可选 KRYSTALVIEW_BASE_URL 与 KRYSTALVIEW_TIMEOUT。需要 KrystalView 账号及在控制台生成的 API 密钥，并能访问 KrystalView API。
安装前请注意
需要 KrystalView API 密钥（KRYSTALVIEW_API_KEY）或 OAuth 令牌；密钥与令牌仅限单个站点且为只读，可在控制台轮换或撤销。工具本身只读，但返回的数据包含访客会话、设备信息、活动与广告花费数据及错误详情，会发送给 AI 客户端。API 密钥有可配置的速率限制，默认每分钟 60 次请求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 KrystalView Analytics，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.KrystalView%2Fkrystalview/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "krystalview-analytics": {
      "type": "http",
      "url": "https://krystalview.com/mcp"
    }
  }
}

README

KrystalView MCP Server

Give your AI agents direct access to website analytics. Query visitor sessions, investigate UX friction, analyze conversion funnels, review campaigns and errors, and get anomaly alerts — all from Claude, Cursor, or any MCP-compatible client.

Connection Options

Hosted Remote MCP

Use this when your client supports remote MCP servers or connector-style OAuth. No local package install is required.

FieldValue
Endpointhttps://krystalview.com/mcp
Transportstreamable-http
AuthenticationOAuth authorization code + PKCE
OAuth metadatahttps://krystalview.com/.well-known/oauth-authorization-server
Protected resource metadatahttps://krystalview.com/.well-known/oauth-protected-resource

During OAuth, KrystalView asks the signed-in user to choose the site the MCP client can read. The issued token is read-only and scoped to that site. The hosted OAuth server supports dynamic client registration, authorization code + PKCE, resource indicators, refresh-token rotation, and token revocation.

For clients that support custom headers instead of OAuth, the hosted endpoint also accepts a KrystalView read API key as either:

http
Authorization: Bearer kv_live_...

or:

http
X-API-Key: kv_live_...

Local stdio MCP Package

Use this when your MCP client runs local stdio servers, such as Claude Desktop, Claude Code, Cursor, or similar developer tools.

Install

bash
pip install krystalview-mcp

Configure

Generate an API key in your KrystalView console under Settings > API Keys.

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "krystalview": {      "command": "krystalview-mcp",      "env": {        "KRYSTALVIEW_API_KEY": "your-api-key-here"      }    }  }}
Claude Code
bash
claude mcp add krystalview -- krystalview-mcp# Then set your API key:export KRYSTALVIEW_API_KEY="your-api-key-here"
Cursor

Add to your MCP settings:

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

Available Tools

ToolDescription
get_sessionsList/search visitor sessions with filters (device, location, friction, rage clicks)
get_session_detailDeep dive into a specific session — full timeline, events, navigation path
get_site_statsAggregate performance metrics — sessions, friction, devices, top pages
get_scroll_depthScroll-depth buckets for a specific page path
get_live_visitorsCurrently active visitor count and recent live sessions
get_anomaliesAI-detected anomalies with explanations (traffic spikes/drops, friction surges)
get_funnelsList defined conversion funnels
get_funnel_analysisStep-by-step funnel conversion rates and drop-off analysis
get_campaign_summaryUTM campaign attribution summary
get_campaign_sessionsVisitor sessions from a specific campaign
get_campaign_roasPaid campaign spend, conversions, and ROAS where connected
get_errorsAggregated client-side browser errors
get_notificationsRecent KrystalView notifications and insights

Example Prompts

Once connected, try asking your AI assistant:

  • "How's my site performing this week?"
  • "Show me frustrated mobile users from the last 24 hours"
  • "Why did our traffic drop yesterday?"
  • "Where are users dropping off in the checkout funnel?"
  • "Find sessions with rage clicks on the pricing page"
  • "Which campaigns are driving the most high-friction sessions?"
  • "Show me unresolved browser errors with sample session IDs"
  • "Are there any anomalies I should know about?"

Environment Variables

VariableRequiredDefaultDescription
KRYSTALVIEW_API_KEYYes—Your KrystalView API key
KRYSTALVIEW_BASE_URLNohttps://krystalview.com/apiAPI base URL
KRYSTALVIEW_TIMEOUTNo15Request timeout in seconds

Rate Limits

API keys have configurable rate limits (default: 60 requests per minute). Rate limit headers are included in every response. If you hit the limit, the server returns a clear error with retry timing.

Security

  • API keys are scoped to a single site — agents can only access data for the site the key was created for
  • OAuth tokens issued by the hosted MCP endpoint are read-only and scoped to the selected site
  • Hosted OAuth supports refresh-token rotation and token revocation
  • Browser-originating MCP/OAuth requests are checked against explicit trusted origins
  • Tools are read-only
  • All requests use HTTPS
  • Keys can be rotated or revoked in the KrystalView console
  • The local stdio package stores no data — it proxies directly to the KrystalView API

License

MIT

来源：README.md，提交 f4df256

工具

13

get_sessions

List Sessions

List recent visitor sessions with filters for URL, country, device, duration, friction, and rage clicks.

输入参数limitqueryoffsetcountrydevice_typemin_durationmin_frictionhas_rage_clicks

get_session_detail

Get Session Detail

Get full details for a specific visitor session, including pages, events, device context, errors, and friction signals.

输入参数session_id必填

get_site_stats

Get Site Stats

Get aggregate site metrics including all sessions, likely human sessions, likely bot/crawler sessions, duration, friction, rage clicks, daily counts, device mix, and top pages.

输入参数days

get_scroll_depth

Get Scroll Depth

Get cumulative scroll-depth reach buckets for a specific page path.

输入参数dayspath必填

get_live_visitors

Get Live Visitors

Get currently active visitors and sessions seen in the live activity window.

无需输入参数。

get_anomalies

Get Anomalies

List detected traffic, friction, bounce, and conversion anomalies for the site.

输入参数limitunacknowledged_only

get_funnels

List Funnels

List conversion funnels defined for this site.

无需输入参数。

get_funnel_analysis

Analyze Funnel

Analyze a conversion funnel and show step reach, drop-off, and completion evidence.

输入参数daysfunnel_id必填

get_campaign_summary

Get Campaign Summary

Get campaign attribution breakdown by UTM campaign, source, medium, sessions, duration, and bounce rate.

输入参数days

get_campaign_sessions

Get Campaign Sessions

List sessions attributed to a specific marketing campaign.

输入参数limitoffsetcampaign必填

get_campaign_roas

Get Campaign ROAS

Get paid campaign spend, clicks, sessions, attributed conversions, and ROAS where ad data is connected.

输入参数days

get_errors

Get Browser Errors

Get aggregated browser errors grouped by type and message, with affected paths and sample sessions.

输入参数limiterror_typeunresolved_only

get_notifications

Get Notifications

Get recent KrystalView notifications such as insights, setup notices, errors, and anomalies.

输入参数limitoffsetunread_only

版本历史

1
  1. v0.1.6最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分