GSC MCP로 Google Search Console을 연결하세요.
mcp-gsc는 Google Search Console을 Claude, ChatGPT, Cursor 또는 다른 MCP 클라이언트에 연결합니다. Google OAuth로 검색어, 페이지, 성능, 사이트맵, URL 검사를 확인하세요.
- 권장 모드
- Read-only
- 인증 방식
- Google OAuth
- 실행 옵션
- npm / Worker
- 라이선스
- MIT
npm · Google Search Console MCP
npm으로 GSC MCP 로컬 설치
npm은 같은 컴퓨터에서 Streamable HTTP 서버를 실행합니다. 실행 전에 Google OAuth와 자격 증명을 설정해야 하며 원클릭 연결이 아닙니다.
1. Google 접근 준비
Node.js ^22.18.0 / >=24.11.0+npm- 분석할 Search Console 속성에 접근 권한이 있는 Google 계정을 사용하세요.
- Google Cloud에서 OAuth 클라이언트를 만들고 필요한 API를 활성화한 뒤 정확한 로컬 리디렉션 URI를 등록하세요.
- 해당 버전의 설정 안내에 따라 세 가지 환경 변수를 지정하세요. TOKEN_ENCRYPTION_KEY는 임의의 32바이트를 올바르게 base64로 인코딩한 값이어야 합니다.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Google Cloud에 이 URI를 정확히 등록하세요. 호스트, 포트, 경로가 모두 일치해야 하며 localhost와 127.0.0.1은 서로 다릅니다.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. 로컬 서버 시작
터미널에 자격 증명을 설정한 후 npm 런처를 실행하세요. 분석 전용이면 셸에 맞는 읽기 전용 설정을 사용하세요.
기본 모드는 readwrite입니다. 분석만 한다면 Google 승인 전에 readonly를 선택하세요. 변경 도구는 등록되지 않습니다.
Bash / zsh 명령
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc로컬 엔드포인트 · Streamable HTTP
http://127.0.0.1:8080/mcp 3. MCP 클라이언트 연결
런처를 실행해 둔 상태에서 같은 컴퓨터의 클라이언트로 로컬 Streamable HTTP 엔드포인트에 연결하세요. stdio가 아닙니다.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpCodex CLI / IDE 연결
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
Cursor에서 gsc라는 이름의 Streamable HTTP MCP 서버로 이 URL을 추가하세요(로컬 Cursor).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
클라우드 ChatGPT나 Claude는 사용자 컴퓨터의 127.0.0.1에 접속할 수 없습니다. 계정 권한에 따라 자체 HTTPS Worker 또는 지원되는 보안 MCP 터널을 사용하세요.
원격 접속이 필요한가요?원격 접속이 필요한가요?
Cloudflare Workers 자체 호스팅도 계속 지원됩니다. Cloudflare와 Google OAuth 설정이 필요합니다. 아래 예시는 Bash 기준이며 전체 과정은 SETUP.md를 참고하세요.
소개
mcp-gsc란 무엇인가요?
mcp-gsc는 AI 클라이언트를 공식 Google Search Console API에 직접 연결하는 셀프 호스팅 가능한 Model Context Protocol 서버입니다.
npm 패키지를 로컬 루프백 HTTP로 실행하거나 원격 HTTPS용 자체 Cloudflare Worker를 배포할 수 있습니다. 두 방식 모두 Google OAuth를 사용합니다.
로컬 런처의 암호화된 세션 상태는 기본적으로 ~/.mcp-gsc/state에 저장됩니다. Worker는 사용자 Cloudflare 계정의 저장소를 사용하며 DigestSEO 관리형 연결 서비스가 아닙니다.
Search Console의 웹: 멀티모달 실적 파일을 불러와 페이지별 노출수와 클릭수를 살펴봅니다. 사진 검색 도구가 아닙니다. 구글 렌즈·멀티모달 검색 분석 도구.
권한이 있는 SNS 계정이 구글 검색에서 얼마나 발견되는지 비교합니다. 앱 내 조회수나 좋아요는 측정하지 않습니다. SNS 콘텐츠의 구글 검색 성과 비교.
도구
서버 기능
분석, URL 검사, 사이트맵, 색인 생성, SEO 진단, 주간 성능 요약을 위한 도구를 제공합니다.
도구 목록에는 선택적 쓰기 기능도 포함됩니다. GSC_ACCESS_MODE=readonly에서는 변경 없는 도구만 등록되고 Google Indexing API에는 지원 콘텐츠 제한이 있습니다.
get_capabilities사용 가능한 기능과 인증 상태를 나열합니다.
list_sites연결된 계정이 접근할 수 있는 Search Console 속성을 나열합니다.
query_search_analytics사용자 지정 기간의 클릭수, 노출수, CTR, 순위를 조회합니다.
inspect_url실시간 URL 검사 보고서와 색인 상태를 가져옵니다.
list_sitemaps제출된 사이트맵과 크롤링 상태 및 경고를 나열합니다.
add_site연결된 계정에 Search Console 속성을 추가합니다.
delete_site계정에서 Search Console 속성을 삭제합니다.
submit_sitemapSearch Console 속성에 사이트맵을 제출합니다.
delete_sitemap속성에서 제출된 사이트맵을 삭제합니다.
get_sitemap제출된 사이트맵 하나의 상세 상태를 가져옵니다.
identify_quick_wins노출은 높지만 순위가 8–20위인 검색어를 찾습니다.
detect_cannibalization여러 페이지가 경쟁하는 검색어를 찾습니다.
detect_content_decay검색 클릭이 가장 크게 감소한 페이지를 확인합니다.
request_indexingGoogle의 색인 생성 API를 통해 색인 생성을 요청합니다. 이 API는 현재 JobPosting 구조화 데이터가 포함된 페이지 또는 VideoObject 내에 BroadcastEvent가 포함된 라이브 스트림 페이지로 제한되며, 일반적인 웹페이지 제출에는 사용할 수 없습니다.
list_indexed_pagesSearch Console에서 노출이 발생한 페이지를 나열합니다.
compare_performance기간별 클릭수, 노출수, CTR, 순위를 비교합니다.
weekly_digest쉬운 언어로 주간 SEO 보고서를 생성합니다.
배포
원격 접속이 필요한가요?
Cloudflare Workers 자체 호스팅도 계속 지원됩니다. Cloudflare와 Google OAuth 설정이 필요합니다. 아래 예시는 Bash 기준이며 전체 과정은 SETUP.md를 참고하세요.
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deploy저장소에 별표를 누르고 Claude에서 Search Console을 사용하세요.
오픈소스 자체 호스팅 솔루션입니다. Google OAuth 안내에 따라 설정하거나 자체 Worker를 배포하세요.