Claude Code로 Amplitude & GA4 MCP 연동하기 — 실전 가이드

1. Amplitude MCP 설치 및 사용

Amplitude MCP는 Claude Code에서 Amplitude 데이터를 직접 조회하고 분석할 수 있게 해주는 공식 MCP 서버입니다. 이벤트 분석, 퍼널, 리텐션, 코호트 분석을 자연어로 요청할 수 있습니다.

설치 방법

Claude Code 설정 파일(~/.claude/claude_desktop_config.json)에 아래 설정을 추가합니다.

{
  "mcpServers": {
    "amplitude": {
      "command": "npx",
      "args": ["-y", "@amplitude/mcp"],
      "env": {
        "AMPLITUDE_API_KEY": "your_api_key_here",
        "AMPLITUDE_SECRET_KEY": "your_secret_key_here"
      }
    }
  }
}

API 키 발급 방법

Amplitude 대시보드에서 Settings → Projects → 해당 프로젝트 → General 탭으로 이동합니다. API Key와 Secret Key를 복사합니다.

주요 활용 프롬프트 예시

실전 사용 팁

Amplitude MCP는 Chart API와 Dashboard API를 모두 지원합니다. 복잡한 쿼리를 자연어로 요청하면 Claude가 적절한 API를 선택해 데이터를 가져옵니다. 날짜 범위를 구체적으로 명시하고, 분석하려는 이벤트명을 Amplitude에서 확인한 정확한 이름으로 요청하면 더 정확한 결과를 얻을 수 있습니다.

2. GA4 리포트 자동화 MCP 설치 및 사용

GA4 MCP는 Google Analytics 4 데이터를 Claude Code에서 직접 조회할 수 있게 해줍니다. 트래픽 소스, 전환율, 캠페인 성과, 페이지별 행동 분석 등을 자연어로 요청할 수 있습니다.

설치 방법

먼저 패키지를 전역 설치합니다.

npm install -g @olaservo/ga4-mcp

설정 파일에 추가합니다.

{
  "mcpServers": {
    "ga4": {
      "command": "ga4-mcp",
      "env": {
        "GA4_PROPERTY_ID": "properties/123456789",
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Google OAuth2 인증 설정

Google Cloud Console에서 OAuth2 클라이언트를 발급합니다.

# 1. Google Cloud Console → APIs & Services → Credentials
# 2. Create Credentials → OAuth client ID → Desktop app
# 3. Google Analytics Data API 활성화

# Refresh Token 발급 (최초 1회)
npx @olaservo/ga4-mcp --auth

주요 활용 프롬프트 예시

3. 두 도구 함께 활용하기

Amplitude와 GA4는 서로 다른 강점을 가집니다. 함께 사용하면 마케팅 채널 유입부터 제품 내 행동까지 전체 고객 여정을 분석할 수 있습니다.

통합 분석 시나리오 예시

Claude Code에서 두 MCP를 함께 호출하여 통합 인사이트를 도출할 수 있습니다.

# 통합 분석 프롬프트 예시

"GA4에서 이번 주 메타 광고 캠페인으로 유입된 사용자 수를 확인하고,
Amplitude에서 해당 기간 신규 가입자의 7일 리텐션을 분석해서
광고 채널별 사용자 품질을 비교하는 리포트를 만들어줘"

주간 리포트 자동화

아래 프롬프트를 매주 월요일에 실행하면 자동으로 주간 리포트가 생성됩니다.

# 주간 마케팅 리포트 자동화 프롬프트

"GA4에서 지난주(월~일) 데이터를 기준으로:
1. 채널별 세션 수, 전환율, 수익
2. 전주 대비 증감률
3. 상위 5개 랜딩 페이지 성과

Amplitude에서 같은 기간:
1. 신규 가입자 수와 온보딩 퍼널 완료율
2. DAU/WAU 리텐션
3. 가장 많이 사용된 기능 TOP 5

위 내용을 바탕으로 주간 마케팅 리포트를 마크다운으로 작성해줘"

4. MCP 관리 명령어 모음

Claude Code에서 MCP 서버를 관리하는 유용한 명령어들입니다.

환경 변수 보안 관리

API 키는 설정 파일에 직접 입력하는 대신 시스템 환경 변수로 관리하는 것을 권장합니다.

# ~/.zshrc 또는 ~/.bashrc에 추가
export AMPLITUDE_API_KEY="your_api_key"
export AMPLITUDE_SECRET_KEY="your_secret_key"
export GA4_PROPERTY_ID="properties/123456789"

# 설정 파일에서 환경 변수 참조 (값 직접 입력 불필요)
{
  "mcpServers": {
    "amplitude": {
      "command": "npx",
      "args": ["-y", "@amplitude/mcp"]
    }
  }
}

트러블슈팅