LeanUP - GA4 Analytics MCP Server

Claude Code에서 GA4 데이터를 자연어로 분석할 수 있는 MCP 서버입니다.

빠른 시작

npx leanup setup

대화형 마법사가 다음을 안내합니다:

1. Google Cloud Console에서 OAuth 자격증명 생성
2. GA4 Data API 활성화
3. GA4 Property ID 입력
4. Google OAuth 로그인
5. Claude Desktop MCP 설정 자동 추가

완료 후 Claude Desktop을 재시작하면 바로 사용할 수 있습니다.

사용 예시

"지난 7일 세션 수 알려줘"
"이번 달 유입 소스별 트래픽 분석해줘"
"페이지별 조회수 top 20"

CLI 명령어

npx leanup setup   # GA4 연결 설정 (대화형)
npx leanup status  # 연결 상태 확인
npx leanup serve   # MCP 서버 시작

MCP Tools

ga4_query

GA4 데이터 조회

{
  "metrics": ["sessions", "activeUsers"],
  "dimensions": ["sessionSource"],
  "startDate": "7daysAgo",
  "endDate": "today"
}

ga4_metadata

사용 가능한 metrics/dimensions 조회

ga4_status

GA4 연결 상태 확인

지원 Metrics

| Metric | 설명 | |--------|------| | sessions | 세션 수 | | activeUsers | 활성 사용자 | | newUsers | 신규 사용자 | | screenPageViews | 페이지 조회수 | | bounceRate | 이탈률 | | conversions | 전환 수 | | totalRevenue | 총 매출 |

지원 Dimensions

| Dimension | 설명 | |-----------|------| | date | 날짜 | | sessionSource | 유입 소스 | | sessionMedium | 유입 매체 | | country | 국가 | | deviceCategory | 기기 유형 | | pagePath | 페이지 경로 |

요구사항

• Node.js 18+
• Google Cloud Console 프로젝트
• GA4 Property 접근 권한

License

MIT