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 cloud.execute et vérifiez la publication, la politique d’organisation et l’accès à l’environnement d’exécution du projet

Outils d’écriture absents

Demandez un nouveau consentement cloud.write et vérifiez les autorisations explicites de l’organisation pour les outils et le projet

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.