Search Console을 Claude에 연결

Claude Desktop

설정에서 커넥터로 이동한 다음 사용자 지정 커넥터 추가를 선택하고 AutoPSEO 엔드포인트 https://app.autopseo.com/mcp를 붙여넣으세요. 연결되면 Claude가 도구 목록을 가져오므로, 연결이 정상이면 도구가 바로 표시됩니다.

• Streamable HTTP 방식이라 로컬 프로세스를 설치할 필요가 없습니다
• 브라우저에서 인증하거나, apk_live_ 뒤에 32자리 16진수가 붙는 형태의 베어러 키를 붙여넣으세요
• 먼저 속성 목록을 요청해 커넥터가 어떤 계정에 연결되었는지 확인하세요

Claude Code

터미널에서 claude mcp add 명령으로 서버를 한 번 등록하고, http 전송 방식과 동일한 엔드포인트를 선택하세요. 세션 내에서 /mcp 명령을 사용하면 연결 여부와 노출되는 도구를 확인할 수 있습니다.

• 단일 저장소는 프로젝트 범위, 전체 저장소는 사용자 범위
• 키는 커밋된 설정 파일이 아닌 환경 변수에 보관하세요
• 편집 중인 페이지 옆에서 유용하며, 에이전트가 다시 작성하기 전에 성능 데이터를 먼저 확인할 수 있습니다

분석 이름을 지정해 요청하세요

프롬프트에 보고서 이름을 명시하면 도구 선택 정확도가 훨씬 높아집니다. "이 속성의 키워드 자기잠식 분석을 실행해줘"가 "키워드 중복을 확인해줘"보다 나은 이유는, 전자는 하나의 도구에 매핑되지만 후자는 여러 도구에 걸쳐 있기 때문입니다.

• "지난 28일 대비 클릭 수가 가장 많이 감소한 페이지는?"
• "4위에서 10위 사이의 스트라이킹 디스턴스 검색어를 보여줘"
• "지난달과 작년 같은 달을 비교해줘"
• "이번 달에 상위 100위권 밖으로 밀려난 검색어는?"

연결이 접근할 수 있는 범위

AutoPSEO 계정이 이미 읽기 권한을 가진 속성만 해당됩니다. 읽기 전용 키는 쓰기 도구를 전혀 호출할 수 없으므로, 사용자든 Claude가 읽은 페이지든 어떤 프롬프트로도 데이터를 변경할 수 없습니다.

연결되지 않을 때

Claude는 자체 인프라에서 서버를 호출하므로 localhost나 사설 주소는 거부됩니다. /mcp 경로를 포함해 호스팅된 엔드포인트를 정확히 그대로 사용하고, 계정 > MCP API 키에서 키가 해지되지 않았는지 확인하세요.