跳到主要内容

故障排查

登录以 access_denied 结束​

授权服务器拒绝了请求，通常是因为客户端请求的 scope 不对。

  • NameBeta 只授予身份 scope profile 和 email。不存在 API scope，如果客户端被配置为请求这类 scope（例如 mcp:tools），就可能被拒绝。请删除客户端中自定义的 scope 设置，让它使用服务器公布的 scope。
  • 你在授权确认页上点了 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 登录。

客户端反复要求我登录​

  • 确保登录流程完整走完：同意授权后，等浏览器提示可以返回应用再关闭。过早关闭标签页会导致客户端拿不到令牌。
  • 拦截弹窗或第三方跳转的浏览器扩展可能会破坏返回客户端的跳转。请在无痕窗口中重试，或允许 auth.namebeta.com 的跳转。
  • 从客户端中移除服务器后重新添加。这样可以清除已经失效的已存令牌。

「Does not support dynamic client registration」​

你的客户端只能通过 Dynamic Client Registration 注册自己，而 NameBeta 不提供这种方式。Cursor 和 Gemini CLI 就属于这类客户端。请申请预注册的 client 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 小时。 如果距离上一次有人查询该域名不到一小时，lookup_whois 会返回那次获取的记录，check_availability 在这一小时内也会返回那次查询记下的状态。刚注册、刚释放或刚进入赎回期的域名，最多可能要一小时才会显示新状态。除此之外，check_availability 和 lookup_dns 都会在调用时实时查询域名服务器。
  • unknown 表示 DNS 检查没有得到明确结果，通常是某个域名服务器没有及时响应。查询因超时失败也是同样的原因；请稍后重试。
  • 注册前，请向注册商确认可注册状态和价格。

仍未解决？​

请把你使用的客户端、失败发生的时间（UTC）和错误消息发送至 contact@namebeta.com。由于没有 SLA，我们无法承诺响应时间。

最后于 更新