MCP 연결 가이드

관심 있는 웹사이트를 AI에서 조회하고 보고서를 불러오세요.

백링크 파트너, 게스트 포스트 게재 후보와 경쟁 사이트를 AI에서 평가하세요. Ahrefs DR, 백링크, 검색 트래픽, AI 응답을 조회하고 구매한 보고서를 불러와 비교할 수 있습니다. 해당 사이트를 소유하거나 Ahrefs 계정을 구매할 필요가 없습니다.

필요한 판단부터 시작하세요

백링크 파트너 선정

연락 전에 DR, 참조 도메인, Dofollow 링크와 검색 트래픽을 비교하세요. 단일 점수보다 추가 확인이 필요한 차이를 AI에 요청하세요.

게스트 포스트 게재처 평가

백링크 프로필, 자연 검색 상위 3개 국가와 AI 응답을 함께 살펴 타깃 독자와의 적합성을 검토하세요.

경쟁 사이트 이해

여러 사이트를 비교하고 구매한 스냅샷을 무료로 다시 읽으세요. AI가 조회 및 데이터 시간을 먼저 밝히고 차이를 설명하도록 하세요.

3단계로 연결

  1. 토큰 생성

    인증 계정으로 로그인해 내 계정 / AI 클라이언트 연결(MCP)을 여세요. 새 조회는 “크레딧을 사용하는 조회 허용”을 켜고 토큰을 생성·교체한 뒤 클라이언트를 업데이트하세요. 구매 기록만 읽는다면 읽기 전용을 유지할 수 있습니다.

  2. AI 클라이언트에 서버 추가

    원격 MCP와 Streamable HTTP를 선택하고 아래 URL을 입력합니다. Authorization 헤더는 Bearer, 공백, 토큰 순서입니다. 별도 Bearer Token 칸에는 토큰만 입력하세요.

  3. 저장된 보고서부터 읽기

    최근 조회를 나열한 뒤 구매한 결과를 열어 보세요. 열람은 무료입니다. 새 조회 전에는 도메인, AI 포함 여부와 총 차감량을 확인하세요.

연결 설정

연결 URL
https://ahrefsdr.com/mcp
전송 방식
Streamable HTTP
인증
Authorization: Bearer <token>

원격 Streamable HTTP와 사용자 정의 Authorization 헤더 또는 Bearer Token을 지원해야 합니다. OAuth 또는 로컬 stdio만 지원하는 클라이언트는 호환 어댑터가 필요합니다. 사이트 계정 토큰을 사용하며 Ahrefs API 키는 필요하지 않습니다.

크레딧 차감 규칙

작업사용 크레딧
기록 목록 또는 구매한 결과 열람0
새 조회: 사이트 1개 기본 보고서1
새 조회: 사이트 1개 기본 + AI 응답2
새 조회: 사이트 2개 기본 보고서2
새 조회: 사이트 2개 기본 + AI 응답4
  • 중복 제거 후 N개 사이트는 기본 N, AI 포함 2×N 크레딧입니다. MCP 도구 호출은 도메인 1개씩입니다. 여러 사이트 조회 전 중복 제거와 총액 확인을 요청하세요.
  • 기본 조회 실패 시 기본 크레딧을 반환합니다. AI만 실패하면 추가 1개를 반환하고 기본 결과를 유지합니다. 처리 중에는 예약될 수 있으며 완료 또는 복구 후 정산됩니다.
  • 새 조회나 업데이트에는 크레딧이 사용됩니다. 구매한 보고서는 무료로 읽을 수 있으며 당시 결과를 그대로 확인할 수 있습니다.
  • MCP 일일 한도는 사이트 수가 아닌 크레딧 수이며 UTC 00:00에 초기화됩니다. 기본 20, 토큰 생성 시 1~2,000으로 설정합니다. MCP 새 조회만 제한하며 잔액을 추가하거나 웹 조회를 제한하지 않습니다. 주문별 크레딧은 구매 후 1년간 유효합니다.

일일 한도, 잔액과 무료 기록 읽기

한도는 도구 호출 횟수가 아닌 크레딧 수입니다

토큰 생성 시 내 계정에서 설정합니다. 기본 20, 범위 1~2,000입니다. 잔액이 충분하면 20으로 기본 20개 또는 AI 포함 10개 사이트를 조회합니다. 기록 읽기는 한도를 사용하지 않습니다. UTC 00:00에 초기화되며 변경 후 토큰을 재생성해야 합니다.

일일 한도에 도달하면

새 조회는 시작 전에 거부됩니다. UTC 다음 날을 기다리거나 한도를 조정하고 새 토큰을 생성하세요. 1개만 남으면 기본 조회는 가능하지만 2개가 필요한 AI 조회는 불가합니다. 한도를 올려도 계정 잔액은 늘지 않습니다.

잔액이 없어도 기록을 읽을 수 있나요?

예. 유효한 토큰으로 본인이 구매한 기록을 무료로 읽을 수 있으며 일일 한도 도달 후에도 같습니다. 새 유료 조회는 잔액 충전이 필요합니다. 만료·취소된 토큰은 기록 읽기에도 교체가 필요합니다.

기록 읽기와 새 조회의 차이

기록은 구매 당시 보고서와 원래 조회·데이터 시간을 반환하며 무료이고 자동 갱신되지 않습니다. 일일 한도를 모두 써도 기록과 내 프로젝트의 구매 보고서는 무료로 읽을 수 있습니다. 새 조회는 기본 1개, AI 포함 2크레딧입니다. 실행 전 AI가 저장된 보고서 읽기인지 새 유료 조회인지 밝히게 하세요.

예시: Claude Code

비공개 로컬 MCP 설정에서 YOUR_MCP_TOKEN을 내 계정의 토큰으로 교체하세요. 저장소에 커밋하거나 AI 대화에 붙여 넣지 마세요. 아래 형식은 Claude Code용이며 클라이언트마다 다를 수 있습니다.

{
  "mcpServers": {
    "ahrefsdr": {
      "type": "http",
      "url": "https://ahrefsdr.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

재연결 후 도구를 확인하세요. 읽기 전용은 list_queries, get_query, get_my_project이며 유료 허용 토큰에는 check_domain도 있습니다.

Claude Code · MCP

AI에서 가능한 작업

도구용도
list_queries최근 조회 최대 50개와 ID·조회 시간을 무료로 읽습니다.
get_queryquery_id로 본인의 구매 스냅샷을 무료로 읽습니다.
get_my_project내 프로젝트와 구매 보고서를 무료로 읽어 비교 기준으로 사용합니다. 갱신하지 않으며 미설정이면 기준 URL을 묻습니다.
check_domain사이트 1개 조회. 유료 권한, 잔액, 일일 한도, UUID request_id가 필요합니다. 기본은 confirm_credits = 1, AI 포함은 include_ai: true와 confirm_credits = 2입니다.

MCP 연결 후 AI에 질문하는 예시

09

한 사이트를 평가하거나 내 프로젝트와 하나 또는 여러 대상 사이트를 비교해 협력, 경쟁, 홍보 결정을 준비하세요.

AI는 get_my_project로 내 프로젝트의 구매 보고서를 무료로 읽고 비교 기준으로 사용합니다. URL 재입력이 필요 없습니다. 프로젝트가 없을 때만 URL을 묻습니다. 다른 기준을 선택하거나 사이트 없이 대상만 평가할 수도 있습니다.

  1. 모든 사용자

    한 사이트부터 이해하기

    [대상 도메인]의 DR, UR, 백링크, 참조 도메인, 자연 검색과 AI 응답을 평가하고 강점, 위험, 추가 조사 방향과 누락 근거를 정리해 주세요.

  2. 사이트 운영자

    단일 백링크 파트너 평가

    먼저 get_my_project로 내 프로젝트의 구매 보고서를 무료로 읽어 기준으로 사용하고, 프로젝트가 없을 때만 제 URL을 물어보세요. [대상 도메인]과의 백링크 협력을 검토합니다. 목적을 확인하고 백링크, Dofollow 출처와 트래픽으로 장단점을 설명해 주세요.

  3. 모든 사용자

    단일 어필리에이트 후보 평가

    [대상 도메인]의 자연 트래픽, 상위 3개 국가, 백링크와 AI 응답을 평가하세요. 보고서 근거와 별도 확인할 독자, 수수료, 전환 자료를 구분해 주세요.

  4. 모든 사용자

    게스트 포스트 기회 평가

    [국가·독자] 대상의 [대상 도메인]에 게스트 포스트를 기고하려 합니다. 백링크, 자연 트래픽과 국가를 평가하고 장점, 위험, 편집 요건 및 링크 정책 확인 사항을 정리해 주세요.

  5. 사이트 운영자

    내 프로젝트와 한 사이트 비교

    먼저 get_my_project로 내 프로젝트의 구매 보고서를 무료로 읽어 기준으로 사용하고, 프로젝트가 없을 때만 제 URL을 물어보세요. [대상 도메인]과 [목적]에 따라 강점, 차이, 보완성과 보고서 날짜를 비교해 주세요.

  6. 사이트 운영자

    내 프로젝트와 여러 사이트 비교

    먼저 get_my_project로 내 프로젝트의 구매 보고서를 무료로 읽어 기준으로 사용하고, 프로젝트가 없을 때만 제 URL을 물어보세요. [대상 목록]을 백링크·제휴·게스트 포스트·경쟁 조사 목적으로 비교하고 장단점과 근거 부족을 밝혀 주세요.

  7. 모든 사용자

    경쟁사의 트래픽과 검색 광고

    [하나 이상의 경쟁 도메인]의 추정 자연 트래픽, 키워드, 상위 3개 국가, 유료 키워드와 추정 유료 트래픽·비용을 분석하되 실제 지출이나 수익으로 단정하지 마세요.

  8. 시장 기회 탐색

    사이트 없이 구체적 사례 조사

    사이트가 없습니다. [업종]의 [대상·후보 목록]부터 분석하고 진입 과제, 콘텐츠·AI 노출 가설과 검증할 질문을 정리하세요. 트래픽을 매출로 보지 마세요.

  9. 모든 사용자

    구매한 보고서 무료로 읽기

    최근 기록에서 제가 선택한 저장 보고서를 열고 조회·데이터 날짜와 요점을 알려 주세요. 기록만 읽고 새 조회나 크레딧 사용은 하지 마세요.

새 사이트 평가를 하려면 내 계정에서 “크레딧을 사용하는 조회 허용”을 켜고 MCP 토큰을 생성·교체한 뒤 클라이언트를 업데이트하는 것을 권장합니다. 끄면 구매한 과거 보고서만 무료로 읽을 수 있으며 새 조회는 불가합니다. 충분한 잔액과 일일 한도도 필요합니다.

구매 보고서를 먼저 읽으세요. 새 조회 전 도메인, AI 응답 포함 여부와 총 크레딧을 확인하세요. 조회·데이터 날짜와 누락을 밝히고 결론을 지어내지 마세요.

계정에서 끄기·자동·기본 켜기를 선택합니다. 끄기는 새 AI 조회 금지, 자동은 매번 선택하며 생략 시 꺼짐, 기본 켜기는 생략 시 AI 포함입니다. 기본만 명시할 수도 있습니다. include_ai: false는 1, include_ai: true는 허용 시 2크레딧. 먼저 선택과 합계를 확인합니다. 웹과 별도이며 구매 프로젝트·기록은 변경 없이 무료로 읽습니다.

기록과 새 조회 구분

access.kind는 historical_read, new_query, existing_request입니다. queriedAt은 구매/조회 시간, dataAsOf는 DR·기본·AI 데이터 시간, retrievedAt은 읽은 시간이며 ISO 8601 UTC입니다. 기록에 없는 시간은 미상으로 유지됩니다. AI에 시간과 access.billing의 차감·반환·순사용량을 제시하도록 요청하세요.

재시도 및 토큰 관리

동일 작업 재시도는 같은 request_id와 입력을 유지해 중복 구매를 방지합니다. 새 ID는 새 조회입니다. 토큰은 한 번만 표시되고 90일 후 만료됩니다. 재생성하면 이전 토큰은 무효이며 내 계정에서 취소할 수 있습니다.

연결 문제 해결

401 / 인증 실패

토큰의 만료·교체 여부와 Authorization: Bearer <token> 형식을 확인하세요.

읽기 전용 또는 일일 한도

유료 권한이나 일일 한도를 바꾼 후 토큰을 다시 생성하고 계정 잔액을 확인하세요.

브라우저에서 /mcp가 405

MCP POST용 주소이며 웹페이지가 아닙니다. Streamable HTTP는 전송 방식으로 URL에 붙이지 않습니다.

403 / 호환되지 않는 클라이언트

브라우저 클라이언트의 Origin 또는 헤더 제한일 수 있습니다. 호환 원격 HTTP 클라이언트를 사용하세요. OAuth 로그인은 제공하지 않습니다.