도구 카테고리
일부 MCP 클라이언트는 MCP 서버가 알릴 수 있는 도구 수를 제한합니다. Ahrefs의 MCP 서버는 다수의 MCP 클라이언트에서 이 제한을 초과합니다. 필요한 도구에 대한 접근 권한을 MCP 클라이언트가 제거하지 않도록 하는 방법을 제공합니다.
MCP 서버에 연결할 때 URL 쿼리 매개변수 tools를 사용해 접근하고 싶은 그룹을 선택할 수 있습니다. 여러 그룹은 쉼표로 구분하세요:
https://api.ahrefs.com/mcp/mcp?tools=site-explorer-overview,brand-radar-entities
tools 매개변수를 생략하면 모든 도구가 노출됩니다.
info
선택한 그룹에 관계없이 문서화 및 렌더링 도우미 도구는 항상 포함됩니다.
사용 가능한 도구 그룹
| 그룹 | 설명 |
|---|---|
site-explorer-overview | 사이트 익스플로러의 핵심 지표 — 도메인 등급, 백링크 및 아웃링크 통계, 자연 검색/유료 개요, 지표 이력. |
site-explorer-reports | 상세한 사이트 익스플로러 보고서 — 백링크, 참조 도메인, 앵커, 자연 검색 키워드 및 경쟁사, 상위 페이지, 링크된 도메인. |
keywords-explorer | 키워드 리서치 — 개요, 국가별 검색량 및 검색량 이력, 일치/관련 용어, 검색 제안. |
serp-overview | 키워드에 대한 SERP 개요. |
rank-tracker | 순위 트래커 — 개요 및 경쟁사 보고서. |
site-audit | 사이트 감사 — 프로젝트, 이슈, 페이지 익스플로러, 페이지 콘텐츠. |
brand-radar-simple | 브랜드 레이더 보고서(도메인/URL 수준). |
brand-radar-entities | 브랜드 레이더 보고서(엔터티 수준). |
web-analytics-overview | 웹 애널리틱스 통계 및 차트. |
web-analytics-sources | 웹 애널리틱스 트래픽 소스, 소스 채널 및 리퍼러. |
web-analytics-geo | 웹 애널리틱스 지역별 분류 — 대륙, 국가, 도시. |
web-analytics-user-agents | 웹 애널리틱스의 기기, 브라우저, 운영 체제, 언어별 분류. |
web-analytics-pages | 웹 애널리틱스의 상위 페이지, 유입 페이지 및 이탈 페이지. |
gsc | 구글 서치 콘솔 — 키워드, 페이지, 게재순위 및 실적 기록. |
social-media | 소셜 미디어 — 채널, 게시물, 작성자 및 해당 지표. |
batch-analysis | 단일 요청으로 여러 타깃을 일괄 분석합니다. |
management | 계정 관리 — 프로젝트, 키워드 목록, 위치 및 브랜드 레이더 설정. |
공개 | 공개/무료 엔드포인트 — 크롤러 IP 범위 및 무료 도메인 등급. |
subscription-info | 구독 한도 및 사용량. |
필수
클라이언트가 허용하는 도구 수를 제한하는 경우, 모든 그룹에서 가장 일반적으로 사용되는 도구만 선별한 세트인 tools=essentials를 사용하세요:
https://api.ahrefs.com/mcp/mcp?tools=essentials
info
essentials는 단독 값이므로 다른 그룹과 함께 사용할 수 없습니다. tools=essentials,site-audit는 거부됩니다. essentials만 단독으로 요청하거나 위에 나열된 그룹을 쉼표로 구분한 목록으로 요청하세요.
info
존재하지 않는 그룹 이름을 요청하면 연결이 invalid tool category 오류와 함께 거부됩니다. 철자가 위 표와 일치하는지 다시 확인하세요.