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
profileeemail. Não existe escopo de API, e um cliente configurado para pedir um, comomcp: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 enviaresource=https://namebeta.com/api/mcpna solicitação de autorização e se a URL do servidor no cliente é exatamentehttps://namebeta.com/api/mcp, sem barra no final e semwww. - Um token foi colado na configuração. Remova da configuração do cliente qualquer cabeçalho
Authorizationou 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_whoisretorna o registro obtido na última vez que alguém consultou o domínio, se isso aconteceu há menos de uma hora, echeck_availabilityinforma 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_availabilityelookup_dnsconsultam os servidores de nomes no momento da chamada. unknownsignifica 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.