ga-gsc-analytics
ga-gsc-analytics
Google Analytics 4 및 Google Search Console 데이터(analytics.readonly + webmasters.readonly 범위)를 Claude Code / Codex에 노출하는 읽기 전용 MCP 서버입니다.
처음이신가요? ONBOARDING.md를 따라 제로에서 작동까지의 과정(Claude Code 설치, 자격 증명 얻기, 인증, 확인)을 진행하세요. 이 파일의 나머지 부분은 참고 자료입니다.
AI 에이전트: 이 파일은
AGENTS.md역할도 합니다 — 설정은 여기서 시작하고, 도구 사용 방법(접근 확인, 기본 날짜 범위, GA4 vs. GSC 의미론, 프레젠테이션 전달 형식)은skills/analyze-ga-gsc/SKILL.md를 읽으세요. 사용자에게 채팅에 자격 증명을 붙여넣도록 요청하지 마세요.
도구
analytics_auth_start/analytics_auth_status— 로컬 OAuth 흐름 + 상태 확인analytics_list_sources— 인증된 계정에서 사용 가능한 GA4 속성 및 GSC 사이트 나열ga_run_report— GA4 보고서 실행gsc_query_search_analytics— Search Console 데이터 쿼리analytics_presentation_snapshot— 보고용 GA4 + GSC 결합 스냅샷
Related MCP server: GSC MCP
설정 (사용자별)
각 사용자는 자신의 Google 계정으로 인증하고 자신의 로컬 토큰을 유지합니다 — client_secret.json 비밀 또는 tokens.json을 기기 간에 공유하지 마세요.
Google Cloud OAuth 클라이언트: Google Cloud Console에서 OAuth 2.0 데스크톱 클라이언트를 생성(또는 기존 항목 재사용)하고 해당
client_secret.json을 다운로드하세요. 동의 화면이 "테스트" 게시 상태인 경우, 각 새 사용자의 Google 계정을 먼저 테스트 사용자로 추가하세요. 그렇지 않으면 인증이 access-denied로 실패합니다.자격 증명 배치:
~/.config/ga-gsc-analytics/client_secret.json에 배치하거나GA_GSC_CLIENT_SECRET을 사용자 지정 경로로 지정하세요.데이터 접근 권한 부여: 인증하는 Google 계정은 대상 GA4 속성(Analytics Admin → 속성 접근 관리) 및 GSC 사이트(Search Console → 설정 → 사용자 및 권한)에 실제 권한이 있어야 합니다.
서버 빌드 (
mcp/server.mjs를 변경한 경우에만 필요; 저장소에는 사전 빌드된mcp/server.bundle.cjs가 포함되어 있습니다):
pnpm install
pnpm run build # bundles mcp/server.mjs -> mcp/server.bundle.cjsMCP 서버 등록. 다음 중 하나를 사용하세요:
Claude Code, 사용자 수준:
claude mcp add ga-gsc-analytics -- node /path/to/ga-gsc-analytics/mcp/server.bundle.cjsClaude Code / Codex, 프로젝트 범위: 이 저장소에는 이미 상대 경로
.mcp.json({"mcpServers": {"ga_gsc_analytics": {"command": "node", "args": ["./mcp/server.bundle.cjs"]}}})이 포함되어 있습니다 — 프로젝트에 복사하거나 이 전체 폴더를 심볼릭 링크/벤더링하면 해당 프로젝트가 열릴 때 자동으로 인식됩니다.
인증: AI 도구 내에서
analytics_auth_start도구를 호출하세요 — 로컬 브라우저 OAuth 흐름이 열리고~/.config/ga-gsc-analytics/tokens.json에 기록됩니다.확인:
analytics_auth_status를 호출(authorized: true로 보고되어야 함)한 다음analytics_list_sources를 호출하여 예상 GA4 속성 / GSC 사이트가 표시되는지 확인하세요.
구성 재정의
환경 변수 | 기본값 |
|
|
|
|
|
|
개발
pnpm run check # syntax check
pnpm test # node --test tests/*.test.mjsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Search Console analytics, URL inspection, indexing diagnostics, and sitemaps.
Read-only Google Search Console and Google Analytics for AI agents.
Read-only Google Search Console, Bing, Google Analytics and privacy-friendly analytics for your AI.
Read-only access for your AI to Search Console, GA4, Google Ads, Meta Ads and your store's sales.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRead-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.MIT
- AlicenseAqualityBmaintenanceEnables read-only access to Google Search Console data, including property discovery, search analytics queries, and URL inspection, through a security-focused interface.32,636 PyPI2MIT
- FlicenseNot gradedqualityCmaintenanceEnables read-only access to Google Analytics 4, Google Search Console, BigQuery saved queries, GitHub repository data, and Metricool status for SEO/SEM monitoring and analysis.-
- AlicenseAqualityBmaintenanceEnables read-only access to Google Search Console data, including search analytics, sitemap status, URL inspection, and property listing.425 npmMIT