Claude Code Plugin

Claude Code 向け Framedash プラグインは、Claude Code からゲームテレメトリを照会するために必要なものを 1 つにまとめています。Framedash MCP Server、スキル群（CLI 利用パターン、events スキーマに対する SQL クエリクックブック、perf-diff CI レシピ、Unity/UE5/Godot の統合ガイド）、そしてガイド付き設定用の /framedash:setup コマンドが含まれます。

インストール

マーケットプレイスを追加してからプラグインをインストールします:

claude plugin marketplace add crane-valley/framedash-claude-plugin
claude plugin install framedash@framedash

すでに古いバージョンをインストールしている場合、上記のコマンドはどちらも「インストール済み」と報告して終了し、更新はされません。 最新版に上げるには update を実行してください（反映には Claude Code の再起動が必要です）:

claude plugin update framedash@framedash

インストール済みのバージョンは list で確認できます:

claude plugin list

設定

API キーはダッシュボードの各プロジェクトの「API キー」ページで作成できます（API 概要を参照）。 Claude Code を起動する前に、シェルで API キーを設定してください。キーをチャットに貼り付けないでください。

export FRAMEDASH_API_KEY="fd_xxx"
export FRAMEDASH_PROJECT_ID="your-project-uuid"  # 任意

Windows PowerShell の場合:

$env:FRAMEDASH_API_KEY="fd_xxx"
$env:FRAMEDASH_PROJECT_ID="your-project-uuid"  # 任意

その後、Claude Code 内でガイド付きセットアップコマンドを実行します:

/framedash:setup

設定できたか確認するには、/framedash:setup を実行するか、読み取り系ツールを呼び出して（例:「過去 7 日間の DAU を見せて」）データが返ることを確かめてください。

環境変数

変数	必須	説明
FRAMEDASH_API_KEY	はい	使用するツールに必要な scope を持つ API キー（下記の scope 一覧を参照）。
FRAMEDASH_PROJECT_ID	いいえ	デフォルトプロジェクト UUID。
FRAMEDASH_BASE_URL	いいえ	API ベース URL（デフォルト: https://app.framedash.dev）。

API キーの scope

scope	付与される権限
analytics:read	読み取りツール（ダッシュボード、リテンション、ファネル、インサイト、ヒートマップ、一覧）。
data:admin	analytics:read に加えて raw SQL の query ツール。
resources:write	アラートの作成・更新・削除、マップの削除、コンテンツのインポート。

含まれるもの

• MCP Server — Framedash MCP Server の宣言（stdio、npx -y @framedash/mcp-server）。
• スキル — CLI 利用パターン、events スキーマに対する SQL クエリクックブック、perf-diff CI レシピ、Unity/UE5/Godot の統合ガイド。
• コマンド — ガイド付き設定用の /framedash:setup。

プラグインを使わない場合（raw MCP）

MCP ツールのみが必要な場合は、サーバーを直接登録します:

claude mcp add framedash \
  -e FRAMEDASH_API_KEY=fd_xxx \
  -e FRAMEDASH_PROJECT_ID=your-project-uuid \
  -- npx -y @framedash/mcp-server

Windows PowerShell では、ストレートクォートを使い、行末のバックスラッシュを付けずに 1 行で書きます:

claude mcp add framedash -e FRAMEDASH_API_KEY=fd_xxx -e FRAMEDASH_PROJECT_ID=your-project-uuid -- npx -y @framedash/mcp-server

ツールとリソースの完全なリファレンスは MCP Server を参照してください。

その他のコーディングエージェント

スキルはオープンな Agent Skills 仕様（SKILL.md）に準拠しているため、スキルを扱うあらゆるエージェントで動作します。また MCP Server の宣言はあらゆる MCP クライアントで利用できます。Claude Code 以外（例: Codex CLI）で同じ機能を使うには、エージェントにプラグインの SKILL.md ファイルまたは @framedash/mcp-server パッケージを指定してください。

行数の上限

MCP の query ツールは結果を 1000 行に制限します。より大きな結果セットが必要な場合は、10000 行まで対応する REST の /v1/query エンドポイントを使用してください。

次のステップ

• MCP Server: ツールとリソースの完全なリファレンス。
• CLI リファレンス: コマンドラインツール。

リポジトリ: crane-valley/framedash-claude-plugin（v0.2.3、MIT）。