구글 애널리틱스 MCP 연결: 준비물과 인증 오류 해결

먼저 데이터를 읽을 Google 계정과 GA4 속성을 확인해요. 공식 서버는 Analytics Admin API로 계정·속성 정보를, Data API로 보고서를 조회해요. 웹사이트의 G-로 시작하는 측정 ID와 보고서 조회에 쓰는 숫자 속성 ID는 달라요.

서버를 실행할 Python 환경과 Google Cloud 프로젝트를 준비하고 두 API가 활성화됐는지 확인해요. 회사 계정이라면 담당자에게 기존 프로젝트와 인증 방식을 먼저 물어보세요. 프로젝트를 새로 만드는 일이 꼭 필요한 것은 아니에요.

인증에는 Application Default Credentials(ADC)를 사용해요. Analytics 읽기에 필요한 범위는 https://www.googleapis.com/auth/analytics.readonly예요. 인증 파일은 컴퓨터에 보관하고 설정에는 그 경로를 적어 주세요.

Google 공식 안내는 OAuth 클라이언트 파일 또는 서비스 계정 가장을 이용하는 인증 예시를 제공해요. gcloud 기본 로그인은 추가 Cloud 권한을 요구할 수 있으므로, 회사에서 허용한 클라이언트와 범위를 확인한 뒤 진행해요. Analytics 권한과 Cloud 프로젝트 권한은 별개예요.

pipx를 사용할 수 있다면 터미널에 codex mcp add google-analytics --env GOOGLE_APPLICATION_CREDENTIALS=/실제/인증파일.json -- pipx run analytics-mcp를 입력해 등록할 수 있어요. /실제/인증파일.json은 준비한 ADC 파일의 경로로 바꿔 주세요.

Codex MCP 설정은 사용자 config.toml 또는 신뢰하는 프로젝트의 .codex/config.toml에 저장할 수 있어요. 등록 뒤 MCP 목록을 확인하고 클라이언트에서 서버를 다시 시작해요. command not found가 나오면 서버 문제가 아니라 pipx 등 실행 프로그램을 찾지 못한 상태일 수 있어요.

도구 목록이 응답하면 get_account_summaries로 계정과 속성을 조회해요. 내 웹사이트의 속성이 맞는지 확인한 뒤 짧은 기간의 보고서를 요청해 보세요. 이 과정에서 서버 시작과 데이터 접근을 각각 확인할 수 있어요.

첫 요청은 작게 잡아 보세요. ‘대상 속성의 어제 세션 수를 조회하고 속성 ID, 날짜 범위, 시간대를 함께 보여 줘’처럼 요청하면 화면과 대조하기 쉬워요. 여러 회사의 속성이 보이면 이름이 비슷하다는 이유로 자동 선택하지 말고 웹사이트와 속성 세부 정보를 확인해요.

Reauthentication is needed가 나오면 저장된 인증을 갱신해 주세요. 권한 오류는 메시지에 따라 OAuth 범위, API 활성화, GA4 속성 권한을 확인해요. 같은 서버를 다시 설치하기 전에 어느 단계에서 실패했는지 살펴보면 좋아요.

응답은 성공했는데 행이 없다면 날짜 범위와 속성, 필터부터 줄여 보세요. 전체 사이트 보고서에는 행이 있고 /guide 필터에서만 비었다면 URL 조건을 확인할 차례예요. 빈 결과를 방문자 0명으로 단정하지 말고 조회 조건과 실제 0을 구분해서 기록해요.

첫 SEO 요청은 이렇게 해 보세요. ‘완료된 최근 28일과 직전 28일을 비교해 줘. /guide로 시작하는 랜딩 페이지의 Organic Search 세션을 보여 주고, 숫자로 확인한 변화와 원인 추측을 나눠 적어 줘.’

검색어의 노출·클릭·순위는 Search Console에서 확인해요. Analytics MCP 연결만으로 Search Console 데이터까지 자동으로 생기지는 않아요. GA4에서는 방문 뒤 행동을 보고, 검색 결과에서 어떤 질문으로 들어왔는지는 별도 자료로 대조해요.