구글 애널리틱스팀의 공식 MCP 서버는 2025년 7월 30일에 알려져 첫 배포가 2025년 8월 22일이라 나온 지 1년이 넘었는데, 저장소 제목에는 아직 '실험'이 붙어 있고 공식 안내 문서는 2025년 9월 16일 이후로 갱신되지 않아 실제 코드가 내놓는 도구 9개 중 7개만 적혀 있어요. 공식 문서도 '읽기 요청만 되고 애널리틱스 설정은 못 고친다'고 못 박아 뒀고, 실제로 계정 요약·속성 상세·보고서·퍼널 보고서·실시간 보고서처럼 읽기만 하는 도구뿐이에요. 정작 설치 안내가 시키는 로그인 명령은 애널리틱스 읽기 권한과 함께 '구글 클라우드 데이터를 보고 고치고 설정하고 지운다'는 cloud-platform 권한까지 받아 자격 증명 파일에 담는데, 클로드 코드 설정은 그 파일 경로를 환경변수로 그대로 넘기라고 안내하면서 왜 그 권한까지 필요한지는 적어 두지 않았어요.
용어 풀이
- MCP
- 에이전트를 외부 도구·데이터에 잇는 연결 규격(Model Context Protocol)
- cloud-platform
- 구글 클라우드 접근 권한 중 가장 넓은 것. 클라우드 데이터를 보고 고치고 설정하고 지우는 것까지 한꺼번에 허용함
- 서비스 계정 가장
- 사람 계정 대신 프로그램용 계정의 권한을 빌려 쓰는 방식(impersonation). 그 계정에 준 권한만큼만 움직임
- GRPC_DNS_RESOLVER
- gRPC 통신 라이브러리가 주소 이름을 IP로 바꿀 때 어떤 방식을 쓸지 정하는 환경변수. native 로 두면 운영체제 기본 방식을 씀
운영자 인사이트
애널리틱스 수치를 에이전트에 물어보려 붙일 때 실제로 넘어가는 건 읽기 전용 도구들이 아니라 cloud-platform 권한이 담긴 자격 증명 파일이라, 그 기계에서 도는 다른 코드도 같은 파일을 읽을 수 있어요. 내 계정으로 로그인하는 대신 README가 함께 안내하는 서비스 계정 가장 경로를 쓰면 그 권한이 최소 권한만 준 서비스 계정 몫이 돼 범위를 좁힐 수 있고, 클로드 코드에 붙였는데 주소 이름 풀이가 안 되면 GRPC_DNS_RESOLVER=native 를 함께 넘겨 보세요.
여러 관점으로 보기
- 공식 문서 — 읽기 전용이라고 못 박은 자리 '이 MCP 서버는 읽기 요청만 되고 애널리틱스 구성이나 설정은 고칠 수 없다'고 적어 뒀는데, 정작 페이지 아래 갱신 시각은 2025년 9월 16일에 멈춰 있어요. Google for Developers
- 처음 알려진 시점 2025년 7월 30일 구글 애널리틱스 API 공지 그룹에 조시 래드클리프가 애널리틱스팀을 대신해 '데이터를 LLM에 잇는 MCP 서버'라고 올린 게 시작이에요. Google Groups (google-analytics-api-notify)
- 함께 받아 가는 권한이 실제로 무엇인가 구글 공식 권한 목록은 cloud-platform 을 '구글 클라우드 데이터를 보고, 고치고, 설정하고, 지운다'로 적어 뒀어요 — 애널리틱스 읽기 권한은 '보고 내려받는다'까지예요. Google Identity 문서
- 클로드 코드에서 아직 안 닫힌 신고 클로드 코드가 이 서버를 하위 프로세스로 띄우면 analyticsadmin.googleapis.com 주소를 못 찾는다는 신고가 6월 12일·13일에 두 건 올라왔는데, 댓글 0개로 아직 열려 있어요. GitHub
- 읽기 전용이라는 표식은 아직 코드에 없어요 도구 9개에 readOnlyHint 를 붙여 클라이언트가 안전한 도구임을 알아보게 하자는 제안이 8월 7일 올라왔지만 아직 병합되지 않아, 지금은 붙이는 쪽이 매번 확인을 받아야 해요. GitHub