# Limites et dépannage

> Nombre d'appels, taille des réponses, outils qui n'apparaissent pas et messages d'erreur du serveur MCP CiteMe.

Support

---

## 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 `truncated` dit 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 : `limit` règle la taille, `offset` passe à la page suivante dans `get_audit`, `cursor` et `nextCursor` dans `list_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, les outils analytiques ne sont pas chargés : connectez-vous, puis redémarrez votre client. Les versions du paquet qui proxifient tous les outils hébergés ([cli-citeme#56](https://github.com/CiteMe/cli-citeme/pull/56)) remplacent ces outils par un seul, `load_citeme_tools`, que l'assistant peut appeler après la connexion, sans redémarrage.

## 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 le bon projet {#mauvais-projet}

Une connexion couvre une seule organisation, choisie selon les règles décrites dans [Qui peut l'utiliser](./index.md#plusieurs-organisations). Si le projet que vous cherchez appartient à une autre organisation, l'assistant ne le verra pas.

Quand l'organisation compte plusieurs projets, 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 |
|---------------------|-------|-----------|
| « Starter plan or above » | L'organisation est en Free. | Passez au forfait Starter ou supérieur, puis reconnectez le connecteur. |
| « on the Pro and Expert plans » | L'outil demande un forfait supérieur au vôtre. | Voir le forfait requis dans la [référence des outils](./tools.md). |
| « 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 ce projet. 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 projects exist, so pass projectId » | L'organisation a plusieurs projets et la demande n'en nomme aucun. | Précisez le site concerné. |
| « not found in this organization » | Le projet appartient à une autre organisation, ou l'identifiant est faux. | Vérifiez le projet. Voir [L'assistant ne trouve pas le bon projet](#mauvais-projet). |
| « 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.