KrystalView Analytics

KrystalView MCP サーバー

AI エージェントからウェブサイトのアナリティクスに直接アクセスできます。訪問者のセッションを検索し、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 パッケージ

Claude Desktop、 Claude Code、Cursor などの開発者向けツールのように、MCP クライアントがローカルの stdio サーバーを実行する場合に使用します。

インストール

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 キーには設定可能なレート制限があります（デフォルト：1 分あたり 60 リクエスト）。すべてのレスポンスにレート制限のヘッダーが含まれます。上限に達すると、サーバーは再試行までの時間を示す明確なエラーを返します。

セキュリティ

• API キーは単一のサイトにスコープが設定されており、エージェントはキーの作成対象となったサイトのデータにのみアクセスできます
• ホスト型 MCP エンドポイントが発行する OAuth トークンは読み取り専用で、選択したサイトにスコープが設定されています
• ホスト型 OAuth はリフレッシュトークンのローテーションとトークンの失効に対応しています
• ブラウザーから送信される MCP／OAuth リクエストは、明示的に指定された信頼済みオリジンと照合されます
• ツールは読み取り専用です
• すべてのリクエストで HTTPS を使用します
• KrystalView コンソールでキーをローテーションまたは失効できます
• ローカルの stdio パッケージはデータを保存せず、KrystalView API に直接プロキシします

ライセンス

MIT