Corriger les erreurs MCP de Democruit et révoquer l’accès

Pour rétablir une tâche Democruit MCP qui a échoué, commencez par déterminer si le problème concerne l’autorisation, les permissions, les paramètres de l’outil, un quota produit ou la fréquence des requêtes. Chaque problème nécessite une solution différente. Se reconnecter ne rétablit pas le quota de votre forfait, et passer à un forfait supérieur ne corrige pas une permission manquante. Pour mettre fin à l’accès d’un client, ouvrez les paramètres Democruit, repérez Agents connectés, puis sélectionnez Révoquer l’accès.

Étape 1 : Lisez l’erreur avant de réessayer

Notez le nom du client, l’outil demandé, le message d’erreur et si la tâche avait déjà renvoyé un résultat. Évitez de répéter une requête d’écriture tant que son résultat n’est pas clair. Vérifiez d’abord le document concerné ou l’état de l’action afin de ne pas confondre une réponse différée avec un échec de la modification.

Servez-vous de ce tableau pour choisir la prochaine étape :

Choisissez la procédure de rétablissement selon l’erreur renvoyée avant de réessayer.

Étape 2 : Rétablissez l’autorisation ou corrigez les permissions

Si l’autorisation est manquante, suivez le processus de connexion OAuth et de consentement du client. Vérifiez que le point de terminaison est https://mcp.democruit.com/mcp et que vous connectez le bon compte. Le guide de connexion à Claude, ChatGPT et Gemini explique la configuration de chaque client. Dans Gemini CLI, utilisez /mcp auth democruit si le serveur nécessite une autorisation, puis connectez-vous dans le navigateur.

Les jetons d’accès sont valides pendant une heure. Un client peut renouveler l’accès tant que son jeton d’actualisation est valide. La durée d’une heure du jeton d’accès ne signifie donc pas nécessairement qu’il faut se connecter toutes les heures. Avec offline_access, les jetons d’actualisation sont valides pendant 30 jours avec renouvellement glissant et 90 jours au maximum. Sans cette option, ils sont valides pendant sept jours avec renouvellement glissant et 30 jours au maximum.

Si le renouvellement a expiré ou si la connexion a été révoquée, autorisez de nouveau l’accès. Les codes d’autorisation sont valides pendant cinq minutes. Recommencez la connexion si le code expire avant la fin de l’échange. Ne collez pas de jetons dans une conversation pour contourner une erreur d’autorisation.

Pour FORBIDDEN, vérifiez les permissions requises par l’outil et les portées accordées au client. Les portées de lecture et d’écriture sont distinctes selon les domaines du produit. Un processus combinant plusieurs outils nécessite les permissions d’écriture pour le CV, la lettre de motivation et l’ATS. Une connexion destinée à une tâche plus limitée peut ne pas disposer de toutes ces permissions. Ne demandez que les accès nécessaires au travail prévu.

Étape 3 : Corrigez les paramètres de l’outil

Pour INVALID_ARGUMENTS, demandez à l’assistant de vérifier les paramètres requis par l’outil et de préciser ce qui manque. Fournissez la référence du document sélectionné, la description du poste ou toute autre information demandée. Ne laissez pas l’assistant inventer des expériences ni choisir un document en se fondant uniquement sur un titre incertain.

Un paramètre manquant n’est pas un problème de facturation. Fournissez les informations requises avant d’envisager un changement de forfait. Pour TOOL_EXECUTION_FAILED, lisez l’explication renvoyée et vérifiez si un document ou une action en attente existe avant de tenter une autre opération d’écriture.

Étape 4 : Vérifiez le quota du produit et le lien de mise à niveau

Un quota produit limite l’utilisation d’une fonctionnalité en fonction de votre forfait Democruit. MCP utilise les mêmes quotas que l’application. Si un outil signale une limite de forfait, vérifiez l’utilisation de la fonctionnalité concernée dans votre compte. Consultez les tarifs Democruit pour comparer les quotas proposés avant de décider si vous souhaitez passer à un forfait supérieur.

La disponibilité des fonctionnalités et leurs quotas dépendent de votre forfait actuel. Ne supposez pas que toutes les fonctionnalités de l’application disposent d’un outil MCP, ni que vous pouvez récupérer un quota d’IA consommé en vous reconnectant, en supprimant un document ou en attendant une minute.

Par exemple, reconnecter Claude ne réinitialise pas un quota de vérification ATS épuisé. Vérifiez votre utilisation de l’ATS et les forfaits actuels avant de décider de la suite. Après avoir changé de forfait, vérifiez l’utilisation de votre compte et réessayez l’opération souhaitée une fois. Si elle reste bloquée, contactez l’assistance en indiquant l’erreur renvoyée.

Étape 5 : Réduisez les requêtes si leur fréquence est limitée

La limite de débit standard de l’API est de 500 requêtes par minute, comme celle utilisée par défaut dans l’application Democruit. Les points de terminaison d’enregistrement OAuth et de jetons ont des limites plus strictes. La limite de 500 requêtes ne permet donc pas de réessayer rapidement la connexion. Réduisez les requêtes répétées, en particulier les vérifications fréquentes pendant l’attente d’une tâche. Une réponse HTTP 429 signifie que le nombre de requêtes est trop élevé. Respectez le délai avant réessai indiqué, s’il est disponible, et ralentissez avant de réessayer. Une erreur de quota ou de limite de débit peut aussi apparaître dans TOOL_EXECUTION_FAILED. Lisez donc l’explication au lieu de vous fier uniquement à ce code général.

Attendre la fin d’une période de limitation du débit ne rétablit pas un quota produit épuisé. Une connexion peut disposer d’un quota de fonctionnalité restant tout en envoyant des requêtes trop rapidement. Vérifiez précisément la limite décrite dans le message d’erreur.

Une réponse raccourcie est un autre cas de figure. Les réponses volumineuses sont réparties en pages de 20 éléments ou résumées, sauf si detail=true. Continuez en utilisant les informations de pagination renvoyées ou demandez les détails si la tâche nécessite le contenu intégral. Une page courte ne suffit pas à indiquer une erreur de quota.

Étape 6 : Gérez une confirmation en attente ou un téléversement expiré

Les outils destructifs attendent une confirmation dans le tableau de bord Democruit. Ouvrez le lien renvoyé et vérifiez l’action exacte. L’assistant peut consulter get_action_status, mais ne doit pas annoncer qu’une suppression est terminée tant que l’approbation est en attente.

Une confirmation en attente n’est pas une erreur. Le lien d’approbation ouvre l’action dans Democruit. Vérifiez la cible avant d’approuver. Une action refusée renvoie DENIED, et une action qui n’a pas fait l’objet d’une décision finit par renvoyer EXPIRED.

La confirmation expire au bout de dix minutes. Si vous souhaitez toujours effectuer l’action après son expiration, demandez une nouvelle confirmation et vérifiez-la de nouveau. Les téléversements sont également valides pendant dix minutes et leur taille maximale est de 10 MB. Les types de téléversement « importation de CV » et « téléversement ATS » acceptent uniquement les PDF. Si le téléversement précédent expire, créez-en un nouveau en utilisant le type demandé et en respectant exactement la taille du fichier.

Étape 7 : Déconnectez le client et révoquez son accès

1. Ouvrez les paramètres du compte Democruit.
2. Repérez le client sous Agents connectés et vérifiez les portées indiquées.
3. Sélectionnez Révoquer l’accès pour la connexion que vous souhaitez arrêter.
4. Attendez la confirmation de réussite de la révocation. Si la page des paramètres signale une erreur, réessayez depuis cette page ou contactez l’assistance.
5. Supprimez ou désactivez le serveur Democruit dans votre client d’IA si vous ne souhaitez plus qu’il propose des outils ou vous demande de vous connecter.
6. Si vous reconnectez ce client ultérieurement, autorisez de nouveau l’accès et vérifiez les portées demandées.

Révoquez les identifiants dans Democruit, puis supprimez le serveur de votre client si vous ne l’utilisez plus.

La révocation désactive pour votre compte l’octroi d’autorisation du client, ses jetons d’accès et ses jetons d’actualisation. La suppression de l’entrée du serveur dans le client est une étape de configuration distincte. Utilisez la commande Révoquer l’accès de Democruit pour invalider ses identifiants.

La révocation de l’accès ne supprime ni votre compte Democruit ni vos documents. Elle bloque les futures requêtes autorisées utilisant ces identifiants. Pour les contenus déjà reçus par le client d’IA, consultez l’historique et les contrôles des données de ce client. Cette révocation ne définit aucune règle de suppression ou de conservation des données d’un autre service. Consultez la Politique de confidentialité pour connaître les pratiques de Democruit en matière de données.

Si la tâche reste bloquée

Contactez [email protected] en indiquant le nom du client, celui de l’outil et le message d’erreur. Précisez si vous étiez en train de vous connecter, de lire un document, d’enregistrer une modification ou d’attendre une confirmation. N’incluez ni mot de passe, ni jeton, ni contenu de document privé dans votre message à l’assistance.