MCP-server — Beperkingen, time-outs en opmerkingen over de prestaties
De Picasi-MCP-server is ontworpen voor snelle gegevenstoegang (< 5 seconden). Op deze pagina staan de huidige technische beperkingen en time-outregels vermeld, zodat AI-assistenten verzoeken correct kunnen afstemmen.
Beperkingen per tool
Beperkingen per toolaanroep, zoals de server deze momenteel accepteert.
search_updates
| Parameter | Limiet |
|---|---|
limit | 1 – 100 (standaard: 20) |
days | 1 – 365 (standaard: 7) |
date_from / date_to | Willekeurige periode, overschrijft days |
Als limit op meer dan 100 wordt ingesteld, beperkt de server dit tot 100 en geeft dit aan in het meta-blok (total_available toont het daadwerkelijk beschikbare aantal).
list_sources
Geen harde bovengrenzen. Het antwoord bevat alle bronnen van de werkruimte. Bij zeer grote werkruimten wordt include_channels: false (standaard) aanbevolen om de payload klein te houden.
list_reports
| Parameter | Limiet |
|---|---|
limit | Standaard 10, geen harde bovengrens bekend |
Alle overige tools
Voor get_update_details, get_report, get_team_context, list_tags en de schrijftools gelden geen harde antwoordlimieten. Payloads zijn gekoppeld aan de bron (een rapport, een update, een team).
Reactietijden
Gegevensopvragingen zijn geoptimaliseerd voor reactietijden van minder dan een seconde.
| Tool | Verwachte reactietijd |
|---|---|
search_updates | doorgaans < 1 s |
list_sources | doorgaans < 1 s (zonder kanalen) |
list_sources met include_channels: true | 1 – 3 s (afhankelijk van de werkruimte) |
get_update_details | doorgaans < 1 s |
get_report | 1 – 3 s (afhankelijk van het rapport) |
get_team_context | typisch < 1 s |
Schrijftools (create_*, update_*, delete_*, toggle_*) | doorgaans < 2 s |
MCP-time-outs
De Picasi-server legt geen eigen server-time-out op. De time-outs van de betreffende AI-client zijn van toepassing.
| Client | Effectieve client-time-out |
|---|---|
| Claude Code (CLI) | Standaard 30 s per tool-aanroep |
| Claude.ai | Standaard 30 s per tool-aanroep |
| ChatGPT (aangepaste connector) | Standaard 30 s per tool-aanroep |
Daarom zijn analysetools met lange looptijden (generate_feedback, summarize_updates — 15 tot 45 seconden) momenteel uitgeschakeld. Gebruik voor langere analyses de Picasi-app of haal de resultaten van een reeds gegenereerd rapport op via get_report.
Snelheidsbeperking
De MCP-server maakt momenteel geen gebruik van speciale middleware voor snelheidsbeperking. De algemene beveiligingsmechanismen van het Picasi-platform (authenticatie-snelheidslimieten, WAF) zijn van toepassing.
Aanbeveling voor client-implementaties:
- Sla resultaten op in de cache wanneer identieke zoekopdrachten herhaaldelijk worden uitgevoerd.
- Stel bij bulkverwerkingen
limitdoelgericht in, in plaats van in een lus te pagineren via kleine pagina’s. - Geef bij meerdere parallelle verzoeken de voorkeur aan één enkele toolaanroep per logische vraag.
Zodra de MCP-server een snelheidsbeperking instelt, wordt deze pagina bijgewerkt met cijfers en HTTP-header-gedrag (Retry-After, X-RateLimit-*).
Payload-structuur
Alle tool-antwoorden bevatten drie blokken:
result– gebruiksgegevens (updates, bronnen, rapporten, …)meta– uitvoeringstijd, toegepaste filters,total_availablebij zoekopdrachtenhints– suggesties voor zinvolle vervolgverzoeken
total_available in meta geeft aan hoeveel resultaten er in totaal zouden zijn, zonder dat deze zijn geretourneerd. Zo kan de client beslissen of een gerichte aanvraag zinvol is.