Google Search Console MCP 서버를 사용하면 Claude, Claude Code, Codex, Cursor 같은 AI 에이전트가 Search Console API에 접근할 수 있습니다. 에이전트는 클릭수, 노출수, 클릭률, 평균 게재순위를 가져오고, 페이지가 색인되었는지 확인하고, 사이트맵 목록을 볼 수 있습니다. "1페이지에 노출되는데 클릭이 없는 페이지는?"처럼 평소 쓰는 말로 물으면, 에이전트가 쿼리를 실행하고 결과 행을 하나하나 살펴봅니다. 이 가이드에서는 세 가지 설정 방법을 비교하고, API가 제공하지 않는 것을 설명한 뒤, Search Console에서 직접 확인할 수 있는 첫 점검을 단계별로 안내합니다.
결론부터 말하면, 2026년 11월 9일 현재 Google의 공식 Search Console MCP 서버는 없습니다. Google은 Google Analytics용 MCP 서버는 공개했지만, Claude와 ChatGPT의 디렉터리 어디에도 Google, Anthropic, OpenAI가 만든 Search Console 커넥터는 없습니다. 선택지는 세 가지입니다. Google Cloud 프로젝트가 필요한, 직접 실행하는 무료 커뮤니티 서버, Google 계정으로 로그인하는 호스팅 서버, 그리고 Orkas처럼 '연결'만 클릭하면 되는 커넥터 내장 앱입니다. 세 가지 모두 같은 API를 읽는데, 이 API는 모든 검색어를 보여 주지 않습니다. Google은 익명 처리된 검색어를 제외하는데, Ahrefs가 Search Console 속성 887,534개를 조사한 연구에서 이런 검색어는 트래픽의 46.77%를 차지했습니다.
Search Console MCP로 할 수 있는 것과 없는 것
커뮤니티 서버든 상용 서버든, 모든 Search Console MCP 서버는 같은 무료 Search Console API를 호출합니다. 무엇을 할 수 있는지는 이 API에 달려 있으며, 아래 표는 Google의 API 레퍼런스와 사용량 한도를 바탕으로 정리한 것입니다.
| 요청하는 데이터 | API | 한도 |
|---|---|---|
| 검색어, 페이지, 국가, 기기, 날짜, 검색 노출별 클릭수, 노출수, CTR, 게재순위 | Search Analytics | 최근 16개월, 약 2~3일 지연. 요청당 최대 25,000행, 검색 유형별 하루 50,000행 |
| URL 색인 여부, 마지막 크롤링, Google이 선택한 표준 URL | URL Inspection | 호출당 URL 1개. 속성당 하루 2,000회 |
| 사이트맵과 오류 | Sitemaps | 읽기는 읽기 전용 권한으로 가능, 제출·삭제는 전체 권한 필요 |
| 볼 수 있는 속성 | Sites | 속성 추가·삭제는 전체 권한 필요 |
Search Console의 일부 기능은 API가 없어서 어떤 MCP 서버로도 가져올 수 없습니다.
- AI 개요와 AI 모드 데이터. Google은 2026년 8월 31일 생성형 AI 실적 보고서를 모든 사이트에 출시했지만, API 레퍼런스에는 이에 해당하는 검색 유형이나 검색 노출 항목이 없습니다.
- 새로운 보고서 옵션. 멀티모달 검색 유형과 브랜드 검색어 필터도 API 레퍼런스에 없습니다.
- 실제 페이지 테스트. URL 검사는 Google 색인에 있는 버전을 보여 줍니다. API 문서에도 "실제 URL의 색인 생성 가능 여부는 테스트할 수 없습니다"라고 나와 있습니다.
- "Request indexing"(색인 생성 요청) 버튼. 이 버튼은 Search Console에만 있습니다. 일부 서버가 호출하는 Google의 별도 Indexing API는 공식적으로 채용 공고와 라이브 스트리밍 페이지 전용입니다.
Search Console을 Claude, Claude Code, Codex에 연결하는 세 가지 방법
| 방법 | 설정 | 데이터 경로 | 비용 |
|---|---|---|---|
| 직접 실행하는 커뮤니티 서버(예: mcp-gsc) | Google Cloud 프로젝트, API, 사용자 인증 정보, 설정 항목 추가 | 내 컴퓨터에서 Google로 | 무료 |
| 호스팅 서버(예: mcpsearchconsole.com) | Google로 로그인한 뒤 서버 URL을 AI 앱에 붙여넣기 | 제공업체 서버를 거침 | 무료 플랜, 이후 구독 |
| Orkas 내장 커넥터 | '연결' 클릭 후 Google로 로그인 | 내 컴퓨터에서 Google로 | 커넥터 무료 |
- 커뮤니티 서버는 무료이고 기능이 가장 많습니다. 가장 인기 있는 AminForou/mcp-gsc는 2026년 11월 9일 기준 GitHub 스타가 2,151개였습니다. 소스 코드에는 21개 도구가 있으며, 기간 비교, 최대 10개 URL 일괄 검사, 허용한 경우 사이트맵 제출 등이 포함됩니다. 대신 설정에 손이 갑니다. Google 사용자 인증 정보를 직접 만들어야 합니다. r/TechSEO의 한 댓글 작성자는 Google Cloud를 "유일한 걸림돌"이라고 표현했습니다.
- 웹에서 claude.ai나 ChatGPT를 쓴다면 호스팅 서버가 가장 빠릅니다. 원격 서버이므로 URL로 추가합니다. Claude 도움말 센터에 따르면 사용자 지정 커넥터는 모든 요금제에서 쓸 수 있지만, "무료 사용자는 사용자 지정 커넥터를 하나만 사용할 수 있습니다." mcpsearchconsole.com은 속성 3개에 대해 월 40회 데이터를 가져올 수 있는 무료 플랜을 제공하며, 그 이상은 월 €4.99(VAT 별도)입니다. Search Console 데이터가 제공업체를 거치므로 개인정보 처리 방침을 먼저 읽어 보세요.
- 내장 커넥터를 쓰면 Google Cloud 설정을 건너뛸 수 있습니다. Orkas에서는 Google로 로그인하면 커넥터가 내 컴퓨터에서 실행됩니다. 읽기 전용이며 도구는 4개로, 커뮤니티 서버보다 적습니다.
커뮤니티 서버 직접 실행하기
아래 단계는 0.4.2 버전(2026년 11월 6일) 기준 mcp-gsc README를 따릅니다. 이 가이드를 쓰면서 Google Cloud 프로젝트를 직접 만들어 보지는 않았으므로, 시작하기 전에 README를 확인하세요.
- Google 사용자 인증 정보 만들기. Google Cloud 콘솔에서 프로젝트를 만들고 Search Console API를 사용 설정한 다음, 유형이 Desktop app인 OAuth 클라이언트 ID를 만듭니다. 그리고 JSON 파일을 다운로드하세요. 자동화가 목적이라면 대신 서비스 계정을 만들고, Search Console의 설정 > 사용자 및 권한에서 그 이메일 주소를 전체 권한으로 추가합니다.
- uv 설치하기. README에서 권장하는 방법은
uvx로 서버를 실행하는 것으로, Python은 알아서 처리됩니다. uv 없이 하려면 Python 3.11 이상이 필요합니다. - 에이전트에 서버 추가하기. Claude Code에서는:
Codex에서는:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
두 명령은 Claude Code 2.1.311과 Codex CLI 0.163.0에서 확인했습니다. Claude Desktop이나 Cursor용으로는 README에codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvx의 전체 경로를 넣은 JSON 설정이 나와 있습니다. Dock이나 시작 메뉴에서 연 앱은 전체 경로가 없으면 이를 찾지 못할 수 있기 때문입니다. - 한 번 로그인하기. 처음 사용할 때 Google 로그인을 위한 브라우저 창이 열립니다. 0.4.2부터는
GSC_ALLOW_DESTRUCTIVE=true를 설정하지 않는 한 서버가 읽기 전용 권한만 요청합니다.
커뮤니티 가이드에서 다루지 않는 함정이 하나 있습니다. Google의 OAuth 문서에 따르면, OAuth 동의 화면을 External로 설정하고 Testing 상태로 두면 갱신 토큰이 7일 후 만료됩니다. 매주 다시 로그인해야 한다는 뜻입니다. 이를 피하려면 앱을 프로덕션으로 게시하거나 서비스 계정을 사용하세요. 게시한 앱에는 '확인되지 않은 앱' 경고가 표시될 수 있는데, 사용자가 100명 미만인 개인용 앱이라면 Google은 이 경고를 클릭해 넘어가도록 허용합니다.
Orkas에서 Search Console 연결하기
Orkas는 macOS와 Windows용 데스크톱 앱으로, 여러 AI 에이전트가 하나의 채팅에서 함께 일합니다. Google Search Console 커넥터가 내장되어 있어 Google Cloud 프로젝트가 필요 없습니다.
- Orkas 설치 후 로그인. macOS 또는 Windows용으로 다운로드하세요. 새 계정에는 Orkas 내장 모델에 쓸 수 있는 무료 크레딧 500이 제공되므로, API 키 없이 시작할 수 있습니다.
- 커넥터 열기. 사이드바에서 커넥터를 클릭하고 Google Search Console을 찾습니다. 데이터 필터나 검색창을 쓰면 바로 찾을 수 있습니다.
- '연결'을 클릭하고 Google로 로그인. 연결을 클릭하고, 해당 속성을 볼 수 있는 Google 계정을 선택한 뒤 읽기 전용 액세스를 허용합니다. 카드가 연결됨으로 이동합니다.
- 필요한 것을 요청. 채팅에서 @를 입력해 Google Search Console 커넥터를 선택하거나, 하려는 작업을 그냥 설명하세요. 에이전트가 먼저 속성 목록을 가져온 다음, 지정한 속성을 조회합니다.
- 읽기 전용입니다. Orkas는 Google에
webmasters.readonly범위만 요청합니다. 4개 도구는 각각 속성 목록 조회, 실적 데이터 조회, 사이트맵 목록 조회, URL 검사를 합니다. 읽기만 하므로 Orkas는 호출할 때마다 승인을 요청하지 않고 도구를 실행합니다. 사이트맵 제출이나 색인 생성 요청은 할 수 없고, 쿼리 한 번에 최대 25,000행을 반환합니다. - 쿼리는 Google로 바로 갑니다. 커넥터는 내 컴퓨터에서 실행되며 Search Console API를 직접 호출합니다. Orkas 서버를 거치는 것은 Google 로그인과 토큰 갱신뿐이며, 이 서버에 앱의 Google 사용자 인증 정보가 보관되어 있습니다.
- SeoGeoAgent와 코딩 에이전트도 사용할 수 있습니다. Orkas의 내장 SEO 에이전트인 SeoGeoAgent는 Search Console이 연결되면 실제 클릭수, 노출수, 게재순위를 점검에 활용합니다. Claude Code, Codex, OpenCode, Hermes, OpenClaw를 설치하고 Orkas에 연결해 두었다면, Orkas의 도구 브리지를 통해 이 커넥터를 쓸 수 있으므로 따로 MCP를 설정할 필요가 없습니다.
- 쓰기 기능이 필요하다면? 커넥터 페이지의 MCP 서버 추가로 커뮤니티 서버를 로컬 명령으로 추가하세요. Orkas에는 Bing Webmaster Tools 커넥터도 있습니다.
직접 확인할 수 있는 첫 점검
좋은 첫 요청은 Search Console과 1분 안에 비교할 수 있는 숫자를 묻고, 데이터가 다루지 않는 부분을 에이전트가 밝히게 하는 것입니다. 속성과 두 URL은 내 것으로 바꿔 쓰세요.
Google Search Console 커넥터로 sc-domain:example.com을 조회해 주세요. 데이터가 확정된 최근 28일 기준으로 다음을 알려 주세요. 1) 날짜별 총 클릭수와 노출수, 그리고 그중 검색어 행이 차지하는 비율; 2) 게재순위 5~15위, 노출수 100회 이상, 클릭률 2% 미만인 페이지(노출수 순으로 정렬); 3) 다음 두 URL의 색인 상태: https://example.com/new-page/, https://example.com/old-page/. 모든 표에 기간을 표시하고, 데이터에 나오지 않는 것은 추정하지 마세요.
저희는 2026년 11월 9일 Orkas 안의 Claude Code로 이 요청을 실행했고, 커넥터의 도구 4개가 모두 정상적으로 작동했습니다. 저희 사이트의 Search Console 수치는 공개하지 않으므로, 아래 결과는 합성 데이터로 만든 예시입니다. example.com에 있는 가상의 상점을 가정해 지어낸 수치로, 꼼꼼한 답변이 어떤 모습인지, 각 부분을 어떻게 확인하는지 보여 줍니다.
- 날짜별 합계(합성 데이터): 클릭수 3,480회, 노출수 151,200회. 사이트 전체 수치로 믿을 수 있는 것은 이 합계입니다. 직접 확인하려면 실적 보고서를 열고 같은 맞춤 기간과 검색 유형을 선택한 뒤 합계를 비교하세요. 두 값은 거의 같게 나와야 합니다. 차이가 크다면 대개 에이전트가 날짜별 합계 대신 검색어 행이나 페이지 행을 더한 것입니다.
- 검색어 행(합성 데이터): 642개 행에 클릭 1,670회, 전체의 48%. 나머지는 Google이 익명 처리한 검색어에서 나오며, 이런 검색어는 보고서에도 API에도 행이 없습니다. 이 정도 비율은 일반적입니다. Ahrefs의 조사에 따르면 2025년 4월 익명 처리된 검색어가 트래픽의 46.77%를 차지했고, 많은 사이트에서는 그보다 높았습니다. 검색어 행을 더한 값을 사이트 트래픽이라고 말하는 에이전트는 절반쯤 틀릴 수 있습니다.
- CTR이 낮은 페이지(합성 데이터): 게재순위 5~15위, 노출수 100회 이상, CTR 2% 미만인 페이지 9개. 그중 노출수가 가장 많은
/blog/linen-care/는 노출수 2,140회, 평균 게재순위 6.8, 클릭수 21회로 CTR이 1.0%였습니다. 제목과 설명을 가장 먼저 살펴볼 페이지들입니다. 사이트가?lang=로 끝나는 주소로 언어별 페이지를 제공한다면 버전마다 페이지 행이 따로 생기므로, 묶어서 보여 달라고 요청하세요. - URL 검사(합성 데이터): 오래된 페이지는 색인이 생성되었고, 새 페이지는 아직입니다. 9월에 게시된
https://example.com/old-page/는 "Submitted and indexed" 상태였고 마지막 크롤링은 10월 3일이었습니다. 확인 이틀 전에 게시된https://example.com/new-page/는 "Discovered - currently not indexed" 상태였습니다. 확인하려면 같은 URL을 Search Console 상단의 검사창에 붙여 넣으세요.
자주 막히는 다섯 가지
- 검색어 행을 전체 트래픽으로 보는 것. Google의 실적 데이터 가이드에 따르면 익명 처리된 검색어는 행이 없어서 "모든 행의 클릭수를 합산해도 차트의 합계와 같은 클릭수가 나오지 않습니다." 합계가 필요하면 검색어 필터 없이 날짜별 데이터를 요청하세요.
- 페이지 합계를 사이트 합계와 비교하는 것. 페이지별로 묶으면 검색결과에 표시된 URL이 각각 따로 집계됩니다. 속성별로 묶으면 검색결과 하나는 사이트 전체에서 한 번만 집계됩니다. 그래서 페이지 행의 노출수를 합하면 사이트 합계보다 많아질 수 있습니다.
- 지연을 잊는 것. 데이터는 "일반적으로 2~3일 후에 제공됩니다." API는 최신 데이터를 따로 요청하지 않으면 확정된 데이터를 반환하므로, "최근 7일"은 오늘보다 며칠 앞에서 끝납니다.
- 속성 이름을 잘못 쓰는 것. 도메인 속성은
sc-domain:example.com형식으로 씁니다. URL 접두어 속성은https://example.com/처럼 끝의 슬래시까지 포함한 전체 주소입니다. 에이전트가 먼저 속성 목록을 가져오게 하고, 반환된 이름을 그대로 복사하세요. - 한 번에 너무 많이 요청하는 것. 요청 하나는 최대 25,000행을 반환하는데, 16개월치를 검색어와 페이지별로 나누면 금방 한도에 찹니다. 요약, 필터, 더 짧은 기간을 요청하고, 모든 행을 채팅에 붙여 넣게 하기보다 에이전트가 직접 처리하게 하세요.
어떤 방법을 골라야 할까?
| 상황 | 추천 |
|---|---|
| 브라우저에서 claude.ai나 ChatGPT를 쓰는 경우 | URL로 추가하는 호스팅 서버 |
| 사이트맵 제출을 포함한 모든 도구가 필요하고, Google Cloud 설정도 괜찮은 경우 | mcp-gsc 같은 커뮤니티 서버 |
| Google Cloud 없이 Claude Code, Codex, SEO 에이전트가 Search Console을 읽게 하고 싶은 경우 | Orkas 내장 커넥터 |
| 사이트가 커서 요청당 25,000행으로 부족한 경우 | MCP 대신 Search Console의 BigQuery 대량 데이터 내보내기 |
자주 묻는 질문
Google 공식 Search Console MCP 서버가 있나요?
아니요. 2026년 11월 9일 현재 없습니다. Search Console은 Google의 공식 MCP 서버 목록에도, Google Cloud의 MCP 목록에도 없습니다. Google은 Google Analytics용 MCP 서버를 공개했지만, 여기에는 Search Console 데이터가 포함되지 않습니다.
Search Console MCP는 무료인가요?
Search Console API는 무료이고, mcp-gsc 같은 커뮤니티 서버와 Orkas 커넥터도 무료입니다. 호스팅 서버는 보통 월 한도가 있는 무료 플랜과 유료 플랜을 둡니다. 다만 연결하는 AI 에이전트 자체의 비용(Claude 요금제나 Orkas 크레딧 등)은 별도로 듭니다.
MCP 서버로 사이트맵을 제출하거나 색인 생성을 요청할 수 있나요?
Search Console 전체 권한이 있으면 사이트맵을 제출하거나 삭제할 수 있으며, 일부 커뮤니티 서버가 이 기능을 제공합니다. Search Console API에는 Request indexing(색인 생성 요청) 기능이 없으므로, 일반 페이지에 대해서는 어떤 서버도 이를 할 수 없습니다. Orkas 커넥터는 읽기 전용이라 둘 다 하지 않습니다.
MCP 숫자가 Search Console과 다른 이유는 무엇인가요?
대개 에이전트가 익명 처리된 검색어가 빠진 검색어 행을 합산했거나, 페이지별 합계와 속성별 합계를 섞었기 때문입니다. 검색어 필터 없이 날짜별 합계를 요청하고, 기간과 검색 유형을 보고서와 똑같이 맞추세요. 그러면 합계가 거의 같게 나와야 합니다.
Claude Code와 Codex에서도 쓸 수 있나요?
네. claude mcp add 또는 codex mcp add로 커뮤니티 서버를 추가하거나, 호스팅 서버를 URL로 추가하면 됩니다. Orkas에서는 Claude Code와 Codex가 Orkas의 도구 브리지를 통해 내장 Search Console 커넥터를 사용하므로, 두 도구 모두 따로 설정할 필요가 없습니다.
Agentic SEO란 무엇인가? 글에서 전체 그림을 다룹니다. 에이전트가 실제 데이터로 SEO 작업을 하고, 반영할 내용은 사람이 승인하는 방식입니다.