방문자 보고서,말로 물어볼까

중급자용© AIKOREACLUB

googleanalytics/google-analytics-mcp

방문자 보고서, 말로 물어볼까

구글 애널리틱스(GA4) 숫자를 클로드 코드나 제미나이 같은 AI 대화창에서 말로 물어 받아 보게 해 주는 연결 도구(MCP 서버)예요. 구글 애널리틱스 깃허브 조직이 공개했어요

★ 3,622MCP 서버 · Apache-2.0확인 2026-11-03

"지난달 사람들이 어디서 제일 많이 들어왔지?" 구글 애널리틱스를 열면 답은 어딘가에 있어요. 그런데 보고서 메뉴를 뒤지고, 기간을 맞추고, 측정기준과 측정항목을 고르다 보면 질문 하나에 한참 걸리죠.이 저장소는 AI 대화창과 구글 애널리틱스를 잇는 연결 도구예요. 질문을 말로 하면 AI가 보고서 요청을 대신 채워 GA4에서 숫자를 꺼내 와요. 구글 애널리틱스 깃허브 조직(googleanalytics)에 올라와 있고, 10월 22일에 0.8.0판이 나왔어요.

질문 한 줄이 보고서 요청이 되기까지

내가 쓰는 말

이 이름들을 외울 필요가 없어요. 기간, 무엇별로 나눌지, 무엇을 셀지를 AI가 골라 채우고, GA4가 돌려준 표를 읽어 우리말로 답해요.

README 예시 질문과 도구 설명에 있는 이름(run_report, eventName 등)으로 저희가 그린 예시예요. 실제로 어떤 값을 채울지는 AI와 속성 설정에 따라 달라져요.

한눈에

무엇인가요

AI와 GA4 사이의 통역사예요. MCP는 AI가 바깥 도구를 쓰게 해 주는 연결 규격이에요. 이 서버는 구글 애널리틱스 관리 API와 데이터 API를 도구로 바꿔 AI에게 쥐여 줘요.읽기 위주예요. 계정·속성 정보 보기, 연결된 구글 광고 계정 목록, 일반 보고서, 단계별 이탈을 보는 퍼널 보고서, 실시간 보고서, 맞춤 측정기준·측정항목 보기가 들어 있어요.쓰기는 일부러 켜야 해요. 속성에 메모(주석)를 남기는 도구 하나만 쓰기 기능인데, --allow-write 를 붙이고 편집 권한을 줘야만 켜져요.기본은 내 컴퓨터에서 돌아요. 내 컴퓨터에서 실행하는 로컬 서버가 기본이고, 여러 사람이 각자 구글 계정으로 로그인해 쓰는 웹 서버 방식도 README에 따로 있어요.

함께 쓰는 도구 · 제미나이 CLI · 제미나이 코드 어시스트 · 클로드 코드

이런 분께

매주 방문자·유입 경로 보고를 손으로 만드는 마케터나 사장님
GA4 메뉴가 복잡해서 원하는 숫자를 못 찾는 분
AI 대화창 하나에서 사이트 숫자를 묻고 정리까지 맡기고 싶은 분

어떻게 작동하나요

질문이 보고서 요청으로 바뀌어요. "지난 180일 동안 가장 많이 일어난 이벤트는?"이라고 물으면 AI가 run_report 도구에 기간, 측정기준(무엇별로 나눌지), 측정항목(무엇을 셀지), 정렬을 채워 보내요. GA4가 돌려준 표를 AI가 읽고 답해요.어느 속성인지도 말로 찾아요. README 예시처럼 "이름에 xyz가 들어간 속성"이라고 하면, 계정과 속성 목록을 불러오는 도구로 먼저 찾아볼 수 있어요.권한은 내 구글 계정 그대로예요. 내 계정이 볼 수 있는 속성만 보이고, 기본 권한은 읽기 전용(analytics.readonly)이에요.

할 수 있는 일

계정·속성 둘러보기get_account_summaries, get_property_details 로 내 GA 계정과 속성 정보

일반 보고서run_report 로 기간, 측정기준, 측정항목을 골라 표 받기

퍼널 보고서run_funnel_report 로 단계마다 얼마나 빠져나가는지

실시간 보고서run_realtime_report 로 지금 들어와 있는 사용자

맞춤 항목 확인get_custom_dimensions_and_metrics 로 우리 속성에만 있는 항목

광고 연결과 메모list_google_ads_links, list_property_annotations. --allow-write 일 때만 create_property_annotation

바로 쓸 수 있나요

도구 연결 필요

필요한 것구글 클라우드 프로젝트, GA4 속성을 볼 수 있는 구글 계정, pipx(파이썬 3.10 이상), gcloud 명령 도구, 그리고 MCP를 쓰는 AI(제미나이 CLI, 클로드 코드 등)

비용저장소는 무료(Apache-2.0). 쓰는 AI 도구 요금은 따로예요. GA 데이터 API에는 속성마다 사용 할당량이 있어요

시작하기

pipx 설치
파이썬 도구를 따로 설치해 실행해 주는 pipx를 먼저 깔아요. 파이썬 3.10 이상이 필요해요.
API 두 개 켜기
구글 클라우드 프로젝트에서 Google Analytics Admin API와 Google Analytics Data API를 사용 설정해요.
내 계정 로그인 정보 만들기
OAuth 데스크톱 클라이언트 JSON을 받아 둔 뒤 실행해요. 끝나면 화면에 나오는 Credentials saved to file 뒤의 경로를 적어 두세요.
```
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE
```
클로드 코드에 연결
PATH_TO_CREDENTIALS_JSON 은 앞 단계의 경로로, YOUR_PROJECT_ID 는 구글 클라우드 프로젝트 ID로 바꿔요. 제미나이 CLI는 ~/.gemini/settings.json 의 mcpServers 에 같은 내용을 넣어요.
```
claude mcp add analytics-mcp \
  --scope user \
  -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \
  -e "GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID" \
  -- pipx run analytics-mcp
```
연결 확인
제미나이에서는 /mcp 를 입력해 analytics-mcp 가 보이는지 봐요. 그다음 이 서버가 무엇을 할 수 있는지 물어요.
```
what can the analytics-mcp server do?
```

처음 해 볼 한마디

지난 180일 동안 내 구글 애널리틱스 속성에서 가장 많이 일어난 이벤트는 뭐야?

README 예시(what are the most popular events in my Google Analytics property in the last 180 days?)를 우리말로 옮겼어요. 우리말 질문이 되는지는 README에 따로 적혀 있지 않아요.

대화창에서 이렇게 물어봐요

AI 대화창 · analytics-mcp 연결됨읽기 전용

README의 도구 목록과 예시 질문으로 저희가 그린 예시예요. 숫자는 지어낸 것이고, 실제 답과 표는 내 속성 데이터와 AI에 따라 달라져요.

비슷한 도구

이 서버는 우리 사이트에 들어온 사람의 숫자를 묻는 쪽이에요. 아래 둘은 광고 계정과 남의 SNS를 살피는 쪽이에요.

광고비, 어디서 새고 있을까사이트 방문이 아니라 광고 계정 자료를 읽고 점검표로 보고AgriciDaniel/claude-ads

경쟁사 그 영상, 왜 잘 됐을까내 데이터 대신 남의 공개 게시물과 댓글을 분석ScrapeCreators/social-media-research-skills

주의할 점

README 제목에 실험판(Experimental)이라고 적혀 있고, 판 번호도 아직 1.0 전(0.8.0)이에요. 도구 이름이나 설정 방법이 바뀔 수 있어요.
--allow-write 를 붙이면 AI가 속성에 메모를 만들 수 있어요. 필요할 때만 켜고, 그때만 편집 권한(analytics.edit)을 주세요.
로그인 정보 파일(JSON)은 내 GA 데이터를 여는 열쇠예요. 공유 폴더나 깃 저장소에 두지 마세요.
AI가 측정기준을 잘못 골라 엉뚱한 표를 읽을 수도 있어요. 보고서에 쓸 숫자는 GA4 화면과 한 번 맞춰 보세요.
여러 사람이 쓰는 웹 서버 방식에서 --oauth 를 쓰면 로그인 정보가 서버 메모리에만 있어서, 서버를 다시 켜면 모두 다시 로그인해야 한다고 README가 알려요.

낯선 말

MCP · AI가 바깥 프로그램이나 데이터를 도구처럼 쓰게 해 주는 연결 규격
속성 · GA4에서 사이트나 앱 하나의 데이터를 모아 두는 단위
측정기준 · 무엇별로 나눌지(나라별, 유입 경로별, 이벤트 이름별)
측정항목 · 무엇을 셀지(사용자 수, 이벤트 수, 매출)
퍼널 · 방문, 장바구니, 결제처럼 단계마다 얼마나 남고 빠지는지 보는 보고서
ADC · 구글 도구들이 같이 쓰는 내 컴퓨터의 기본 로그인 정보

AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.