Erreurs et dépannage

Cette page décrit les messages d'erreur de l'application, leur cause et la solution. Chaque message affiche un lien « ? » vers la section correspondante.

Erreurs de compte

Session expirée (UNAUTHENTICATED)

Cause. Votre session a expiré ou n'est plus valide, par exemple après un changement de mot de passe sur un autre appareil.

Solution. Reconnectez-vous.

Email ou mot de passe incorrect (INVALID_CREDENTIALS)

Cause. L'email ou le mot de passe saisi ne correspond à aucun compte.

Solution. Vérifiez la saisie. En cas d'oubli, utilisez « Mot de passe oublié ? ».

Trop de tentatives (ACCOUNT_LOCKED)

Cause. Après 5 échecs de connexion, le compte est bloqué 15 minutes.

Solution. Patientez 15 minutes, puis réessayez avec le bon mot de passe, ou réinitialisez-le.

Email non vérifié (EMAIL_NOT_VERIFIED)

Cause. L'adresse email du compte n'a pas été vérifiée.

Solution. Ouvrez le lien de vérification reçu par email (valable 24 heures). S'il a expiré ou n'est jamais arrivé, connectez-vous et cliquez sur « Renvoyer le lien ».

Adresse déjà utilisée (EMAIL_TAKEN)

Cause. L'adresse saisie à l'inscription ou lors d'un changement d'email appartient déjà à un autre compte.

Solution. À l'inscription, cliquez sur « Se connecter », ou sur « Mot de passe oublié ? » si vous ne vous souvenez plus du mot de passe. Pour un changement d'email, choisissez une autre adresse. Voir Email.

Lien invalide ou expiré (TOKEN_INVALID)

Cause. Le lien reçu par email a déjà été utilisé ou a expiré. Les liens sont valables 1 heure (bienvenue, réinitialisation) ou 24 heures (vérification, changement d'email).

Solution. Redemandez un lien, par exemple avec « Mot de passe oublié ? ».

Erreurs de serveur et d'offre

Espace suspendu (WORKSPACE_SUSPENDED)

Cause. Votre espace est suspendu : l'accès est restreint et les appels MCP sont refusés.

Solution. Contactez l'équipe Voozeo pour connaître la raison et rétablir l'accès.

Introuvable (NOT_FOUND)

Cause. L'élément demandé n'existe pas ou a été supprimé, par exemple un serveur supprimé dans un autre onglet.

Solution. Retournez à la liste des serveurs et actualisez la page.

Limite de l'offre atteinte (PLAN_LIMIT_REACHED)

Cause. Vous avez atteint une limite de votre offre : nombre de serveurs, outils actifs, texte des documents par serveur ou 1 000 documents. Une offre aux limites plus basses que votre utilisation ne supprime rien : elle bloque seulement les nouvelles créations.

Solution. Supprimez ou désactivez ce dont vous n'avez plus besoin, puis réessayez. Voir Quotas et offres. Une offre aux limites plus hautes peut se demander depuis l'écran « Offres » : le bouton « Passer à » affiché à côté du message ouvre le formulaire de demande.

Quota mensuel atteint (QUOTA_EXCEEDED)

Cause. Vous avez épuisé vos appels MCP du mois, bac à sable compris.

Solution. Attendez le 1er du mois suivant (UTC). Voir Quand le quota est atteint.

Demande d'offre déjà en attente (REQUEST_PENDING)

Cause. Vous avez déjà une demande d'offre en attente de décision.

Solution. Attendez la réponse de Voozeo, ou annulez la demande depuis le bandeau de l'écran « Offres » puis envoyez-en une nouvelle. Voir Demander une offre.

Trop de demandes (RATE_LIMITED)

Cause. Vous avez envoyé trop de demandes d'offre en 24 heures, ou trop de requêtes en peu de temps.

Solution. Patientez un peu puis réessayez. Voir Demander une offre.

Envoi plus en attente (CONFLICT)

Cause. L'envoi en cours, par exemple celui d'une icône de serveur, a été remplacé ou n'est plus en attente. Le même code est renvoyé si vous essayez de régénérer la clé MCP d'un serveur dont l'API cible utilise OAuth 2.0 : un tel serveur n'a pas de clé.

Solution. Recommencez l'envoi. Pour un serveur en OAuth, connectez plutôt l'IA en OAuth (voir Serveurs en OAuth).

Connexion OAuth requise (OAUTH_REQUIRED)

Cause. Dans le bac à sable, vous avez exécuté un outil de l'API d'un serveur dont l'API cible utilise OAuth 2.0. Cet outil a besoin du jeton d'une personne connectée chez le fournisseur, que seule une IA connectée en OAuth possède. Rien n'a été appelé et le quota est inchangé.

Solution. Testez l'outil depuis votre IA connectée en OAuth (voir Serveurs en OAuth). Les outils documents restent testables dans le bac à sable.

Identifiant transmis requis (CREDENTIAL_REQUIRED)

Cause. Dans le bac à sable, vous avez exécuté un outil de l'API d'un serveur dont l'API cible utilise « Transmis par l'appelant » sans saisir l'« Identifiant transmis ». Rien n'a été appelé et le quota est inchangé.

Solution. Saisissez l'identifiant attendu par votre API dans le champ de l'onglet « Test ». Voir Identifiants par utilisateur avec une passerelle OAuth.

Image invalide (INVALID_IMAGE)

Cause. L'icône est vide, tronquée ou contient un contenu interdit (SVG).

Solution. Exportez l'image à nouveau ou utilisez un PNG. Les formats acceptés sont PNG, JPEG, WEBP ou SVG, 256 Ko au maximum.

Erreurs d'import

Version OpenAPI non prise en charge (UNSUPPORTED_SPEC_VERSION)

Cause. Le document déclare une version autre qu'OpenAPI 3.0.x ou 3.1.x, par exemple Swagger 2.0.

Solution. Convertissez la spécification en OpenAPI 3.0 ou 3.1, puis réimportez-la. Voir Formats acceptés.

Document OpenAPI invalide (INVALID_SPEC)

Cause. Le fichier est vide, il n'est ni du JSON ni du YAML valide, il n'a pas de section paths, il ne contient aucune opération, ou il en contient plus de 1 000.

Solution. Validez le fichier dans un éditeur OpenAPI, corrigez-le, puis réimportez-le. Le détail du problème est affiché sur la source en échec.

Traitement trop long (INGESTION_TIMEOUT)

Cause. L'analyse du fichier a dépassé 28 secondes.

Solution. Essayez un fichier plus petit, ou découpez un gros document en plusieurs fichiers.

Trop de documents à indexer (SOURCE_MEMORY_LIMIT)

Cause. Le texte total des documents du serveur dépasse ce que Voozeo peut indexer d'un coup avec la capacité actuelle. La source passe en « Échec » et rien n'est publié : les documents déjà prêts continuent de fonctionner.

Solution. Retirez des documents, puis ajoutez de nouveau le nouveau. Si vous avez besoin de ce volume, contactez l'équipe Voozeo.

Fichier trop volumineux (FILE_TOO_LARGE)

Cause. Le fichier dépasse la taille maximale : 5 MB pour une spécification OpenAPI, 10 MB par document.

Solution. Réduisez le fichier ou découpez-le. Voir Tailles et limites.

Type de fichier non pris en charge (UNSUPPORTED_FILE_TYPE)

Cause. L'extension n'est pas acceptée, ou le contenu ne correspond pas à l'extension (par exemple un fichier .pdf qui n'est pas un PDF).

Solution. Utilisez un PDF, un fichier Word (.docx), Markdown (.md, .markdown) ou texte (.txt) valide.

Aucun texte extrait (NO_TEXT_EXTRACTED)

Cause. Le document ne contient aucun texte exploitable, typiquement un PDF scanné : il n'y a pas de reconnaissance de caractères (OCR).

Solution. Fournissez une version avec du texte sélectionnable. Voir PDF scanné.

URL non autorisée (UNSAFE_URL)

Cause. L'URL d'import n'est pas en HTTPS ou pointe vers une adresse non publique (réseau interne, adresse locale).

Solution. Utilisez une URL HTTPS publique, par exemple https://api.example.com/openapi.json, ou importez le fichier directement.

Fichier distant non téléchargé (UPSTREAM_FETCH_FAILED)

Cause. Le téléchargement a échoué : le serveur distant a répondu autre chose que 2xx, ou n'a pas répondu en 10 secondes.

Solution. Vérifiez que l'URL s'ouvre sans authentification dans un navigateur, ou téléchargez le fichier et importez-le. Voir Importer par URL.

Côté IA

Ces cas se voient dans votre client IA, pas dans l'application. Voir aussi Dépannage de la connexion.

Clé MCP refusée (401)

Cause. La clé est absente, invalide, régénérée depuis, ou appartient à un autre serveur.

Solution. Copiez à nouveau l'URL ou la configuration depuis l'onglet « Connexion ». Si la clé a été perdue, régénérez-la dans l'onglet « Connexion » : l'ancienne cesse immédiatement de fonctionner.

Connexion demandée (401, OAuth)

Cause. Sur un serveur dont l'API cible utilise OAuth 2.0, la connexion de l'IA n'est plus valide : elle a expiré ou a été révoquée (par vous, par un changement des réglages OAuth ou chez le fournisseur), le fournisseur a refusé de la renouveler, ou l'IA n'a pas servi pendant 30 jours et son enregistrement a expiré. Une clé MCP est aussi refusée sur un tel serveur.

Solution. La plupart des IA proposent d'elles-mêmes de se reconnecter : suivez la page du navigateur. Si l'IA échoue encore, supprimez le serveur de l'IA puis ajoutez-le à nouveau avec son URL (voir Serveurs en OAuth).

Serveur désactivé ou espace suspendu (403)

Cause. Le serveur n'est pas actif (brouillon ou désactivé : « Server is not active »), ou l'espace est suspendu (« Workspace is suspended »).

Solution. Activez le serveur, ou ajoutez d'abord une source pour qu'il passe de brouillon à actif. Voir États d'un serveur.

Quota atteint côté IA

Cause. Les appels MCP du mois sont consommés. L'outil répond par une erreur d'outil : Monthly quota reached. Upgrade your plan: suivi d'un lien vers la page des tarifs de Voozeo.

Solution. Attendez le 1er du mois suivant (UTC). Voir Quotas et offres.

Outil inconnu

Cause. L'IA a appelé un nom d'outil qui n'existe pas sur le serveur, ou qui est désactivé, souvent une faute de frappe ou une liste d'outils périmée. L'IA reçoit le message « Unknown tool: » suivi du nom et votre API n'est pas appelée. L'appel est journalisé à l'étape « Outil inconnu », avec le nom demandé dans son détail ; il ne compte pas dans le quota.

Solution. Vérifiez le nom de l'outil dans l'onglet « Outils » et qu'il est activé. Si le nom est correct, demandez à l'IA de rafraîchir sa liste d'outils (reconnectez le serveur). Le bloc Top des erreurs montre les noms les plus demandés.

Paramètre manquant

Cause. L'IA a appelé un outil sans un paramètre obligatoire. Elle reçoit « Missing required parameter(s): id, body » (les noms manquants) et votre API n'est pas appelée. L'appel est journalisé à l'étape « Entrée invalide » et compte dans le quota.

Solution. Vérifiez dans l'onglet « Outils » quels paramètres sont obligatoires, et que leurs descriptions disent à l'IA quoi envoyer. Le bac à sable affiche le même message.

Autres erreurs

Champs invalides (VALIDATION_ERROR)

Cause. Un ou plusieurs champs du formulaire ne respectent pas les règles attendues (longueur, format, valeur obligatoire).

Solution. Corrigez les champs signalés, puis validez à nouveau. Exemple : un nom de serveur doit compter de 1 à 60 caractères.

Erreur inattendue (INTERNAL_ERROR)

Cause. Une erreur imprévue s'est produite côté Voozeo.

Solution. Réessayez dans un instant. Si elle persiste, contactez l'équipe Voozeo en indiquant l'action effectuée.

Deux autres messages n'ont pas de code à rechercher. « Impossible de joindre Voozeo » signifie que votre connexion internet est coupée ou instable : vérifiez-la, puis réessayez. « Trop de requêtes » signifie que vous avez envoyé beaucoup de requêtes en peu de temps : patientez un instant, puis réessayez.