연동
Search Console을 모든 MCP 클라이언트에 연결
모든 MCP 클라이언트에서 쓰는 하나의 엔드포인트와 하나의 베어러 토큰: Search Console 및 GA4 데이터, 리서치 도구, 콘텐츠 엔진 대기열.
엔드포인트
서버는 앱 도메인의 /mcp에 위치하며 프로토콜 버전 2025-06-18의 Streamable HTTP를 사용합니다. 클라이언트는 JSON-RPC를 POST로 전송하고, initialize 요청을 보낸 다음 tools/list를 호출합니다. 설치할 것도 없고 경로에 로컬 프록시도 필요하지 않습니다.
- Authorization: Bearer, 키 형식은 apk_live_ 뒤에 32자리 16진수 문자가 붙는 형태입니다
- 키는 생성 시 한 번만 표시되며 SHA-256 해시로만 저장됩니다
- 모든 호출은 키의 마지막 사용 시각과 요청 횟수를 갱신합니다
도구
기능별로 그룹화했으며, 모델이 올바른 도구를 고르도록 이름을 명확히 했습니다. 읽기 전용 키로는 쓰기 도구나 리서치 크레딧을 소모하는 도구에 접근할 수 없습니다.
- 탐색: list_properties, search_analytics
- 성과: top_queries, top_pages, top_countries, compare_periods
- 진단: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
- 색인: url_inspection, sitemaps
- 타임라인: annotations, 쓰기 키에서는 create_annotation도 사용 가능
- 분석: ga4_overview, ga4_breakdown, ga4_key_events
- 리서치: 리서치 크레딧을 소모하는 키워드, SERP, 백링크, 순위 추적, 사이트 감사
- 콘텐츠 엔진: 대기열에서 글을 작성하기 위한 content_list_tasks, content_claim, content_get_brief, content_submit, content_publish 및 커버 도구
날짜는 선택 사항입니다
어떤 도구든 기간을 지정하지 않으면 서버는 Search Console의 보고 지연을 고려해 확정된 최근 28일을 사용하며, 비교 기간은 기본적으로 동일한 길이의 이전 기간으로 설정됩니다. 클라이언트는 적절한 질문을 하기 위해 오늘 날짜를 알 필요가 전혀 없습니다.
범위 및 속도 제한
키는 읽기 전용 또는 읽기/쓰기 중 하나입니다. 읽기 전용 키는 쓰기 도구에 전혀 접근할 수 없으며, 쓰기 키로 수행된 모든 변경 작업은 감사 로그에 기록됩니다.
- 키당 분당 60회, 계정당 시간당 1,000회 요청
- 한도를 초과하면 초 단위의 Retry-After와 함께 HTTP 429가 반환됩니다
- 계정의 다른 부분에 영향을 주지 않고 키 하나만 취소할 수 있습니다
REST가 편하다면
Search Console 및 GA4 도구는 /v1 아래의 GET 및 POST 경로로도 제공되며, 함수 호출 사양으로도 쓸 수 있는 OpenAPI 3.1 문서가 /v1/openapi.json에 자동 생성됩니다. 키, 범위, 한도는 동일합니다.