Référence
Erreurs et limites
Interpréter un code d'erreur et dimensionner vos appels.
Mise à jour : 2026-09-09
Codes d'erreur
| Code | Ce que ça veut dire | Quoi faire |
|---|---|---|
| 401 | Jeton absent, expiré ou invalide | Redemandez un jeton |
| -32001 | Authentification refusée côté JSON-RPC | Vérifiez client_id et client_secret |
| -32003 | Outil interdit pour ce jeton | Vérifiez le module souscrit et le scope |
| -32600 | Requête JSON-RPC mal formée | Vérifiez jsonrpc, id et method |
| -32601 | Méthode ou outil inconnu | Relancez tools/list |
| -32602 | Paramètres invalides | Comparez avec le schéma de tools/list |
| -32603 | Erreur interne | Réessayez, puis contactez le support |
| 429 | Trop d'appels | Espacez les appels et réessayez après une pause |
Limites d'appel
| Point d'entrée | Limite |
|---|---|
| /api/mcp | 120 requêtes par minute |
| /api/auth/token | 20 requêtes par minute |
| API REST v1 | 120 requêtes par minute |
Réessayer proprement
- 401 et -32001 : ne réessayez pas en boucle, redemandez d'abord un jeton.
- -32602 : la requête est fausse, un réessai donnera la même erreur.
- 429 et -32603 : réessayez avec un délai croissant, trois fois au maximum.
- Groupez les lectures plutôt que d'appeler un outil par ligne d'un tableau.