써피아 MCP 연결
써피아 MCP를 연결하면 AI 에이전트가 키워드 리서치, Google SERP, 로컬 비즈니스, 경쟁사 도메인, 백링크, 저장한 키워드, 순위 추적과 Search Console 도구를 대화 중에 호출할 수 있습니다.
관리형 MCP 주소는 다음과 같습니다.
https://app.serpia.app/mcp첫 연결에서는 써피아 로그인과 프로젝트 권한 승인이 필요합니다. 관리형 서비스는 현재 베타이므로 계정 접근이 열리지 않았다면 Discord 커뮤니티에서 문의하세요.
Codex CLI
섹션 제목: “Codex CLI”codex mcp add serpia --url https://app.serpia.app/mcp연결 후 Codex에서 써피아 인증 요청을 승인합니다.
Claude Code
섹션 제목: “Claude Code”claude mcp add --transport http --scope user serpia https://app.serpia.app/mcpClaude Desktop
섹션 제목: “Claude Desktop”- Settings → Connectors를 엽니다.
- Add custom connector를 선택합니다.
https://app.serpia.app/mcp를 붙여넣습니다.- 써피아 로그인을 승인합니다.
Cursor
섹션 제목: “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와 SEO 워크플로의 차이”MCP는 AI에게 데이터를 읽고 저장하는 도구를 제공합니다. SEO 워크플로는 어떤 순서로 조사하고 어떤 판단을 내려야 하는지 알려주는 별도의 SKILL.md 지침입니다. 둘을 함께 사용하면 반복 가능한 조사를 만들 수 있습니다.
비용과 승인
섹션 제목: “비용과 승인”DataForSEO를 호출하는 키워드·SERP·도메인·백링크 도구는 사용량이 발생할 수 있습니다. Search Console 자사 데이터 읽기는 써피아 데이터 크레딧을 사용하지 않습니다.
AI가 키워드를 저장하거나 프로젝트 데이터를 변경하려 할 때는 실행 전에 대상과 범위를 확인하세요.
문제 해결
섹션 제목: “문제 해결”- 주소가 정확히
https://app.serpia.app/mcp인지 확인합니다. - 인증이 실패하면 MCP 연결을 삭제한 뒤 다시 추가해 로그인합니다.
- 프로젝트를 찾지 못하면 먼저 프로젝트 목록을 요청하고 반환된 프로젝트 ID를 사용합니다.