KrystalView Analytics

io.github.McSlaine由 GitHub 帳號 McSlaine 發布v0.1.2更新於 Oct 24, 2026

AI agent access to website analytics, session replay, and anomaly detection.

已驗證STDIO僅桌面效率與工作流資料與分析

概覽

AI 產生的概覽

讓助理查詢 KrystalView 網站分析資料，包括訪客工作階段、漏斗、行銷活動、錯誤與異常警示。

可以做什麼
將 AI 助理連接到 KrystalView 網站分析。唯讀工具涵蓋訪客工作階段與工作階段詳情、網站統計、捲動深度、即時訪客、AI 偵測的異常、轉換漏斗與逐步流失分析、UTM 行銷活動摘要、工作階段與 ROAS、彙總的瀏覽器錯誤以及通知。它可作為託管遠端 MCP 端點執行，也可作為本機 stdio 套件直接代理到 KrystalView API。
適用情境
適合想在不開啟 KrystalView 儀表板的情況下，向助理詢問網站成效、流量變化、漏斗流失、行銷活動成果或使用者體驗阻礙的情境。適用於已使用 KrystalView 進行分析與工作階段重播的團隊。
執行需求
需要 KrystalView 帳號，以及在主控台 Settings > API Keys 產生的 API 金鑰，透過 KRYSTALVIEW_API_KEY 提供。本機方式需要 Python 與 krystalview-mcp 套件；託管方式需要支援遠端 MCP 與 OAuth 的用戶端。可選 KRYSTALVIEW_BASE_URL 與 KRYSTALVIEW_TIMEOUT。需要連線至 KrystalView API 的網路。
安裝前請注意
需要密鑰 KRYSTALVIEW_API_KEY，該金鑰僅限單一網站使用，可在主控台輪換或撤銷。工具為唯讀，但會將訪客工作階段、行銷活動與錯誤資料暴露給助理及其供應方。託管端點也接受透過 Authorization 或 X-API-Key 標頭傳入的唯讀 API 金鑰。預設速率限制為每分鐘 60 次請求。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 KrystalView Analytics，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 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

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

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

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分