Claude Code에서 Google Analytics MCP 연동하기

들어가며

Claude Code를 사용하다 보면 외부 서비스와의 연동이 필요한 순간이 옵니다. 특히 웹사이트 분석 데이터를 AI와 함께 분석하고 싶다면, Google Analytics MCP 서버를 연동하는 것이 좋은 선택입니다.

이 글에서는 제가 직접 Google Analytics MCP를 Claude Code에 설정한 과정과 그 장점을 공유합니다.

MCP(Model Context Protocol)란?

MCP는 Anthropic에서 개발한 프로토콜로, AI 모델이 외부 도구나 데이터 소스에 안전하게 접근할 수 있게 해줍니다. Claude Code에서 MCP 서버를 연동하면 터미널에서 자연어로 다양한 작업을 수행할 수 있습니다.

설정 과정

1단계: Google Cloud 프로젝트 설정

먼저 Google Cloud Console에서 다음 API를 활성화해야 합니다:

• Google Analytics Admin API
• Google Analytics Data API

2단계: 인증 설정

gcloud CLI를 사용해 Application Default Credentials(ADC)를 설정합니다:

gcloud auth application-default login --scopes=https://www.googleapis.com/auth/analytics.readonly

이 명령어는 ~/.config/gcloud/application_default_credentials.json 파일을 생성합니다.

3단계: analytics-mcp 패키지 설치

Google에서 제공하는 공식 MCP 서버 패키지를 사용합니다:

pipx install analytics-mcp

또는 pipx run으로 직접 실행할 수도 있습니다.

4단계: Claude Code 설정

~/.claude.json 파일의 mcpServers 섹션에 다음을 추가합니다:

{"mcpServers": {"google-analytics": {"type": "stdio","command": "pipx","args": ["run", "analytics-mcp"],"env": {"GOOGLE_APPLICATION_CREDENTIALS": "/Users/[사용자명]/.config/gcloud/application_default_credentials.json","GOOGLE_PROJECT_ID": "[프로젝트-ID]"}}}}

사용 가능한 기능

설정이 완료되면 Claude Code에서 다음과 같은 작업을 할 수 있습니다:

계정 정보 조회

• GA4 속성 목록 확인
• 계정 요약 정보 조회
• Google Ads 연결 상태 확인

리포트 실행

• 맞춤 리포트 생성 및 분석
• 실시간 사용자 데이터 조회
• 커스텀 디멘션/메트릭 활용

장점

1. 자연어로 데이터 분석

복잡한 GA4 인터페이스를 배울 필요 없이, "지난 7일간 인기 페이지 알려줘"처럼 자연어로 질문할 수 있습니다.

2. 개발 워크플로우 통합

코드 작업 중 터미널을 벗어나지 않고 트래픽 데이터를 확인할 수 있습니다. 새 기능 배포 후 실시간 반응을 즉시 모니터링하거나, A/B 테스트 결과를 분석하는 것이 훨씬 간편해집니다.

3. 데이터 기반 의사결정

AI가 데이터를 해석해주므로, 단순 수치가 아닌 인사이트를 얻을 수 있습니다. "이탈률이 높은 페이지를 분석해줘"라고 요청하면 문제점과 개선 방안까지 제안받을 수 있습니다.

4. 보안

OAuth 기반 인증을 사용하므로 API 키를 직접 노출하지 않습니다. ADC(Application Default Credentials)를 통해 안전하게 인증이 처리됩니다.

실제 사용 예시

다음은 제가 실제로 활용하는 방식입니다:

// Claude Code에서"이번 주 블로그 방문자 추이를 분석해줘""가장 많이 읽힌 글 TOP 5 알려줘""모바일과 데스크톱 사용자 비율은?"

이런 질문들에 Claude가 MCP를 통해 GA4 데이터를 조회하고 분석 결과를 알려줍니다.

마치며

Google Analytics MCP 연동은 생각보다 간단하면서도 강력한 기능을 제공합니다. 특히 개발자가 터미널 환경에서 작업하면서 동시에 분석 데이터를 활용할 수 있다는 점이 큰 장점입니다.

MCP 생태계는 계속 성장하고 있어서, 앞으로 더 많은 서비스와의 연동이 가능해질 것입니다. Claude Code를 사용하신다면 MCP 연동을 적극 활용해보시길 추천합니다.