Claude Code、Codex、任意の MCP クライアントを 5 分でセットアップする

AI コーディングエージェントに Framedash のテレメトリーを読ませ、CI をゲートさせる最短の方法です。 エージェントに合わせて経路を選んでください。 Claude Code プラグイン、任意の MCP クライアント向けの素の MCP 登録、リポジトリを認識するエージェント向けの AGENTS.md スニペットの 3 つです。 いずれも同じ @framedash/mcp-server パッケージと FRAMEDASH_API_KEY を使います。

はじめる前に

ダッシュボードで API キーを作成し、シェルでエクスポートします。 キーをチャットに貼り付けないでください。

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

分析ツールには Read-only キーを、raw SQL の query ツールも使うなら Full キーを使ってください。

経路 A：Claude Code プラグイン

このプラグインには、MCP サーバー、CLI と SQL クエリパターンのスキル、Unity、UE5、Godot の統合ガイド、/framedash:setup コマンドが含まれます。 マーケットプレイスを追加してインストールします。

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

その後、Claude Code 内で /framedash:setup を実行するとガイド付きで設定できます。 全内容は Claude Code プラグインガイドを参照してください。

経路 B：素の MCP サーバー（任意のクライアント）

MCP ツールだけが必要なら、stdio サーバーを直接登録します。 Claude Code の場合:

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

他の MCP クライアントも、それぞれの設定で同じ npx -y @framedash/mcp-server コマンドを受け付けます。 Codex CLI は codex mcp add または config.toml で登録します。 詳細は Codex CLI を参照してください。 サーバーは 12 個の読み取り専用ツール（ダッシュボード、リテンション、ファネル、インサイト、ヒートマップ、プロジェクトとアラートの一覧、Full キーでの raw SQL）と 4 個のリソースを提供します。 全一覧は MCP サーバーリファレンスにあります。

リモート MCP サーバーと OAuth に対応したクライアントは、ローカルインストールを省き、ホスト型エンドポイント https://app.framedash.dev/api/mcp を使えます。

経路 C：AGENTS.md スニペット

リポジトリを認識するエージェントには、Framedash のブロックを AGENTS.md（Codex など）または CLAUDE.md（Claude Code）に貼り付けます。 ドキュメント、CLI、MCP サーバー、環境変数を一箇所でエージェントに示せます。 AGENTS.md スニペットからコピーしてください。

エージェントから CI をゲートする

同じキーで CLI も動くため、エージェントはパフォーマンスゲートを組めます。 @framedash/cli をインストールし、候補がしきい値を超えて悪化したときにビルドを失敗させます。

npm install -g @framedash/cli

framedash perf-diff --baseline "$BASE_SHA" --candidate "$GITHUB_SHA" \
  --threshold 5 --fail-on-regression

エンドツーエンドのプロファイリングゲートは、CI 統合プロファイリングを参照してください。

次のステップ

• MCP サーバーリファレンス：全ツール、リソース、ホスト型エンドポイント
• Claude Code プラグイン：スキル、スコープ、セットアップ
• CLI リファレンス：CI とローカルクエリ用のコマンド