Aller au contenu principal

Dépannage

La connexion se termine par access_denied​

Le serveur d’autorisation a refusé la requête, généralement à cause des portées demandées par le client.

  • NameBeta n’accorde que les portées d’identité profile et email. Il n’existe aucune portée d’API, et un client configuré pour en demander une — mcp:tools, par exemple — peut être refusé. Supprimez tout paramétrage de portée personnalisé dans le client pour qu’il utilise les portées annoncées par le serveur.
  • Vous avez cliqué sur Cancel sur l’écran de consentement. Relancez la connexion et autorisez l’accès.

Les requêtes échouent avec invalid_token​

Le client a envoyé un jeton que le serveur n’accepte pas. La réponse 401 contient WWW-Authenticate: Bearer … error="invalid_token".

  • Le jeton a expiré. Les clients l’actualisent ou redemandent l’autorisation d’eux-mêmes en temps normal. Si ce n’est pas le cas du vôtre, déconnectez-le puis reconnectez-le.
  • Le jeton a été émis pour une autre ressource. Les jetons doivent avoir l’audience https://namebeta.com/api/mcp. Vérifiez que le client envoie resource=https://namebeta.com/api/mcp dans la requête d’autorisation, et que l’URL du serveur configurée dans le client est exactement https://namebeta.com/api/mcp — sans barre oblique finale ni www.
  • Un jeton a été collé dans la configuration. Supprimez tout en-tête Authorization ou jeton Bearer de la configuration du client, et laissez-le se connecter via OAuth.

Le client me demande sans cesse de me connecter​

  • Assurez-vous que la connexion va jusqu’au bout : après avoir autorisé l’accès, attendez que le navigateur indique que vous pouvez revenir à l’application. Si vous fermez l’onglet trop tôt, le client n’obtient pas de jeton.
  • Les extensions de navigateur qui bloquent les fenêtres pop-up ou les redirections tierces peuvent empêcher le retour vers le client. Réessayez dans une fenêtre de navigation privée, ou autorisez les redirections pour auth.namebeta.com.
  • Supprimez le serveur du client, puis ajoutez-le de nouveau. Cela efface un jeton enregistré qui ne fonctionne plus.

« Does not support dynamic client registration »​

Votre client ne sait s’enregistrer que par Dynamic Client Registration, que NameBeta ne propose pas. C’est le cas de Cursor et de Gemini CLI. Demandez un identifiant client préenregistré, ou mettez à jour le client si une version plus récente prend en charge les Client ID Metadata Documents.

Les appels échouent avec 429 ou « quota exceeded »​

Vous avez épuisé une limite horaire ou quotidienne de votre forfait. Attendez le nombre de secondes indiqué dans l’en-tête Retry-After avant de rappeler cet outil.

  • Les recherches que vous effectuez sur namebeta.com en étant connecté sont décomptées du même forfait : elles peuvent elles aussi épuiser une limite.
  • Consultez votre consommation actuelle dans Plan & Usage, dans votre espace personnel.
  • La page Quotas explique comment les appels sont comptabilisés, quand chaque limite est réinitialisée et quelles sont les limites de chaque forfait.

Un outil manque, ou « Tool … not found »​

NameBeta propose cinq outils : check_availability, compare_prices, suggest_domains, lookup_whois et lookup_dns.

  • Si le client en affiche moins, vous en avez peut-être désactivé certains dans ses paramètres (ChatGPT et Cursor permettent de le faire outil par outil).
  • Si un appel échoue avec MCP error -32602: Tool … not found, le client utilise une liste d’outils en cache ou un nom issu d’une ancienne version du serveur. Actualisez les outils du serveur dans le client, ou reconnectez-le. Le Journal des modifications liste les outils renommés et supprimés.

Le mauvais compte NameBeta est connecté​

Les appels sont décomptés du compte avec lequel vous vous êtes connecté lors de l’autorisation. La section Changer de compte explique comment en connecter un autre.

Un résultat semble erroné​

  • Les enregistrements WHOIS sont mis en cache jusqu’à 1 heure. lookup_whois renvoie l’enregistrement récupéré lors de la dernière consultation du domaine, par n’importe quel utilisateur, si elle date de moins d’une heure, et check_availability renvoie pendant cette même heure le statut enregistré par cette consultation. Un domaine qui vient d’être enregistré, supprimé ou placé en période de rédemption peut donc mettre jusqu’à une heure à afficher son nouvel état. En dehors de ce cas, check_availability et lookup_dns interrogent les serveurs de noms au moment de l’appel.
  • unknown signifie que la vérification DNS n’a pas obtenu de réponse définitive, généralement parce qu’un serveur de noms n’a pas répondu à temps. Il en va de même pour une consultation qui échoue sur un délai d’attente dépassé : réessayez un peu plus tard.
  • Confirmez la disponibilité et le prix auprès du bureau d’enregistrement avant d’enregistrer un domaine.

Toujours bloqué ?​

Écrivez à contact@namebeta.com en précisant le client que vous utilisez, l’heure de l’échec en UTC et le message d’erreur. Il n’y a aucun SLA : nous ne pouvons donc pas garantir de délai de réponse.