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.
Geen aanvraagcontingent
Het aantal MCP-aanvragen is niet begrensd — in geen enkel plan. Picasi telt de aanroepen per Workspace nog steeds mee, maar alleen voor de statistiek; een grens die de toegang blokkeert, bestaat niet.
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 Workspace. Bij zeer grote Workspaces 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 Workspace) |
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
Voor MCP-aanvragen is er geen eigen contingent. De algemene beveiligingsmechanismen van het Picasi-platform zijn van toepassing.
Zuinig bevragen loont toch:
- 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.
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.