Academy
7. Résoudre les problèmes et déconnecter des services
Diagnostiquez les connexions défaillantes causées par des autorisations expirées ou révoquées, réautorisez-les ou recréez-les, et effectuez une déconnexion propre côté OUPI comme côté service.
Lorsqu'une connexion MCP cesse de fonctionner, la cause principale est presque toujours une autorisation expirée ou révoquée du côté du service externe. Les tokens OAuth ont une durée de vie ; si le service fait tourner ou invalide le vôtre — ou si vous avez changé votre mot de passe, révoqué l'accès depuis la page des applications connectées du service, ou que le service a mis à jour ses scopes requis — la connexion devient obsolète. OUPI ne peut pas appeler d'outils via une autorisation morte, donc chaque outil exposé par cette connexion échoue silencieusement. La première étape de diagnostic est toujours le journal d'exécution : ouvrez-le pour inspecter les appels d'outil récents et vérifier leurs résultats. Une série d'échecs sur une connexion, alors que d'autres réussissent, confirme que l'autorisation est le problème, pas la plateforme.
Pour réparer une connexion défaillante, accédez à votre liste de connexions et ouvrez celle concernée. Vous avez deux options :
- Réautoriser — Si le service prend en charge le rafraîchissement de token, déclenchez la réautorisation depuis le détail de la connexion. Vous repasserez par le flux OAuth, accorderez les scopes requis, et la connexion existante (avec tous ses mappages d'outils) reste intacte.
- Recréer — Si la réautorisation n'est pas proposée ou que le service a modifié son modèle de permissions, supprimez l'ancienne connexion et créez-en une nouvelle depuis le catalogue de serveurs. Vous vous authentifierez à nouveau et accorderez les scopes mis à jour.
Comme les connexions fonctionnent à l'échelle de la plateforme (ChatPro, Studio, workflows, imports RAG, Deep Research), restaurer une connexion restaure l'accès aux outils partout simultanément.
Avant de réautoriser, ouvrez la liste d'outils de la connexion pour vérifier les outils que l'IA voit. Si le service a ajouté ou retiré des capacités, vous repérerez immédiatement l'écart — et saurez si une simple réautorisation suffit ou si une reconnexion complète avec de nouveaux scopes est nécessaire.
Une déconnexion propre nécessite une action des deux côtés. Dans OUPI, supprimez la connexion depuis le MCP Hub — cela la retire sur l'ensemble de la plateforme, de sorte qu'aucune fonctionnalité IA (badges ChatPro, agents Studio, étapes de workflow, Deep Research) ne peut plus invoquer ses outils. Ensuite, allez dans les paramètres propres du service externe (généralement sous « Applications connectées » ou « Applications autorisées ») et révoquez l'octroi OAuth. Sauter la révocation côté service laisse une autorisation en suspens qui pourrait théoriquement être réutilisée. Faire les deux garantit un nettoyage complet et auditable.
Après avoir supprimé une connexion, vérifiez le journal d'exécution une dernière fois. Tout appel d'outil en cours affichera un résultat final là, confirmant que la déconnexion a bien pris effet et qu'aucun appel résiduel n'est passé au travers.
Ouvrez votre MCP Hub → Connexions. Choisissez une connexion et ouvrez-la pour inspecter sa liste d'outils. Ensuite, accédez au journal d'exécution et filtrez par cette connexion pour examiner les résultats d'appels récents. Identifiez les éventuels échecs et notez s'ils pointent vers un problème d'autorisation.
Les connexions MCP défaillantes remontent presque toujours à des tokens OAuth expirés ou révoqués. Diagnostiquez en vérifiant les motifs d'échec dans le journal d'exécution, puis réautorisez ou recréez la connexion. Pour une déconnexion propre, supprimez la connexion dans le MCP Hub (la retire sur l'ensemble de la plateforme) et révoquez l'octroi côté service. Vérifiez toujours via le journal d'exécution qu'aucun appel résiduel ne subsiste.