Limites et dépannage
Limites
Nombre d'appels
Une connexion peut faire 60 appels par minute. Au-delà, le serveur répond 429 (« Too many requests ») avec un en-tête Retry-After qui indique combien de secondes attendre avant de réessayer. Une longue série de lectures dans la même conversation peut atteindre cette limite.
Durée d'un appel
Un appel dure 60 secondes au plus. import_prompts s'arrête avant cette limite et renvoie les lignes qu'il n'a pas eu le temps d'écrire dans pendingRows, prêtes à être envoyées dans un nouvel appel.
Taille des réponses
Les réponses sont plafonnées pour ne pas saturer la mémoire de travail de l'assistant. Quand une réponse ne contient pas tout :
- un champ
truncateddit ce qui a été laissé de côté, et un total (total, ou un compteur propre à l'outil) donne le nombre réel d'éléments ; - les listes se lisent par pages :
limitrègle la taille,offsetpasse à la page suivante dansget_audit,cursoretnextCursordanslist_prompt_performance; - les textes longs sont coupés : 500 caractères par réponse de moteur, 20 000 pour le contenu d'une suggestion.
L'assistant lit ces champs et demande la suite quand il en a besoin. Si une réponse vous semble incomplète, demandez-lui de lire la page suivante.
Taille des lots
| Outil | Maximum par appel |
|---|---|
create_prompts | 50 prompts |
move_prompts, archive_prompts, activate_prompts, remove_prompts | 100 prompts |
set_suggestion_status | 50 suggestions |
import_prompts | 500 lignes |
Pour ajouter beaucoup de prompts, préférez import_prompts. Avec create_prompts, demandez à l'assistant d'envoyer les appels un par un : des appels lancés en même temps partagent le même quota et ne voient pas ce que les autres ont écrit.
Les outils CiteMe n'apparaissent pas
- Claude : vérifiez que le connecteur CiteMe est activé dans la conversation, via le menu « + », puis « Connectors ».
- ChatGPT : vérifiez que le mode développeur est activé et que CiteMe est activé dans la conversation.
- Paquet local : vérifiez que vous êtes connecté avec
citeme login. Si vous ne l'étiez pas au démarrage du client, ou si le serveur hébergé n'a pas répondu, les outils hébergés sont remplacés par un seul,load_citeme_tools: connectez-vous, puis demandez à l'assistant de l'appeler pour les charger sans redémarrage. Si votre client ne rafraîchit pas sa liste en cours de conversation, redémarrez-le.
Un nouvel outil n'apparaît pas
Votre client garde la liste des outils obtenue à la connexion. Quand CiteMe ajoute des outils, déconnectez puis reconnectez le connecteur CiteMe dans Claude, ou rafraîchissez-le dans les réglages de ChatGPT (sinon, supprimez-le et recréez-le). Avec le paquet local, redémarrez votre client.
L'assistant ne trouve pas la bonne marque
Une connexion couvre une seule organisation, choisie selon les règles décrites dans Qui peut l'utiliser. Si la marque que vous cherchez appartient à une autre organisation, l'assistant ne la verra pas.
Quand l'organisation compte plusieurs marques, nommez le site concerné dans votre demande.
Messages d'erreur et refus
Les messages du serveur sont en anglais. Votre assistant les reformule en général.
| Le message parle de | Cause | Que faire |
|---|---|---|
« subscription » ou mcpAccess | L'organisation est en Free : le MCP demande un forfait payant. | Abonnez-vous, puis reconnectez le connecteur. Voir Forfaits. |
| « edit access », « not a viewer seat » | Votre rôle est Lecteur. | Demandez le rôle Membre ou plus à un administrateur de l'organisation. |
| « authorized for reading only » | La connexion a été autorisée en lecture seule, par exemple quand vous étiez Lecteur. | Reconnectez le connecteur pour obtenir l'écriture. |
| « no longer a member », « no longer covers » | Vous avez été retiré de l'organisation, ou votre rôle a changé. | Reconnectez le connecteur si vous avez toujours accès, sinon voyez avec un administrateur. |
| « has used its … manual audits » ou « manual tracking runs » | Le quota du forfait est atteint pour la période. | Vérifiez ce qu'il reste avec get_usage, attendez la période suivante ou changez de forfait. |
| « already in progress », « still running », « already running » | Un traitement de la même sorte tourne déjà sur cette marque. Rien de nouveau n'est lancé ni consommé. | Attendez la fin. L'assistant peut suivre l'avancement avec get_audit, get_tracking_run, get_prompt_discovery ou get_social_analysis. |
| « Several brands exist, so pass projectId » | L'organisation a plusieurs marques et la demande n'en nomme aucune. | Précisez le site concerné. |
| « not found in this organization » | La marque appartient à une autre organisation, ou l'identifiant est faux. | Vérifiez la marque. Voir L'assistant ne trouve pas la bonne marque. |
| « CiteMe could not complete this call » | Erreur interne de CiteMe. | Réessayez dans un moment. Si l'erreur persiste, écrivez au support. |
| « Too many requests » | Plus de 60 appels en une minute. | Attendez quelques secondes. |
Contacter le support
Écrivez à support@citeme.io en précisant :
- l'assistant utilisé (Claude, ChatGPT, autre client, paquet local) ;
- la date et l'heure approximatives ;
- l'outil concerné et le message d'erreur.
N'envoyez jamais votre clé CLI ni un jeton d'accès.