Dépannage MCP
Trouvez l’étape suivante pour résoudre un problème de connexion.
Impossible de connecter un client hébergé
Vérifiez que l’URL configurée est https://mcp.altifigence.com/cloud-mcp et que le client prend en charge Streamable HTTP avec OAuth. Suivez les instructions de connexion et l’état actuel de qualification. La page de santé du serveur et les métadonnées OAuth ne prouvent pas qu’un client donné a terminé son autorisation.
Résultat | Étape suivante |
|---|---|
HTTP 401 | Reconnectez Altifigence Cloud si l’autorisation a expiré ou a été révoquée ; effectuez à nouveau le parcours d’autorisation du client |
HTTP 403 | Vérifiez l’organisation consentie, l’accès actuel au projet et la politique des outils ; reconnectez-vous avec l’autorisation requise après l’activation de l’outil par l’organisation |
Outils vides ou absents | Vérifiez le catalogue publié, l’approbation explicite de l’organisation et un nouveau consentement pour chaque outil ; actualiser un ancien jeton ne peut pas ajouter d’outils |
Lecture de l’espace de travail indisponible | Vérifiez l’état de l’espace de travail et l’accès dans Cloud ; réessayez lorsqu’il est prêt |
Outils d’exécution absents | Demandez un nouveau consentement |
Outils d’écriture absents | Demandez un nouveau consentement |
Conflit de modification de fichier | Relisez le manifeste et le fichier, examinez les changements simultanés, puis soumettez la modification voulue avec les révisions actuelles |
Création de projet ou modification Git non confirmée | Inspectez la liste des projets, le dépôt ou l’état distant avant de réessayer ; une création, un commit ou un push répété peut avoir des effets indésirables |
Suppression de projet acceptée | Suivez l’état du projet/de l’espace de travail jusqu’à la fin du nettoyage ; accepté ne signifie pas terminé |
Transfert du fournisseur Git refusé | Vérifiez le dépôt sélectionné, la branche et la connexion actuelle au fournisseur ; l’outil ne peut pas contourner les autorisations du fournisseur |
Opération d’exécution non confirmée | Lisez l’état d’exécution et conservez l’identifiant d’opération ; la reprise utilise l’identifiant d’opération de l’environnement arrêté |
Génération du projet, version du fichier ou politique modifiée | Obtenez une nouvelle estimation et examinez l’offre sélectionnée et la politique de consommation |
Soumission non confirmée | Inspectez le même identifiant de tâche ; réessayez uniquement avec des arguments identiques et ce même identifiant |
Résultat pas encore prêt | Lisez l’état de la tâche avant de redemander le résultat |
Crédits insuffisants | Examinez l’état de facturation de l’organisation dans Cloud |
HTTP 413 | Réduisez la requête aux arguments du schéma d’outil découvert |
HTTP 501 provenant d’un outil local | L’environnement d’exécution installé n’implémente pas cette opération ; la découverte seule ne prouve pas sa prise en charge |
HTTP 503 | Attendez le rétablissement du service ; conservez le point de terminaison configuré |
Une requête de lecture ne démarre ni ne redémarre un projet. Les noms d’outils inconnus ou non autorisés n’activent pas l’édition ou l’exécution. Corrigez la connexion ou la condition d’accès avant de réessayer ; ne fournissez pas d’autres identifiants dans les arguments.
Trop de requêtes
Si une réponse comprend HTTP 429, attendez la durée indiquée par Retry-After avant de réessayer. Évitez les tentatives répétées d’enregistrement ou de connexion.
Contacter le support
Contactez le support Altifigence avec le nom du client, sa version, l’heure du problème et le message d’erreur après suppression des informations sensibles. N’incluez pas d’identifiants, de cookies ou de contenu de projet.
Récupérer sans dupliquer les opérations
Point d’échec | Éléments à inspecter avant de réessayer |
|---|---|
Identité ou découverte | Version du client, point de terminaison, connexion/session et liste des outils consentis. |
Continuation de lecture de fichier | Versions du fichier et du manifeste ; redémarrez si l’instantané change. |
Écriture de fichier, commit ou push | Fichier enregistré actuel, dépôt et état distant. |
Soumission de tâche | Identifiant et état de la tâche existante ; conservez l’identité originale. |
Entrée de terminal ou requête IA | Session/sortie actuelle ; ne rejouez pas automatiquement l’entrée. |
Enregistrez la plus petite requête reproductible avec des paramètres fictifs pour les données du projet. Préservez le code d’erreur, le statut HTTP, l’identifiant de requête s’il est affiché et l’horodatage. Retirez les jetons et le contenu des sources avant de partager un diagnostic.