리포팅을 AI에게 맡긴다

앞 편 개선 루프를 돌린다에서 루프가 멈추는 이유 중 하나로 "숫자를 보러 가는 것이 귀찮아진다"를 꼽았습니다. 이번 편은 그 귀찮음을 없앱니다. 숫자가 나에게 오게 만들고, 개발 기록도 AI가 남기게 합니다. 다음 편 접는 기술에서 접을지 고칠지 판단할 때 이 리포트와 기록이 근거가 됩니다.

핵심 요약

• GA4를 MCP로 Claude Code에 연결하면 관리 화면 대신 대화로 숫자를 묻고 답을 받습니다.
• 주간 리포트는 claude -p와 일정 실행으로 자동 생성해 저장소에 남깁니다.
• 개발 기록은 네 줄 일지로 충분합니다. 한 것, 숫자, 막힌 것, 다음 한 걸음.
• 기록과 리포트가 쌓이면 며칠 떠났다 돌아와도 다음 바퀴를 바로 시작할 수 있습니다.

AI에게 GA4를 읽게 한다

Claude Code는 MCP(Model Context Protocol)로 외부 서비스에 연결됩니다. Google Analytics 팀이 공개한 MCP 서버(analytics-mcp)가 있어서 이것을 붙이면 "지난주 원문 링크 클릭이 몇 건이야"라고 물었을 때 AI가 GA4 Data API를 직접 조회해 답합니다. 공식 저장소는 이 서버를 실험 단계로 표시하고 있으니 결과는 GA4 화면과 한 번 대조해 보는 것이 좋습니다.

연결 전에 우리 6주차 교재의 10항 체크리스트를 통과시킵니다. GitHub 저장소가 있고, 라이선스가 공개되어 있고, 필요한 인증은 사용량 과금 API 키가 아니라 Google Cloud의 애플리케이션 기본 자격 증명(ADC)입니다. 즉 서버 코드도 무료, 연결 서비스도 내 GA4 계정 권한만 있으면 됩니다. 사전 준비는 Google Cloud 프로젝트에서 Google Analytics Admin API와 Data API를 켜고 gcloud auth application-default login으로 로그인하는 것입니다.

# macOS / Windows 공통 (pipx 설치 후)
claude mcp add --transport stdio ga4 \
  --env GOOGLE_APPLICATION_CREDENTIALS=/절대경로/adc.json \
  -- pipx run analytics-mcp

-- 뒤가 서버를 실행하는 명령이고, 그 앞이 Claude Code의 옵션입니다. 범위는 기본이 local(이 프로젝트, 나만)이며 --scope project를 주면 .mcp.json에 저장되어 팀과 공유됩니다. 연결 상태는 세션 안에서 /mcp로 확인합니다. 자격 증명 파일 경로는 3주차 규칙대로 저장소에 올리지 않습니다.

정기 리포트를 내게 한다

연결이 됐으면 매주 월요일 아침에 리포트가 저장소에 생기게 만듭니다. 핵심은 Claude Code의 비대화형 실행입니다. claude -p "프롬프트"는 대화 창 없이 한 번 실행하고 결과를 출력합니다. --output-format json을 주면 결과와 비용이 구조화되어 나오고, --allowedTools로 쓸 도구를 미리 승인해 두면 멈추지 않고 끝납니다.

claude -p "지난 7일 GA4의 원문 링크 클릭 건수와 전주 대비 증감을 표로 만들고 docs/reports/$(date +%F).md에 저장해 줘" \
  --allowedTools "mcp__ga4__run_report,Write"

이 한 줄을 일정에 걸면 끝입니다. macOS는 launchd, Windows는 작업 스케줄러, 저장소 안에서 돌리려면 GitHub Actions의 on: schedule에 cron을 적고 anthropics/claude-code-action@v1에 prompt를 넘깁니다. 강사 원구연은 매일 밤 12시 30분에 그날의 작업을 요약해 노션에 올리는 일일 보고 자동화를 같은 방식으로 돌리고 있습니다. 한 가지 교훈은 자동 요약기에는 외부로 보내기 전에 키나 개인정보를 가리는 단계를 반드시 넣어야 한다는 것입니다.

사람이 정할 것은 셋입니다. 어떤 숫자를(추적할 숫자 하나), 언제(주 1회면 충분), 어디에(저장소의 docs/reports/). 나머지 형식과 조회 방법은 AI가 정합니다.

개발 기록도 남긴다: 네 줄 일지

리포트가 숫자의 기록이라면 일지는 판단의 기록입니다. 길게 쓰면 안 씁니다. 네 줄로 고정합니다.

## 2026-09-08
- 한 것: 알림 메일 제목에 마감 잔여일 추가 (Issue #18, 통과)
- 숫자: 원문 클릭 주 4건 → 7건
- 막힌 것: 프리뷰 DB에 샘플 공고가 없어 확인이 늦어짐
- 다음 한 걸음: 샘플 공고 20건을 시드로 넣는 Issue 만들기

이 일지도 AI가 씁니다. 세션이 끝날 때 "오늘 세션을 네 줄 일지 형식으로 docs/journal.md에 추가해 줘"라고 시키면 됩니다. 우리 교육에서 작업이 끝날 때마다 목적, 변경 파일, 명령, 결과, 다음 작업을 기록하게 하는 것과 같은 습관이고, 바이브 코딩에서는 숫자 한 줄이 더 들어갑니다.

기록과 리포트가 갖춰지면 다음 루프의 출발 속도가 달라진다

루프에서 가장 비싼 순간은 며칠 떠났다 돌아온 첫 30분입니다. 어디까지 했는지, 숫자가 어떻게 됐는지, 무엇을 하려 했는지를 다시 떠올리는 시간입니다. 리포트와 일지가 있으면 그 30분이 한 문장으로 줄어듭니다.

@docs/journal.md @docs/reports/ 를 읽고 지난 바퀴의 학습을 요약한 뒤,
docs/hypotheses.md 기준으로 다음 가설 후보 2개를 제안해 줘.

AI가 파일을 읽고 요약하고 제안하면, 사람은 고르기만 하면 됩니다. 기록을 남기는 이유는 과거를 위해서가 아니라 다음 바퀴의 출발을 위해서입니다.

해 보기

1. 6주차 10항 체크리스트로 analytics-mcp를 판단해 표로 남깁니다.
2. Google Cloud에서 Admin API와 Data API를 켜고 ADC 로그인 후 위 명령으로 연결합니다. /mcp로 상태를 봅니다.
3. 대화로 "지난주 추적 숫자"를 묻고 GA4 화면과 대조합니다.
4. claude -p 한 줄을 만들어 수동으로 한 번 실행하고, 결과 파일이 생기면 일정에 겁니다.
5. 오늘 세션을 네 줄 일지로 남기게 시키고, 내일 그 일지만 읽고 다음 Issue를 고를 수 있는지 봅니다.

정리

• GA4는 MCP로 연결해 대화로 묻습니다. 인증은 ADC, 비용은 내 계정 권한뿐입니다.
• 주간 리포트는 claude -p와 일정 실행으로 저장소에 쌓습니다.
• 일지는 네 줄, AI가 세션 끝에 씁니다.
• 기록은 다음 바퀴의 출발 속도를 위한 것입니다.

자주 묻는 질문