써피아 MCP 연결

써피아 MCP를 연결하면 AI 에이전트가 키워드 리서치, Google SERP, 로컬 비즈니스, 경쟁사 도메인, 백링크, 저장한 키워드, 순위 추적과 Search Console 도구를 대화 중에 호출할 수 있습니다.

관리형 MCP 주소는 다음과 같습니다.

https://app.serpia.app/mcp

첫 연결에서는 써피아 로그인과 프로젝트 권한 승인이 필요합니다. 관리형 서비스는 현재 베타이므로 계정 접근이 열리지 않았다면 Discord 커뮤니티에서 문의하세요.

Codex CLI

codex mcp add serpia --url https://app.serpia.app/mcp

연결 후 Codex에서 써피아 인증 요청을 승인합니다.

Claude Code

claude mcp add --transport http --scope user serpia https://app.serpia.app/mcp

Claude Desktop

1. Settings → Connectors를 엽니다.
2. Add custom connector를 선택합니다.
3. https://app.serpia.app/mcp를 붙여넣습니다.
4. 써피아 로그인을 승인합니다.

Cursor

Cursor Settings → Tools & Integrations → MCP Tools에서 mcp.json에 추가합니다.

{
  "mcpServers": {
    "serpia": {
      "url": "https://app.serpia.app/mcp"
    }
  }
}

사용할 수 있는 도구

• 검색량, 난이도, CPC와 의도가 포함된 키워드 조사
• 대한민국·한국어 또는 선택한 시장의 Google SERP 확인
• 도메인 개요, 순위 키워드와 경쟁사 탐색
• 백링크와 참조 도메인 개요
• 로컬 비즈니스와 Google Maps 결과
• 키워드 저장·태그와 순위 추적 데이터 읽기
• Search Console 클릭, 노출, CTR, 평균 게재순위 조회
• URL 색인·canonical·모바일·리치 결과 검사

MCP와 SEO 워크플로의 차이

MCP는 AI에게 데이터를 읽고 저장하는 도구를 제공합니다. SEO 워크플로는 어떤 순서로 조사하고 어떤 판단을 내려야 하는지 알려주는 별도의 SKILL.md 지침입니다. 둘을 함께 사용하면 반복 가능한 조사를 만들 수 있습니다.

비용과 승인

DataForSEO를 호출하는 키워드·SERP·도메인·백링크 도구는 사용량이 발생할 수 있습니다. Search Console 자사 데이터 읽기는 써피아 데이터 크레딧을 사용하지 않습니다.

AI가 키워드를 저장하거나 프로젝트 데이터를 변경하려 할 때는 실행 전에 대상과 범위를 확인하세요.

문제 해결

• 주소가 정확히 https://app.serpia.app/mcp인지 확인합니다.
• 인증이 실패하면 MCP 연결을 삭제한 뒤 다시 추가해 로그인합니다.
• 프로젝트를 찾지 못하면 먼저 프로젝트 목록을 요청하고 반환된 프로젝트 ID를 사용합니다.