Server MCP — Limiti, timeout e note sulle prestazioni
Il server Picasi-MCP è progettato per garantire un accesso rapido ai dati (< 5 secondi). Questa pagina elenca i limiti tecnici attuali e le regole relative al timeout, affinché gli assistenti IA possano dimensionare correttamente le richieste.
Limiti degli strumenti
Limiti per ogni chiamata allo strumento, così come attualmente accettati dal server.
search_updates
| Parametro | Limite |
|---|---|
limit | 1 – 100 (predefinito: 20) |
days | 1 – 365 (predefinito: 7) |
date_from / date_to | Intervallo di tempo a scelta, sovrascrive days |
Se limit viene impostato su un valore superiore a 100, il server lo riduce a 100 e lo indica nel blocco meta (total_available mostra il numero effettivamente disponibile).
list_sources
Nessun limite massimo rigido. La risposta contiene tutte le fonti dell’area di lavoro. In caso di aree di lavoro molto grandi, si consiglia di utilizzare include_channels: false (impostazione predefinita) per mantenere ridotto il payload.
list_reports
| Parametro | Limite |
|---|---|
limit | Predefinito 10, nessun limite massimo rigido noto |
Tutti gli altri strumenti
Per get_update_details, get_report, get_team_context, list_tags e gli strumenti di scrittura non esistono limiti rigidi di risposta. I payload sono associati alla risorsa (un report, un aggiornamento, un team).
Tempi di risposta
Le richieste di dati sono ottimizzate per una risposta in frazioni di secondo.
| Strumento | Tempo di risposta previsto |
|---|---|
search_updates | tipicamente < 1 s |
list_sources | tipicamente < 1 s (senza canali) |
list_sources con include_channels: true | 1 – 3 s (a seconda dell’area di lavoro) |
get_update_details | tipicamente < 1 s |
get_report | 1 – 3 s (a seconda del report) |
get_team_context | tipicamente < 1 s |
Strumenti di scrittura (create_*, update_*, delete_*, toggle_*) | tipicamente < 2 s |
Timeout MCP
Il server Picasi non impone un proprio timeout. Sono applicabili i timeout dei rispettivi client IA.
| Client | Timeout effettivo del client |
|---|---|
| Claude Code (CLI) | Standard: 30 s per ogni chiamata allo strumento |
| Claude.ai | Standard: 30 s per ogni chiamata allo strumento |
| ChatGPT (connettore personalizzato) | Standard: 30 s per ogni chiamata allo strumento |
Pertanto, gli strumenti di analisi con tempi di esecuzione prolungati (generate_feedback, summarize_updates — da 15 a 45 secondi) sono attualmente disattivati. Per analisi più lunghe, utilizzare l’app Picasi oppure recuperare i risultati di un report già generato tramite get_report.
Limitazione della frequenza
Il server MCP attualmente non utilizza alcun middleware dedicato alla limitazione della frequenza. Si applicano i meccanismi di protezione generali della piattaforma Picasi (limiti di frequenza di autenticazione, WAF).
Raccomandazioni per le implementazioni client:
- Memorizzare i risultati nella cache se vengono ripetute query identiche.
- Per le analisi in blocco, impostare in modo mirato
limit, invece di paginare in loop su pagine di piccole dimensioni. - In caso di più richieste parallele, privilegiare una singola chiamata allo strumento per ogni domanda logica.
Non appena il server MCP applica una limitazione di frequenza, questa pagina viene aggiornata con i dati numerici e il comportamento degli header HTTP (Retry-After, X-RateLimit-*).
Struttura del payload
Tutte le risposte dello strumento forniscono tre blocchi:
result– Dati utili (aggiornamenti, fonti, report, …)meta– Tempo di esecuzione, filtri applicati,total_availablein caso di ricerchehints– Suggerimenti per successive richieste pertinenti
total_available in meta indica il numero totale di risultati disponibili che non sono stati restituiti. In questo modo il client può decidere se sia opportuno effettuare una richiesta mirata.