コンテンツにスキップ
Framedash Docs

MCP Server

Framedash MCP Server は、LLM（大規模言語モデル）から Framedash のテレメトリデータに直接アクセスするための Model Context Protocol サーバーです。12 個の読み取り専用ツールと 4 個のリソースを提供し、自然言語でゲーム分析データを照会できます。

セットアップ

Section titled “セットアップ”

Claude Desktop

Section titled “Claude Desktop”

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["-y", "@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_admin_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

VS Code (Claude Extension)

Section titled “VS Code (Claude Extension)”

VS Code の設定に以下を追加:

{
  "claude.mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["-y", "@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_admin_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

環境変数

Section titled “環境変数”
変数必須説明
FRAMEDASH_API_KEYはいAdmin API キー（fd_admin_ プレフィックス）
FRAMEDASH_PROJECT_IDいいえデフォルトプロジェクト UUID
FRAMEDASH_BASE_URLいいえAPI ベース URL（デフォルト: https://app.framedash.dev）

ツール

Section titled “ツール”

クエリ

Section titled “クエリ”
ツール説明引数
queryClickHouse events テーブルに対する読み取り専用 SQL クエリを実行sql (string, 必須), project_id (uuid, 任意), limit (int 1-1000, デフォルト 100)

アナリティクス

Section titled “アナリティクス”
ツール説明引数
get_dashboardプロジェクト KPI（DAU、MAU、セッション、イベント数）project_id (uuid, 任意), days (7/14/30/90, デフォルト 30)
get_retentionコホートリテンション分析project_id (uuid, 任意), days (7/14/30/90, デフォルト 30)
get_funnelイベントファネル分析project_id (uuid, 任意), steps (string, 必須: カンマ区切り 2-8 イベント名), days (7/14/30/90, デフォルト 30)
get_insightsディメンション別集計インサイトproject_id (uuid, 任意), metric (count/unique_players, 必須), group_by (string, 必須: event_name, platform 等), days (7/14/30/90, デフォルト 30), limit (10/20/50), event_name (string, 任意)
get_heatmapマップのヒートマップグリッドデータproject_id (uuid, 任意), map_id (string, 必須), cell_size (5/10/25/50, デフォルト 25), days (1/7/14/30, デフォルト 7), event_name (string, 任意)

プロジェクト

Section titled “プロジェクト”
ツール説明引数
list_projectsAPI キーに紐付けられたプロジェクトを表示なし
get_project_statusプロジェクトのヘルス概要（イベント数、最終イベント時刻）project_id (uuid, 任意)
list_mapsプロジェクト内のマップ一覧project_id (uuid, 任意)
list_contentコンテンツレジストリエントリ一覧project_id (uuid, 任意), type (string, 任意)

アラート

Section titled “アラート”
ツール説明引数
list_alertsアラートルール一覧project_id (uuid, 任意)
get_alert_historyアラートのトリガー・解除履歴project_id (uuid, 任意), limit (int 1-100, デフォルト 50)

リソース

Section titled “リソース”

framedash:// URI スキームで MCP リソースとしてデータにアクセスできます:

URI説明
framedash://projectsAPI キーに紐付けられたプロジェクト
framedash://projects/{projectId}/mapsマップ一覧（座標・範囲付き）
framedash://projects/{projectId}/contentコンテンツレジストリ
framedash://projects/{projectId}/statusプロジェクトの状態と統計

使用例

Section titled “使用例”

MCP Server を設定すると、LLM に自然言語で問い合わせできます:

プロンプト例使用されるツール
「過去 7 日間の DAU を見せて」get_dashboard (days=7)
「spawn から death までのファネルを分析して」get_funnel (steps=“player.spawn,player.death”)
「プラットフォーム別のイベント数を教えて」get_insights (metric=count, group_by=platform)
「マップ上の FPS ヒートマップを表示して」get_heatmap (map_id=…)
「直近のアラート履歴を確認して」get_alert_history

次のステップ

Section titled “次のステップ”