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 分