문서 · MCP
MCP 문서
seops를 Claude, ChatGPT, Gemini, Claude Code에 연결: OAuth 원격 MCP 서버, 45개 도구, 읽기 도구 무료.
요약. 어시스턴트에 https://app.seops.app/mcp을 추가하고 Google로 로그인한 뒤 사이트 이름으로 질문하세요. 도구는 총 45개: 읽기 34개, 쓰기 11개. 서버에는 에이전트가 어떻게 분석해야 하는지 정한 규칙이 포함되어 있습니다.
연결
Claude (claude.ai, Desktop)
- 설정 → 커넥터 → 사용자 지정 커넥터 추가
- URL: https://app.seops.app/mcp
- OAuth 창이 열리면 Google로 로그인
- 질문: "지난주 클릭이 줄어든 사이트는 어디야?"
Claude Code
claude mcp add --transport http seops https://app.seops.app/mcp- /mcp를 실행하고 로그인을 완료
- 서버에는 분석 규칙과 작업 동기화 프로토콜이 포함되어 있어 에이전트가 추가 지시 없이 따릅니다
ChatGPT
- 설정 → 커넥터 → 만들기 (개발자 모드)
- MCP 서버 URL: https://app.seops.app/mcp, 인증 OAuth
- 채팅에서 커넥터를 켜고 사이트 이름으로 질문
Gemini
- Gemini CLI: settings.json의 mcpServers 아래에 httpUrl로 서버 추가
- Gemini 앱 커넥터는 Google이 사용자 지정 MCP를 모든 계정에 열면 지원됩니다
에이전트가 따르는 규칙
서버의 MCP instructions는 연결할 때마다 에이전트에 전달됩니다. 요약하면:
- 추측하지 않습니다. 모든 숫자에 출처와 기간을 함께 적습니다.
- API의 비율 값은 0~1이며, 에이전트는 백분율로 표시하도록 지시받습니다.
- 28일 동안 클릭 50 미만 또는 노출 500 미만은 '표본이 작음'으로 표시합니다.
- 에이전트는 패널, Cloudflare, GA4 설정을 바꾸지 않고 복사해 붙여넣을 수 있는 텍스트를 제공합니다.
- AI 작업은 패널에서 승인한 뒤에만 시작됩니다.
도구
읽기 도구는 항상 포함됩니다. 쓰기 도구는 패널의 작업 목록, 프롬프트 기록, 초안만 변경하며 설정을 바꿀 수 없고 크레딧도 쓰지 않습니다.
프로젝트와 개요
get_work_items | Data-derived to-dos with counters (baseline, remaining, done) in fixed impact order; start a session with the top open item. |
list_projects | 추적 중인 사이트, 연결된 소스(Search Console, GA4), 키워드와 프롬프트 수. |
get_overview | 프로젝트의 28일 요약: Search Console 합계, GA4 트래픽과 AI 어시스턴트 방문, 순위 변동, AI 가시성 비율. |
get_weekly_summary | 지난주(월~일) 모든 모듈과 바뀐 점. |
get_alerts | 열려 있는 알림: 트래픽 감소, 색인 손실, 오래된 백업, 실패한 cron. |
검색
get_search_console | 이전 기간 대비 합계, 일별 추이, 상위 검색어와 페이지. |
get_search_opportunities | 게재순위 5~20위 검색어와 각 검색어에서 노출이 가장 많은 페이지. |
get_rank_tracking | 키워드와 기기별 최신 순위(Search Console), 변동, 순위에 오른 페이지. |
get_keyword_history | 키워드 하나의 90일 기록. |
get_indexing | 사이트맵, URL 검사 결과, IndexNow 키와 대기열. |
get_queue | 대기 중인 순위 확인과 AI 실행, 최근 오류, 다음 cron 시각. |
Analytics
get_analytics | 이전 기간 대비 GA4 합계, 채널, 방문 페이지, 소스/매체, AI 어시스턴트 트래픽. |
get_realtime | 최근 30분과 5분의 활성 사용자를 페이지와 소스별로. |
get_navigation | 한 페이지의 방문자가 어디서 와서 다음에 어디로 갔는지. 자주 나타나는 3단계 경로. |
get_site_search | 사이트 내 검색어와 결과 없는 검색. |
AI 가시성
get_ai_visibility | 엔진과 프롬프트별 언급률과 인용률. 인용된 사이트. |
get_ai_answer | 한 번의 실행에 대한 전체 답변 텍스트, 인용된 URL, 모델이 수행한 검색. |
get_cloudflare_ai_crawlers | GPTBot, ClaudeBot, PerplexityBot 등: 요청, 페이지, 허용 대 차단. |
사이트 상태와 Cloudflare
get_site_audit | 사이트맵 페이지의 기술 크롤링: 상태, 리디렉션, noindex, 제목, 설명, canonical, 구조화 데이터. |
get_page_speed | 가장 중요한 페이지의 PageSpeed Insights (모바일과 데스크톱). |
get_cloudflare_security | 요청, 방문, 데이터, 그리고 작업·기능·규칙·국가·경로별 차단된 요청. |
get_cloudflare_usage | 플랜 한도 대비 Workers, D1, R2 사용량. |
get_backups | D1, Supabase, WordPress, Hostinger 백업 상태와 마지막 성공 실행. |
get_security_audit | 보안 점검: 외부 표면 결과(HTTPS, 보안 헤더, 노출된 파일, security.txt, SPF/DMARC, Cloudflare TLS)와 최신 코드 감사 및 발견 항목. |
submit_security_auditwrite | Cloudflare의 security-audit 스킬로 수행한 코드 감사의 findings.json을 제출; 신규·종료된 발견 항목은 이전 실행과 대조됩니다. |
get_waf_rules | The site's Cloudflare WAF rules with the panel's analysis: dry run against real URLs and verified bots, false positives in the last 7 days, proposals. |
save_waf_ruleswrite | Record a WAF rule proposal with its rationale, or a new public endpoint; the panel never writes to Cloudflare, the user applies it. |
get_access_audit | Who can reach the site: search and AI bots, agents, PageSpeed and visitors from other countries; WAF linter with a corrected rule set. |
get_resilience_runs | Results of controlled load tests: whether the site stayed up and how fast it answered. |
run_resilience_testwrite | Send a controlled load (at most 250 requests) to your own verified site; only when you ask and retype the domain. |
get_usage | 이번 달 유료 공급자 지출, 예산 상한, 잔액, 속도. |
작업, 프롬프트, 마케팅 (쓰기)
list_tasks | 프로젝트, 담당, 상태로 필터링한 작업 목록. |
add_taskwrite | 무엇/왜/검증 방법과 함께 작업 열기. 담당은 사용자 또는 ai. 중복 제거 키. |
update_taskwrite | 상태, 우선순위, 메모 변경. 증거와 함께 닫기. AI 작업은 패널에서 승인된 뒤에만 시작. |
get_task_log | 작업의 모든 변경: 누가, 언제, 무엇을. |
log_promptwrite | 사용자의 요청과 에이전트의 요약을 프롬프트 기록에 남기기. |
list_prompts | 주제와 태그가 포함된 프롬프트 기록. |
list_prompt_templates | 프롬프트 라이브러리. |
save_prompt_templatewrite | 재사용 가능한 프롬프트를 라이브러리에 저장. |
list_social_posts | 콘텐츠와 공유: 계정, 게시물, 일정. |
create_social_postwrite | 이번 주 데이터로 게시물 초안 작성. 나가기 전에 사용자가 승인. |
update_social_postwrite | 초안 수정 또는 예약. |
save_content_draftwrite | 패널에서 검토할 가이드나 글 초안 저장. |
list_feedback | 에이전트가 기록한 버그 신고와 제안. |
update_feedbackwrite | 피드백 항목 닫기 또는 메모 추가. |
인증과 보안
- OAuth 2.1 + PKCE. 동적 클라이언트 등록이 켜져 있습니다. 토큰은 하나의 워크스페이스에만 묶이며 다른 워크스페이스는 읽을 수 없습니다.
- 비밀 값(키, 이메일)은 서버에서 마스킹되며 프롬프트 기록에 원문으로 기록되지 않습니다.
- 에이전트는 각 요청과 짧은 요약을 비밀 값을 가린 채 프롬프트 기록(추적 › 작업 › 프롬프트 기록)에 씁니다. 이 기록은 끌 수 있습니다.