Pular para o conteúdo principal

Solução de problemas

O login termina com access_denied​

O servidor de autorização recusou a solicitação, normalmente por causa dos escopos que o cliente pediu.

  • O NameBeta concede apenas os escopos de identidade profile e email. Não existe escopo de API, e um cliente configurado para pedir um, como mcp:tools, pode ser recusado. Remova qualquer configuração de escopo personalizada do cliente para que ele use os escopos anunciados pelo servidor.
  • Você clicou em Cancel na tela de consentimento. Inicie a conexão de novo e aprove o acesso.

As solicitações falham com invalid_token​

O cliente enviou um token que o servidor não aceita. A resposta 401 traz WWW-Authenticate: Bearer … error="invalid_token".

  • O token expirou. Normalmente os clientes atualizam o token ou pedem autorização de novo por conta própria. Se o seu não fizer isso, desconecte e conecte novamente.
  • O token foi emitido para outro recurso. Os tokens precisam ter a audiência https://namebeta.com/api/mcp. Verifique se o cliente envia resource=https://namebeta.com/api/mcp na solicitação de autorização e se a URL do servidor no cliente é exatamente https://namebeta.com/api/mcp, sem barra no final e sem www.
  • Um token foi colado na configuração. Remova da configuração do cliente qualquer cabeçalho Authorization ou token Bearer e deixe que ele faça login via OAuth.

O cliente pede login repetidamente​

  • Garanta que o login seja concluído: depois de aprovar o acesso, espere até o navegador informar que você pode voltar ao aplicativo. Fechar a aba antes disso deixa o cliente sem token.
  • Extensões do navegador que bloqueiam pop-ups ou redirecionamentos de terceiros podem impedir o retorno ao cliente. Tente de novo em uma janela anônima ou permita redirecionamentos para auth.namebeta.com.
  • Remova o servidor do cliente e adicione-o novamente. Isso apaga um token armazenado que deixou de funcionar.

"Does not support dynamic client registration"​

O seu cliente só consegue se registrar por Dynamic Client Registration, que o NameBeta não oferece. O Cursor e o Gemini CLI são clientes desse tipo. Solicite um ID de cliente pré-registrado ou atualize o cliente, caso uma versão mais recente ofereça suporte a Client ID Metadata Documents.

As chamadas falham com 429 ou "quota exceeded"​

Você esgotou um limite por hora ou diário do seu plano. Aguarde o número de segundos indicado no cabeçalho Retry-After antes de chamar essa ferramenta de novo.

  • As consultas que você faz em namebeta.com com a conta conectada consomem o mesmo plano, então também podem esgotar um limite.
  • Confira seu uso atual em Plan & Usage no seu painel da conta.
  • Cotas explica como as chamadas são contabilizadas, quando cada limite é reiniciado e quais são os limites de cada plano.

Falta uma ferramenta, ou "Tool … not found"​

O NameBeta tem cinco ferramentas: check_availability, compare_prices, suggest_domains, lookup_whois e lookup_dns.

  • Se o cliente listar menos, talvez você tenha desativado algumas nas configurações dele (o ChatGPT e o Cursor permitem fazer isso ferramenta por ferramenta).
  • Se uma chamada falhar com MCP error -32602: Tool … not found, o cliente está usando uma lista de ferramentas em cache ou um nome de uma versão anterior do servidor. Atualize as ferramentas do servidor no cliente ou reconecte. O Histórico de alterações lista as ferramentas renomeadas e removidas.

A conta do NameBeta conectada não é a certa​

As chamadas consomem a cota da conta usada no login durante a autorização. Trocar de conta explica como conectar outra.

Um resultado parece errado​

  • Os registros WHOIS ficam em cache por até 1 hora. lookup_whois retorna o registro obtido na última vez que alguém consultou o domínio, se isso aconteceu há menos de uma hora, e check_availability informa o status registrado por essa consulta durante a mesma hora. Um domínio que acabou de ser registrado, liberado ou colocado em redemption pode levar até uma hora para mostrar o novo estado. Fora isso, check_availability e lookup_dns consultam os servidores de nomes no momento da chamada.
  • unknown significa que a verificação de DNS não obteve uma resposta definitiva, normalmente porque um servidor de nomes não respondeu a tempo. O mesmo vale para uma consulta que falha por tempo esgotado; tente de novo um pouco mais tarde.
  • Confirme a disponibilidade e o preço com o registrador antes de registrar.

Ainda com problemas?​

Escreva para contact@namebeta.com informando o cliente que você usa, o horário da falha em UTC e a mensagem de erro. Não há SLA, então não podemos garantir um prazo de resposta.