Serveur MCP — Limites, délais d'expiration et remarques sur les performances
Le serveur Picasi-MCP est conçu pour permettre un accès rapide aux données (< 5 secondes). Cette page répertorie les limites techniques actuelles et les règles de délai d’expiration afin que les assistants IA dimensionnent correctement leurs requêtes.
Limites des outils
Limites par appel d’outil, telles qu’elles sont actuellement acceptées par le serveur.
search_updates
| Paramètre | Limite |
|---|---|
limit | 1 – 100 (par défaut : 20) |
days | 1 – 365 (par défaut : 7) |
date_from / date_to | Durée au choix, remplace days |
Si limit est défini sur une valeur supérieure à 100, le serveur limite la valeur à 100 et l’indique dans le bloc meta (total_available affiche le nombre réellement disponible).
list_sources
Pas de limite maximale stricte. La réponse contient toutes les sources de l’espace de travail. Pour les très grands espaces de travail, il est recommandé d’utiliser include_channels: false (par défaut) afin de limiter la taille de la charge utile.
list_reports
| Paramètre | Limite |
|---|---|
limit | Par défaut 10, aucune limite stricte connue |
Tous les autres outils
Pour get_update_details, get_report, get_team_context, list_tags ainsi que les outils d’écriture, il n’y a pas de limites strictes pour les réponses. Les charges utiles sont liées à la ressource (un rapport, une mise à jour, une équipe).
Temps de réponse
Les requêtes de données sont optimisées pour une réponse en moins d’une seconde.
| Outil | Temps de réponse attendu |
|---|---|
search_updates | généralement < 1 s |
list_sources | généralement < 1 s (sans canaux) |
list_sources avec include_channels: true | 1 à 3 s (selon l’espace de travail) |
get_update_details | généralement < 1 s |
get_report | 1 à 3 s (en fonction du rapport) |
get_team_context | généralement < 1 s |
Outils d’écriture (create_*, update_*, delete_*, toggle_*) | généralement < 2 s |
Délais d’expiration MCP
Le serveur Picasi n’impose pas de délai d’expiration propre. Ce sont les délais d’expiration des clients IA respectifs qui s’appliquent.
| Client | Délai d’expiration effectif du client |
|---|---|
| Claude Code (CLI) | Par défaut : 30 s par appel d’outil |
| Claude.ai | Par défaut : 30 s par appel d’outil |
| ChatGPT (connecteur personnalisé) | Par défaut : 30 s par appel d’outil |
C’est pourquoi les outils d’analyse dont l’exécution est longue (generate_feedback, summarize_updates — 15 à 45 secondes) sont actuellement désactivés. Pour des analyses plus longues, utilisez l’application Picasi ou récupérez les résultats d’un rapport déjà généré via get_report.
Limitation du débit
Le serveur MCP n’utilise actuellement aucun middleware dédié à la limitation du débit. Les mécanismes de protection généraux de la plateforme Picasi s’appliquent (limites de débit d’authentification, WAF).
Recommandations pour les implémentations client :
- Mettre les résultats en cache lorsque des requêtes identiques sont répétées.
- Pour les analyses en masse, définir spécifiquement
limitau lieu de paginer en boucle sur de petites pages. - En cas de requêtes parallèles multiples, privilégier un seul appel à l’outil par question logique.
Dès que le serveur MCP applique une limitation de débit, cette page est mise à jour avec les chiffres et le comportement des en-têtes HTTP (Retry-After, X-RateLimit-*).
Structure de la charge utile
Toutes les réponses de l’outil fournissent trois blocs :
result– Données utiles (mises à jour, sources, rapports, …)meta– Temps d’exécution, filtres appliqués,total_availableen cas de recherchehints– Suggestions d’appels suivants pertinents
total_available dans meta indique le nombre total de résultats qui existeraient sans avoir été renvoyés. Le client peut ainsi décider s’il est pertinent d’effectuer une requête ciblée.