Claude Code Plugin

Claude Code용 Framedash 플러그인은 Claude Code에서 게임 텔레메트리를 조회하는 데 필요한 모든 것을 하나로 묶어 제공합니다. 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에서는 곧은 따옴표를 쓰고 줄 끝 백슬래시 없이 한 줄로 작성하세요:

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 Server: 도구와 리소스의 전체 레퍼런스.
CLI 레퍼런스: 명령줄 도구.

리포지토리: crane-valley/framedash-claude-plugin(v0.2.3, MIT).

AI 에이전트용: llms.txt