Janus Analytics

Janus Analytics MCP サーバー

AI コーディングエージェントをお使いの Janus アナリティクスに接続する MCP サーバー です。Claude Code、Cursor、Windsurf、その他の MCP 互換クライアントから、ダッシュボード、イベント、ファネル、利用状況を直接確認できます。

セットアップ

1. Full access スコープの Janus API キーを取得する

addjanus.ca で登録し、設定から API キーを作成します。スコープを Full access に設定してください。

キーのスコープはデフォルトで Ingest に設定されており、イベントの送信しかできません。Ingest キーを使うと、このサーバーのすべてのツールで 403 が返されます。ウェブサイトで使用しているキーを再利用するのではなく、MCP 用のキーを作成してください。Full access キーはすべてのアナリティクスを読み取り、キーを管理できるため、ブラウザーのコードに決して含めないでください。

以前のバージョンからアップグレードする場合： スコープ機能のリリース時に、既存のキーは Ingest スコープに変更されました。ツールが 403 を返すようになった場合は、設定から Full access キーを作成し、JANUS_API_KEY を更新してください。

2. MCP クライアントに追加する

Claude Code

claude mcp add janus -- npx -y @janus-analytics/mcp-server

次に、API キーを設定します。

export JANUS_API_KEY=jns_your_key_here

Claude Desktop / Cursor / Windsurf

MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "janus": {
      "command": "npx",
      "args": ["-y", "@janus-analytics/mcp-server"],
      "env": {
        "JANUS_API_KEY": "jns_your_key_here"
      }
    }
  }
}

設定ファイルの場所：

• Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）
• Cursor： 設定 > MCP サーバー
• Windsurf： ~/.windsurf/mcp.json

ツール

すべてのツールは読み取り専用です。サーバーがデータを変更することはありません。

ツール	説明
get_dashboard_stats	イベント数、ユニークビジター数、人気ページ、UTM ソース、国、直帰率、日別の推移を表示します。ボットのトラフィックは別途集計されます。apiKeyId での絞り込みは任意です。
query_events	種類、タグ、日付範囲、API キー、ボット（デフォルトは exclude、ほかに only、include）で絞り込み、ページネーションを指定してイベントログを検索します。
get_usage	今月のイベント使用量とプラン上限、API キー数、キーごとの内訳を表示します。
list_journeys	すべてのファネルを、ステップ定義、照合範囲、コンバージョン期間とともに一覧表示します。
get_journey_results	ファネルのコンバージョンデータ（ステップごとの件数、コンバージョン率、ステップ間の時間の中央値）を表示します。
list_api_keys	API キーの名前、プレフィックス、許可されたオリジン、最終使用日を一覧表示します。

プロンプトの例

接続したら、AI エージェントに次のような質問をしてみましょう。

• 「今週のトラフィックの状況はどうですか？」
• 「過去 7 日間の人気ページを表示してください」
• 「登録ジャーニーのファネルコンバージョン率はいくつですか？」
• 「今月の使用量上限に近づいていますか？」
• 「最も多くのイベントを受信している API キーはどれですか？」

設定

環境変数	必須	説明
JANUS_API_KEY	はい	Janus API キー（jns_ で始まります）。Full access スコープが必要です

ライセンス

MIT