GA4 MCP 연결 방법: 클로드에서 구글 애널리틱스 숫자 보기
GA4 MCP 는 구글 애널리틱스 팀이 공개한 "Google Analytics MCP Server" 입니다. 클로드 데스크톱 앱이나 클로드 코드에 붙이면 "어제 사용자가 몇 명이었나" 같은 질문에 클로드가 GA4 보고서를 직접 읽어 답합니다. 내 컴퓨터에서 도는 읽기 전용 서버이고, 2026년 7월 29일에 나온 0.7.0 버전이 도구 아홉 개를 담고 있습니다. 연결하려면 구글 클라우드에서 API 두 개를 켜고 인증 파일을 하나 만들어야 하지만, 코드는 한 줄도 쓰지 않습니다. 이 글은 2026년 10월 22일에 구글 개발자 문서(10월 21일 갱신)와 공식 저장소를 읽고 확인한 내용만 적었습니다.
20초 영상으로 보기
두 영상이 이 글의 요약입니다. 첫 영상은 질문 하나가 GA4 숫자로 돌아오는 길이고, 둘째 영상은 연결 세 단계입니다. 명령은 구글 개발자 문서에 적힌 그대로 옮겼습니다.
영상 1 자막 전문
- 지난 90일 동안 가장 많이 일어난 이벤트를 표로 보여 줘 (나 → AI)
- 궁금한 숫자를 문장으로 묻습니다
- 클로드가 GA4 MCP 의 도구를 고릅니다
- MCP 가 내 인증 파일로 GA4 API 를 부릅니다
- 보고서 숫자가 돌아옵니다. 설정은 바꾸지 못합니다
- 클로드가 숫자를 읽고 요약·표·제안을 만듭니다
- 코드는 없어도 API 설정은 필요합니다. 공식 저장소 github.com/googleanalytics/google-analytics-mcp
영상 2 자막 전문
- 구글 클라우드에서 API 두 개를 켭니다. 명령: gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com (Admin API · Data API · 속성에 뷰어 권한)
- 읽기 전용 인증 파일을 만듭니다. analytics.readonly 범위로 로그인하면 파일 경로가 나옵니다 명령: gcloud auth application-default login (Credentials saved to file · 경로 복사)
- 클로드에 서버를 등록합니다. 환경변수 두 개를 함께 넣습니다 명령: claude mcp add analytics-mcp -- pipx run analytics-mcp (GOOGLE_APPLICATION_CREDENTIALS · GOOGLE_CLOUD_PROJECT)
- 필요한 것: 구글 클라우드 프로젝트무료 표준 GA4 속성도 됨. 안 되는 것: 챗GPT 에 바로 연결GA 설정 바꾸기. 내 컴퓨터에서 도는 서버라 챗GPT 는 터널이 필요합니다
한 장으로 보는 GA4 MCP
GA4 MCP 서버는 구글 애널리틱스 팀이 공개한 프로그램이고, 내 컴퓨터에서 클로드와 GA4 API 사이를 잇습니다. 클로드가 묻고, 서버가 내 인증 파일로 API 를 부르고, 숫자가 돌아옵니다.
데스크톱 앱 또는 클로드 코드
pipx run analytics-mcp
analytics.readonly 범위
Admin API · Data API
출처: developers.google.com/analytics/devguides/MCP (2026-10-21 갱신), github.com/googleanalytics/google-analytics-mcp
준비물 세 가지
| 준비물 | 무엇을 하나 | 확인하는 법 |
|---|---|---|
| Python 3.10 이상과 pipx | 서버 프로그램 analytics-mcp 를 내려받아 실행합니다. uv(uvx)도 됩니다 | python3 --version, pipx --version |
| 구글 클라우드 프로젝트 | Google Analytics Admin API 와 Data API 를 켭니다. 할당량을 이 프로젝트로 셉니다 | 구글 클라우드 콘솔의 프로젝트 ID |
| GA4 속성 권한 | 로그인할 구글 계정에 대상 속성의 뷰어(Viewer) 이상 권한이 있어야 합니다 | GA4 관리 → 속성 액세스 관리 |
연결하는 법: 4단계
1. API 두 개를 켭니다. 구글 클라우드 SDK(gcloud)를 설치한 뒤 아래 명령을 실행합니다. YOUR_PROJECT_ID 는 내 프로젝트 ID 로 바꿉니다. 콘솔 화면의 "API 및 서비스" 에서 두 API 를 검색해 켜도 같습니다.
2. 읽기 전용 인증 파일을 만듭니다. 아래 명령을 실행하면 브라우저가 열리고, 구글 계정으로 로그인하면 끝에 Credentials saved to file: [경로] 가 뜹니다. 이 경로를 복사해 둡니다. 구글 공식 설치 영상은 OAuth 클라이언트를 "Desktop App" 으로 만들어 내려받은 JSON 을 --client-id-file= 로 덧붙이는 방법도 보여 줍니다.
3-A. 클로드 데스크톱 앱에 등록합니다. 설정 파일은 macOS 는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows 는 %APPDATA%\Claude\claude_desktop_config.json 입니다. 아래 내용을 넣고 두 값을 바꾼 뒤 앱을 완전히 껐다 켭니다.
3-B. 클로드 코드에 등록합니다. 터미널에서 한 번 실행하면 모든 폴더에서 씁니다.
4. 확인합니다. 클로드에게 "what can the analytics-mcp server do?" 라고 물으면 도구 목록이 나옵니다. 저장소 README 의 예시에는 프로젝트 ID 변수가 GOOGLE_PROJECT_ID 로 적혀 있지만, 개발자 문서와 문제 해결 절은 GOOGLE_CLOUD_PROJECT 를 씁니다. 이 글도 개발자 문서를 따랐습니다.
도구 9개 지도: 무엇을 물을 수 있나
구글 개발자 문서에 적힌 0.7.0 버전의 도구 아홉 개입니다. 모두 읽기 전용이고, 클로드가 질문에 맞는 도구를 스스로 고릅니다.
내가 볼 수 있는 계정과 속성 목록
처음 한 번속성 하나의 설정 정보
속성에 연결된 Google Ads 계정
속성에 남긴 주석
맞춤 측정기준·측정항목
일반 보고서. 기본 1만 행, 최대 25만 행
가장 많이 씀지금 들어와 있는 사용자
유입경로 탐색 보고서
전환 성과 보고서. README 목록에는 빠져 있음
출처: developers.google.com/analytics/devguides/MCP (2026-10-21), run_report 도구 문서
이렇게 물어보십시오: 공식 예시 프롬프트
구글 개발자 문서에 실린 예시를 우리말로 옮겼습니다. 속성이 여러 개라면 질문 앞에 속성 이름을 붙이면 클로드가 헷갈리지 않습니다.
숫자로 보는 GA4 MCP
출처: GA4 Data API 할당량 문서, GA 고객센터 11198161 데이터 처리 시간, PyPI analytics-mcp (2026-10-22 조회)
자주 나는 오류와 해결
| 오류 문구 | 원인 | 해결 |
|---|---|---|
403 PERMISSION_DENIED | API 두 개가 그 프로젝트에서 꺼져 있거나, 계정에 속성 권한이 없음 | 두 API 를 켜고, GA4 에서 뷰어 이상 권한을 줍니다. "insufficient authentication scopes" 가 함께 나오면 2단계 명령으로 다시 로그인합니다 |
requires a quota project, 403 ACCESS_NOT_CONFIGURED | 할당량을 셀 프로젝트가 지정되지 않음 | GOOGLE_CLOUD_PROJECT 를 넣거나 gcloud auth application-default set-quota-project YOUR_PROJECT_ID 실행 |
401 UNAUTHENTICATED | 인증 파일 경로를 못 찾았거나 로그인이 만료됨 | 경로를 절대 경로로 적습니다. ~ 와 $HOME 은 풀리지 않습니다. 만료됐다면 다시 로그인합니다 |
spawn pipx ENOENT, uvx: command not found | 데스크톱 앱이 터미널의 PATH 를 물려받지 못함 | which pipx 로 찾은 전체 경로를 command 에 적습니다 |
429 RESOURCE_EXHAUSTED | 속성의 하루·시간당 토큰 한도를 넘김 | 태평양 표준시 자정에 다시 찹니다. 기간을 줄이거나 측정기준 수를 줄여 묻습니다 |
MCP 연결 자체가 안 되는 경우(도구가 아예 안 보이는 경우)는 클로드 MCP 연결 오류 해결에 오류 문구별로 정리해 두었습니다.
되는 일과 안 되는 일
- 어제 사용자 수, 인기 상품, 인기 이벤트 같은 보고서 질문
- 지금 사이트에 있는 사용자 (실시간 보고서)
- 유입경로·전환 보고서
- 맞춤 측정기준과 Google Ads 연결 확인
- 숫자를 근거로 마케팅 계획 세우기
- 속성·설정 만들기·고치기·지우기 (0.7.0 기준 읽기 전용)
- 챗GPT 에 바로 연결 (로컬 서버라 Secure MCP Tunnel 필요)
- Data API 할당량 늘리기 (구글이 받지 않음)
- 최근 24~48시간 숫자를 확정값으로 보기
출처: developers.google.com/analytics/devguides/MCP, help.openai.com 12584461, GA4 Data API 할당량 블로그
다른 방법: 챗GPT, 서드파티 커넥터, 구글 원격 서버
챗GPT 는 원격 MCP 서버만 붙입니다. OpenAI 도움말은 "Can I connect to a local MCP server?" 라는 질문에 "Not directly." 라고 답하고 Secure MCP Tunnel 을 대안으로 듭니다. 내 컴퓨터에서 도는 GA4 MCP 는 챗GPT 에 바로 연결되지 않습니다.
서드파티 커넥터 는 설치 없이 URL 하나로 붙습니다. 클로드 커넥터 목록에는 Supermetrics, Windsor.ai, Funnel 이 GA 를 포함한 커넥터로 올라 있고, 구글이 직접 낸 GA 커넥터는 찾지 못했습니다. 이런 서비스는 GA 데이터를 자기 서버로 거쳐 보내므로, 가입 전에 데이터를 어디에 저장하는지 약관에서 확인합니다.
구글 원격 엔드포인트 도 있습니다. 구글 개발자 사이트에 https://analyticsdata.googleapis.com/mcp/v1 의 참조 문서(도구 run_report, get_metadata, run_realtime_report, check_compatibility)가 올라와 있습니다. 다만 구글 클라우드의 원격 MCP 지원 제품 목록(10월 20일 갱신)에는 아직 없고 설정 안내도 없어, 참조 문서만 공개된 상태로 보입니다.
자주 묻는 질문
analytics.readonly 범위의 인증 파일을 만들어야 합니다. 코드는 쓰지 않습니다. MCP 서버가 API 를 대신 부릅니다.429 오류가 납니다.--allow-write 옵션이 들어갔지만, 기본으로 꺼져 있고 아직 정식 버전에 실리지 않았습니다.~/.gemini/config/mcp_config.json 이고 내용은 위 3-A 와 같습니다.출처
- 구글: Google Analytics MCP 개발자 문서 (2026-10-21 갱신), 공식 저장소, PyPI analytics-mcp, 공식 설치 영상
- 한도·데이터: Data API 할당량, run_report 도구, GA4 데이터 처리 시간
- 원격·대안: analyticsdata MCP 참조, 구글 클라우드 원격 MCP 지원 제품, 챗GPT 개발자 모드와 MCP
- 질문: 인프런 질문 "GA4 등의 MCP 를 연결하려면 API 연결이 필수인지"