MCP & ChatGPT 앱

AutoPSEO는 https://app.autopseo.com/mcp에서 MCP(Model Context Protocol) 서버 하나를 운영합니다. HTTP 기반 MCP를 지원하는 어시스턴트라면 AutoPSEO 계정에 로그인하거나 apk_live_ API 키를 사용해 연결할 수 있으며, 연결 후에는 사용자와 동일한 속성, 권한, 요금제로 작업합니다. 서버에는 72개의 도구가 세 그룹으로 등록되어 있습니다. Search Console 및 GA4 보고서, 리서치 데이터, 그리고 사용자의 AI가 사이트용 글을 직접 작성할 수 있게 해 주는 콘텐츠 엔진입니다.

로그인으로 연결하기

MCP 로그인을 지원하는 도구는 키가 필요하지 않습니다. 주소를 추가하고, 도구가 요청하면 AutoPSEO에 로그인해 승인하세요. 이후에는 도구가 자체 접근 권한을 보관하고 갱신합니다.

• Claude Code: claude mcp add --transport http autopseo https://app.autopseo.com/mcp를 실행한 다음 /mcp를 입력하고 autopseo를 선택한 뒤 Authenticate를 선택하세요.
• 웹 또는 데스크톱의 Claude: Settings → Connectors → Add custom connector에서 https://app.autopseo.com/mcp을 붙여넣고 Connect를 눌러 로그인하세요.
• Cursor: ~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(특정 프로젝트)에 서버를 추가한 다음, Cursor가 서버 옆에 표시하는 Connect 버튼을 사용하세요.

{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

이렇게 연결한 도구는 MCP & API 페이지의 Signed-in tools에 표시되며, Sign out을 누르면 즉시 접근이 차단됩니다. 처음에는 "내 계정의 Search Console 속성 목록을 보여줘"라고 요청해 보세요. 응답이 오면 연결이 정상이라는 뜻이며, 어시스턴트는 다른 도구가 요구하는 정확한 속성 이름도 알게 됩니다.

ChatGPT

ChatGPT는 개발자 모드를 통해 연결하며, MCP & API 페이지의 ChatGPT app에 단계별 안내가 있습니다. 요약하면 다음과 같습니다. ChatGPT에서 Settings → Apps & Connectors → Advanced settings를 열어 Developer mode를 켠 다음(앱에는 ChatGPT Plus, Pro, Business, Enterprise, Edu가 안내되어 있습니다), Create를 선택하고 커넥터 이름을 입력하세요. MCP 서버 URL에 https://app.autopseo.com/mcp을, 인증 방식에 OAuth를 지정하고, ChatGPT가 요청하면 AutoPSEO에 로그인하면 됩니다. ChatGPT 커넥터는 OAuth 또는 인증 없음만 지원하므로 API 키는 사용할 수 없습니다. 자세한 내용은 ChatGPT 페이지에서 확인하세요.

API 키로 연결하기

API 키는 스크립트, 예약 작업, 브라우저가 없는 환경을 위한 것입니다. MCP & API → API keys에서 키 이름을 정하고 권한 범위를 선택하세요.

• Read only: 데이터 조회와 보고서 실행만 가능하며, 추가, 변경, 삭제는 할 수 없습니다.
• Read & write: 읽기 키의 모든 기능에 더해, 데이터를 변경하거나 리서치 크레딧을 사용하는 도구도 쓸 수 있습니다.

전체 키는 apk_live_ 뒤에 16진수 32자가 붙은 형태이며 한 번만 표시됩니다. AutoPSEO는 SHA-256 해시만 저장합니다. 키 목록에는 각 키의 생성 시점, 마지막 사용 시점, 요청 횟수가 표시되고, Revoke를 누르면 해당 키가 즉시 중지됩니다. 활성 키는 최대 25개까지 보유할 수 있습니다. 키는 Authorization: Bearer apk_live_... 형식으로 보내세요(x-api-key 헤더도 사용할 수 있습니다).

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

이 페이지에는 OpenAI Responses API용 스니펫, curl로 보내는 JSON-RPC 원문 요청(서버는 Streamable HTTP transport를 사용합니다), 그리고 https://app.autopseo.com/v1의 REST API 예시도 있습니다. REST API는 같은 키로 Search Console 및 GA4 도구 19개를 제공하며, OpenAPI 3.1 문서는 /v1/openapi.json에서 볼 수 있습니다.

도구

MCP & API 페이지에는 항상 최신 도구 이름이 나열되어 있습니다. 이 문서를 작성한 시점에는 72개였습니다.

Search Console 및 GA4 (19개 도구)

list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown, ga4_key_events입니다. 크레딧이 들지 않습니다. 날짜를 지정하지 않으면 데이터가 확정된 최근 28일을 그 이전 28일과 비교하며, 누구나 데모 속성 sc-domain:demo.autopseo.app으로 사용해 볼 수 있습니다. 이름과 달리 content_decay도 이 그룹에 속하며, 클릭이 줄어드는 페이지를 찾아 줍니다.

리서치 (33개 도구)

• 계정 및 프로젝트: whoami, create_project, get_project_context, update_project_context
• 키워드: research_keywords, get_keyword_metrics, get_ranked_keywords, get_domain_keyword_suggestions, save_keywords, list_saved_keywords
• 도메인, 검색 결과 페이지, 링크: get_domain_overview, get_serp_results, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
• 순위 추적: create_rank_tracker, get_rank_tracker, add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker
• 로컬 검색: search_local_businesses, get_local_serp_results, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories
• 사이트 감사: run_site_audit, get_audit_status, get_audit_issues, get_audit_pages

이 도구 중 다수는 DataForSEO에서 데이터를 구매하며 리서치 크레딧을 사용합니다. 요청은 필요한 범위로 좁히고, 대량 요청 전에는 먼저 확인하세요.

콘텐츠 엔진 (20개 도구)

사용자의 AI가 AutoPSEO 라이터와 같은 작업 큐에서 일할 수 있게 해 주는 도구입니다. content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value, content_remove_path가 있습니다. 서버는 프롬프트 다섯 개도 제공합니다: write-articles, optimize-page, revise-draft, connect-repo, refresh-decayed.

일반적인 작업 흐름은 다음과 같습니다. 작업 목록을 확인하고, 하나를 선점하고(선점하면 2시간 동안 유지됩니다), 브리프를 읽고, 글을 작성해 제출하고, 검사에서 반려된 부분을 수정합니다. 게시는 사용자가 지시할 때만 합니다. 표지 이미지와 번역에는 전용 도구가 따로 있습니다. 이렇게 작성한 글은 AutoPSEO 자체 글과 같은 검사를 통과하며 글 할당량을 전혀 쓰지 않습니다. 다만 브리프를 처음 호출할 때는 실시간 검색 결과를 읽기 위해 리서치 크레딧이 사용됩니다. 전체 흐름은 나만의 AI로 글쓰기에서 확인하세요.

읽기, 쓰기, 유료 도구

모든 도구에는 접근 등급이 있습니다. 읽기 도구는 조회만 하며(33개), 쓰기 도구는 워크스페이스를 변경하고(22개), 유료 도구는 조회만 하지만 리서치 데이터를 구매합니다(17개). 읽기 전용 키로는 읽기 도구만 호출할 수 있습니다. Read 권한을 가진 팀원도 어떤 키나 로그인을 쓰든 읽기 도구만 호출할 수 있으며, 모든 팀원은 초대장에 지정된 속성에만 접근할 수 있습니다(공유 및 팀 접근).

제한과 오류

호출은 키당 분당 60회, 계정당 시간당 1,000회로 제한되며, 후자는 계정의 모든 키를 합산합니다. 둘 중 하나를 초과하면 서버가 Retry-After 헤더와 함께 HTTP 429를 반환하고, 대부분의 클라이언트는 알아서 대기한 뒤 재시도합니다. initialize와 ping 핸드셰이크는 집계되지 않습니다. 체험 기간이 구독 없이 끝나면 도구가 "subscription required"로 응답합니다. 어시스턴트 제공업체는 사용자가 요청한 경우에 한해서만 데이터를 받으며, 도구에서 로그아웃하거나 키를 폐기하면 이를 중단할 수 있습니다. 더 많은 예시는 Search Console MCP 페이지에서 볼 수 있습니다.