본문으로 건너뛰기

할당량

용어​

  • 할당량은 요금제에서 허용하는 사용량입니다. 할당량이 적용되는 도구에는 각각 시간당 한도와 일일 한도가 있습니다.
  • 버킷은 whois나 query 같은 조회 종류 하나를 가리킵니다. 도구 호출은 하나의 버킷에서 차감되며, 버킷마다 한도가 따로 있습니다. 웹사이트에서의 사용도 같은 버킷에서 차감됩니다.

호출을 세는 방식​

MCP 호출은 NameBeta 요금제에서 웹사이트와 같은 버킷으로 차감됩니다. namebeta.com에서 WHOIS를 조회하는 것과 lookup_whois를 호출하는 것은 같은 할당량을 사용하며, 둘 다 계정 패널의 Plan & Usage에 표시됩니다.

  • tools/call만 차감됩니다. initialize, tools/list, ping 등 다른 프로토콜 요청은 무료입니다.
  • 호출 한 번은 내용과 관계없이 한 번으로 셉니다. 도메인 20개를 넣은 check_availability 호출도 한 번입니다.
  • suggest_domains는 무료입니다. 웹사이트의 추천 기능과 마찬가지입니다.
  • 호출은 도구가 실행되기 전, 접수되는 시점에 차감됩니다. 잘못된 도메인이나 응답하지 않는 WHOIS 서버처럼 도구 오류로 끝난 호출도 차감됩니다. 존재하지 않는 도구를 호출한 경우는 차감되지 않습니다.
  • 거부된 호출은 차감되지 않습니다. 한도를 넘었을 때 받는 429 응답에는 비용이 들지 않습니다.
  • 한도는 요금제에 따라 정해집니다. MCP는 항상 로그인한 사용자로 실행되므로 웹사이트의 비로그인 한도는 적용되지 않습니다.

한도​

호출은 해당 버킷의 시간당 한도와 일일 한도를 모두 넘지 않아야 합니다.

도구버킷무료 (시간 / 일)프로 (시간 / 일)비즈니스 (시간 / 일)엔터프라이즈 (시간 / 일)
check_availability 모든 베어 레이블 포함query90 / 450360 / 1,800600 / 3,000무제한
check_availability 전체 도메인 이름만 포함check45 / 135120 / 360300 / 900무제한
compare_prices single150 / 2501,200 / 3,6002,000 / 8,000무제한
suggest_domains 카운트되지 않음
lookup_whois whois5 / 1560 / 200150 / 500무제한
lookup_dns dns20 / 50200 / 400500 / 1,000무제한

check_availability는 입력에 따라 두 버킷 중 하나에서 차감됩니다. 자세한 내용은 해당 도구의 할당량 섹션을 참고하세요. 요금제와 가격은 namebeta.com/ko/pricing에서 확인할 수 있습니다.

한도가 초기화되는 시각​

기준 시각은 UTC입니다

할당량 기간은 고정되어 있으며, 사용자의 시간대와 관계없이 UTC를 기준으로 합니다.

  • 시간당 한도는 UTC 기준 매시 정각(13:00, 14:00, 15:00 UTC 등)에 초기화됩니다.
  • 일일 한도는 00:00 UTC에 초기화됩니다. 서울과 도쿄에서는 오전 9시, 베이징에서는 오전 8시, 샌프란시스코에서는 전날 오후 4시 또는 5시입니다.

기간은 롤링 방식이 아닙니다. 13:59 UTC와 14:00 UTC에 한 호출은 서로 다른 시간대에 속하므로, 매 UTC 정각마다 시간당 할당량 전체를 다시 사용할 수 있습니다.

한도 초과: 429와 Retry-After​

어느 한도든 넘은 호출은 도구에 도달하기 전에 HTTP 수준에서 거부됩니다.

HTTP/1.1 429 Too Many Requests
Retry-After: 1260
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "error": {
        "code": -32000,
        "message": "MCP hourly quota exceeded.",
        "data": { "retryAfter": 1260 }
    },
    "id": 7
}
항목값
상태 코드시간당 한도와 일일 한도 모두 항상 429 Too Many Requests
Retry-After 헤더초과한 기간이 초기화될 때까지 남은 초. 시간당 한도는 1–3600, 일일 한도는 1–86400
error.code-32000
error.messageMCP hourly quota exceeded. 또는 MCP daily quota exceeded.
error.data.retryAfterRetry-After와 같은 초
id요청의 id

일일 한도를 먼저 확인합니다. 두 한도를 모두 소진했다면 응답은 일일 한도를 알리고, Retry-After는 00:00 UTC를 가리킵니다. 다음 정각에 다시 시도해도 또 실패하기 때문입니다.

클라이언트가 해야 할 일​

  • 같은 도구를 다시 호출하기 전에 최소한 Retry-After초만큼 기다립니다. 그보다 일찍 다시 시도하면 또 429로 거부됩니다.
  • 다른 버킷에는 영향이 없습니다. lookup_whois가 한도에 도달해도 lookup_dns와 compare_prices는 계속 사용할 수 있습니다.
  • 반복해서 재시도하지 말고 한도가 언제 초기화되는지 사용자에게 알립니다. 일일 한도라면 거의 하루를 기다려야 할 수도 있습니다.
최종 수정: 에