본문으로 건너뛰기

문제 해결

로그인이 access_denied로 끝납니다​

권한 부여 서버가 요청을 거부한 경우입니다. 대개 클라이언트가 요청한 스코프 때문입니다.

  • NameBeta는 신원 확인용 스코프인 profile과 email만 부여합니다. API 스코프는 없으며, mcp:tools 같은 스코프를 요청하도록 설정된 클라이언트는 거부될 수 있습니다. 클라이언트에서 사용자 지정 스코프 설정을 제거하여 서버가 알리는 스코프를 사용하도록 하세요.
  • 동의 화면에서 Cancel을 클릭한 경우입니다. 연결을 다시 시작하고 액세스를 승인하세요.

요청이 invalid_token으로 실패합니다​

클라이언트가 서버에서 받아들이지 않는 토큰을 보낸 경우입니다. 401 응답에 WWW-Authenticate: Bearer … error="invalid_token"이 포함됩니다.

  • 토큰이 만료되었습니다. 보통 클라이언트가 알아서 토큰을 갱신하거나 다시 권한 부여를 받습니다. 그렇지 않다면 연결을 끊었다가 다시 연결하세요.
  • 토큰이 다른 리소스용으로 발급되었습니다. 토큰의 대상(audience)은 https://namebeta.com/api/mcp여야 합니다. 클라이언트가 권한 부여 요청에 resource=https://namebeta.com/api/mcp를 보내는지, 클라이언트에 설정된 서버 URL이 정확히 https://namebeta.com/api/mcp인지(끝에 슬래시 없음, www 없음) 확인하세요.
  • 설정에 토큰을 직접 붙여 넣었습니다. 클라이언트 설정에서 Authorization 헤더나 Bearer 토큰을 제거하고 OAuth로 로그인하도록 하세요.

클라이언트가 계속 로그인을 요청합니다​

  • 로그인이 끝까지 완료되었는지 확인하세요. 액세스를 승인한 뒤 브라우저에 앱으로 돌아가도 된다는 안내가 표시될 때까지 기다려야 합니다. 그 전에 탭을 닫으면 클라이언트가 토큰을 받지 못합니다.
  • 팝업이나 제3자 리디렉션을 차단하는 브라우저 확장 프로그램 때문에 클라이언트로 돌아가지 못할 수 있습니다. 시크릿 창에서 다시 시도하거나 auth.namebeta.com에 대한 리디렉션을 허용하세요.
  • 클라이언트에서 서버를 제거한 뒤 다시 추가하세요. 더 이상 작동하지 않는 저장된 토큰이 지워집니다.

"Does not support dynamic client registration"​

클라이언트가 Dynamic Client Registration으로만 자신을 등록할 수 있는데, NameBeta는 이를 지원하지 않습니다. Cursor와 Gemini CLI가 이런 클라이언트입니다. 사전 등록된 클라이언트 ID를 요청하거나, 새 버전에서 Client ID Metadata Documents를 지원한다면 클라이언트를 업데이트하세요.

호출이 429 또는 "quota exceeded"로 실패합니다​

요금제의 시간당 한도나 일일 한도를 모두 사용한 경우입니다. 해당 도구를 다시 호출하기 전에 Retry-After 헤더에 표시된 초만큼 기다리세요.

  • 로그인한 상태로 namebeta.com에서 조회한 것도 같은 요금제에서 차감되므로, 이 때문에 한도에 도달할 수도 있습니다.
  • 현재 사용량은 계정 패널의 Plan & Usage에서 확인할 수 있습니다.
  • 호출을 세는 방식, 각 한도가 초기화되는 시각, 요금제별 한도는 할당량에서 설명합니다.

도구가 보이지 않거나 "Tool … not found"가 표시됩니다​

NameBeta의 도구는 check_availability, compare_prices, suggest_domains, lookup_whois, lookup_dns 다섯 가지입니다.

  • 클라이언트에 표시되는 도구가 이보다 적다면 클라이언트 설정에서 일부를 꺼 두었을 수 있습니다(ChatGPT와 Cursor는 도구별로 끌 수 있습니다).
  • 호출이 MCP error -32602: Tool … not found로 실패한다면 클라이언트가 캐시된 도구 목록이나 이전 버전 서버의 도구 이름을 사용하고 있는 것입니다. 클라이언트에서 서버의 도구 목록을 새로 고치거나 다시 연결하세요. 이름이 바뀌거나 삭제된 도구는 변경 내역에서 확인할 수 있습니다.

다른 NameBeta 계정이 연결되어 있습니다​

호출은 권한 부여 과정에서 로그인한 계정에서 차감됩니다. 다른 계정을 연결하는 방법은 계정 전환에서 설명합니다.

결과가 이상해 보입니다​

  • WHOIS 레코드는 최대 1시간 동안 캐시됩니다. 누군가 1시간 이내에 같은 도메인을 조회했다면 lookup_whois는 그때 가져온 레코드를 반환하고, check_availability도 같은 1시간 동안 그 조회로 기록된 상태를 반환합니다. 방금 등록되었거나, 삭제되었거나, 복구 기간(redemption)에 들어간 도메인은 새 상태가 반영되기까지 최대 1시간이 걸릴 수 있습니다. 이 경우를 제외하면 check_availability와 lookup_dns는 호출할 때마다 네임서버에 질의합니다.
  • unknown은 DNS 확인에서 확실한 응답을 받지 못했다는 뜻입니다. 대개 네임서버가 제시간에 응답하지 않은 경우입니다. 시간 초과로 실패한 조회도 마찬가지이므로 잠시 후 다시 시도하세요.
  • 등록하기 전에 레지스트라에서 등록 가능 여부와 가격을 확인하세요.

그래도 해결되지 않나요?​

사용 중인 클라이언트, 실패한 시각(UTC), 오류 메시지를 적어 contact@namebeta.com으로 보내 주세요. SLA가 없으므로 응답 시간은 보장할 수 없습니다.

최종 수정: 에