Dépannage du connecteur | Documentation Prescriptio

Les cas ci-dessous partent de ce que vous voyez, dans Claude ou ChatGPT, ou dans la réponse de votre agent. Un message d'erreur n'est jamais une donnée : votre agent ne doit pas le recopier comme un fait.

Le connecteur ne se connecte pas

Claude ou ChatGPT affiche une erreur 401

C'est normal au premier appel : le serveur demande l'autorisation, et désigne dans sa réponse où la trouver. Claude ou ChatGPT doit alors ouvrir la page « Autoriser l'accès à vos données Prescriptio ». S'il ne l'ouvre pas, relancez la connexion depuis ses réglages de connecteurs ; s'il ne sait pas mener une autorisation OAuth, il ne peut pas se connecter : aucune clé d'API n'existe.

La page d'autorisation ne s'ouvre pas

Vérifiez que votre navigateur n'a pas bloqué la fenêtre, puis relancez la connexion. Si la page vous le demande, connectez-vous d'abord à Prescriptio dans ce navigateur.

La page signale une adresse de retour inconnue

Elle affiche un avertissement quand l'adresse de retour n'appartient pas à un service que Prescriptio reconnaît. N'autorisez que si vous savez précisément à qui vous donnez accès.

Les outils n'apparaissent pas

Aucun outil Prescriptio dans la conversation

La liste des outils exige une autorisation : tant qu'elle n'est pas faite, votre agent ne voit rien. Une fois connecté, ouvrez une nouvelle conversation et activez Prescriptio parmi ses connecteurs.

Votre agent ne voit que quatre outils

Vérifiez d’abord l’adresse configurée. https://prescriptio.fr/api/mcp/connectors expose quatre recherches et lectures ; leur nombre seul ne prouve pas que votre agent utilise ce profil. Pour le catalogue général dans un client compatible, configurez https://prescriptio.fr/api/mcp, autorisez l’accès, puis ouvrez une nouvelle conversation. Les outils annoncés restent filtrés par les portées accordées. Voir Seulement quatre outils.

Aucun outil qui écrit n'apparaît

Votre assistant a demandé une autorisation de lecture seule : l'écran d'autorisation l'affiche sous « Ce que l'application pourra faire », sans choix séparé de votre côté. Déconnectez l'accès dans Paramètres › Accès IA › Gérer mes connexions, puis reconnectez l'assistant et relisez ce que l'écran annonce. Si l'écriture manque encore, votre assistant ne la demande pas : écrivez à [email protected]. Écrire dans votre espace demande aussi un compte rattaché à une organisation.

Les outils apparaissent en double dans Claude Code

Prescriptio est branché deux fois. Quand le plugin et le connecteur de claude.ai visent la même adresse, Claude Code garde le connecteur de claude.ai et écarte le serveur du plugin : un seul jeu d'outils. Si vous avez aussi ajouté le serveur par commande, retirez ce doublon avec claude mcp remove prescriptio.

Un appel est refusé

Ce que vous voyez	Ce que cela veut dire	Que faire
« Quota par minute atteint. Reessaye dans 60s. » (erreur `-32004`)	Une limite passagère : 5 appels par minute pour un compte gratuit, 30 avec l'abonnement.	Attendre le délai indiqué ; une demande à la fois. Ce n'est pas une raison de s'abonner.
« Quota journalier atteint. » (erreur `-32004`)	Les appels des dernières 24 heures glissantes : 100 pour un compte gratuit, 5 000 avec l'abonnement.	Attendre que la fenêtre se libère, ou ouvrir Paramètres › Abonnement (s'ouvre dans un nouvel onglet). L'outil d'abonnement consomme lui aussi un appel.
« Quota de consultation atteint »	Les dossiers ouverts aujourd'hui : 5 pour un compte gratuit, 500 avec l'abonnement ; le compteur repart à minuit, heure de Paris.	Attendre minuit, ou passer à l'abonnement. Les dossiers déjà ouverts aujourd'hui restent lisibles, et chercher n'en consomme aucun.
Erreur `-32003`	L'autorisation ne porte pas la portée que l'outil exige (lecture ou écriture).	Reconnecter l'assistant avec une autorisation qui la couvre.
Erreur `-32601`	Outil inconnu : le nom appelé n'existe pas à cette adresse.	Demander à votre agent de relire la liste des outils, sans deviner un nom.
Erreur `-32603`	Un service dont l'outil dépend ne répond pas.	Réessayer plus tard ; ne pas rejouer une écriture sans vérifier son état.
Une réponse marquée comme erreur, qui nomme un argument ou un objet	L'outil a refusé l'appel lui-même : un argument manque ou sort du schéma, un identifiant est introuvable. Ce message est fait pour être lu par votre agent.	Laisser votre agent corriger l'argument nommé ; s'il insiste avec le même appel, reformulez la demande.
Un refus d'écriture qui demande une organisation	Votre compte n'est rattaché à aucune organisation : la lecture fonctionne, l'écriture non.	Rejoindre ou créer votre organisation dans Prescriptio, puis réessayer.

Les résultats semblent faux ou vides

Une recherche de marchés ne rend presque rien

Deux sujets dans une même requête : la recherche exige tous les mots. « étanchéité bardage » ne rend presque rien ; deux appels, « étanchéité » puis « bardage », fonctionnent.

Un département donne trop, ou rien

Une seule granularité à la fois : une région (elle couvre tous ses départements), un département ou une commune. Pour toute la France, ne donnez pas de zone.

Le dossier d'un marché n'est pas consultable

« Dossier consultable » veut dire lisible dans Prescriptio. Tous les marchés n'ont pas leur dossier récupéré : quand il manque, votre agent doit le dire, sans renvoyer vers la plateforme de l'acheteur comme s'il s'agissait du dossier.

Demander de l'aide

Faire diagnostiquer votre agent

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

À partir du message de ma dernière demande, dis-moi ce qui a bloqué et comment reprendre. S'il reste des appels disponibles, tu peux lire l'outil aide avec le sujet « quotas » ; si le quota d'appels est atteint, ne le relance pas. Ne recopie pas une erreur comme un fait.

Si rien de tout cela ne règle le problème, écrivez à [email protected] avec l'heure de l'appel (heure de Paris) et le message reçu.

Pour aller plus loin

Sécurité du connecteurLes portées, la déconnexion, le journal.L'abonnement depuis votre agentObtenir un lien s'il reste un appel, ou ouvrir directement l'abonnement.Le connecteur MCPL'adresse et les quotas.Authentification et quotasLes codes d'erreur côté API.