Servidor MCP — Limites, tempos de espera e notas sobre o desempenho
O servidor MCP do Picasi foi concebido para acessos rápidos aos dados (< 5 segundos). Esta página lista os limites técnicos atuais e as regras de timeout, para que os assistentes de IA dimensionem corretamente os pedidos.
Limites por ferramenta
Limites por chamada de ferramenta, tal como o servidor os aceita atualmente.
search_updates
| Parâmetro | Limite |
|---|---|
limit | 1 – 100 (padrão: 20) |
days | 1 – 365 (padrão: 7) |
date_from / date_to | Período arbitrário, sobrepõe-se a days |
Se limit for superior a 100, o servidor reduz para 100 e indica-o no bloco meta (total_available mostra o número efetivamente disponível).
list_sources
Sem limites máximos rígidos. A resposta inclui todas as fontes do Workspace. Em Workspaces muito grandes, recomenda-se include_channels: false (padrão) para manter o payload pequeno.
list_reports
| Parâmetro | Limite |
|---|---|
limit | Padrão 10, sem limite máximo rígido conhecido |
Todas as restantes ferramentas
Para get_update_details, get_report, get_team_context e list_tags, bem como para as ferramentas de escrita, não há limites de resposta rígidos. Os payloads estão ligados ao recurso (um relatório, um Update, uma equipa).
Tempos de resposta
As consultas de dados estão otimizadas para respostas em frações de segundo.
| Ferramenta | Tempo de resposta esperado |
|---|---|
search_updates | tipicamente < 1 s |
list_sources | tipicamente < 1 s (sem canais) |
list_sources com include_channels: true | 1 – 3 s (dependendo do Workspace) |
get_update_details | tipicamente < 1 s |
get_report | 1 – 3 s (dependendo do relatório) |
get_team_context | tipicamente < 1 s |
Ferramentas de escrita (create_*, update_*, delete_*, toggle_*) | tipicamente < 2 s |
Timeouts do MCP
O servidor do Picasi não impõe um timeout próprio. Vigoram os timeouts do respetivo cliente de IA.
| Cliente | Timeout efetivo do cliente |
|---|---|
| Claude Code (CLI) | Padrão: 30 s por chamada de ferramenta |
| Claude.ai | Padrão: 30 s por chamada de ferramenta |
| ChatGPT (Custom Connector) | Padrão: 30 s por chamada de ferramenta |
Por isso, as ferramentas de análise com tempos de execução longos (generate_feedback, summarize_updates — 15 a 45 segundos) estão atualmente desativadas. Para análises mais demoradas, usa a app do Picasi ou recupera o resultado de um relatório já gerado através de get_report.
Rate limiting
O servidor MCP não utiliza atualmente nenhum middleware dedicado de rate limit. Aplicam-se os mecanismos de proteção gerais da plataforma Picasi (rate limits de autenticação, WAF).
Recomendação para implementações no lado do cliente:
- Faz cache dos resultados quando forem repetidas as mesmas consultas.
- Em análises em massa, define
limitde forma específica em vez de paginar em ciclos sobre páginas pequenas. - Com vários pedidos paralelos, prefere uma única chamada por questão lógica.
Assim que o servidor MCP introduzir rate limiting, esta página será atualizada com números e o comportamento dos headers HTTP (Retry-After, X-RateLimit-*).
Estrutura do payload
Todas as respostas de ferramenta devolvem três blocos:
result— dados úteis (Updates, fontes, relatórios, …)meta— tempo de execução, filtros aplicados,total_availablenas pesquisashints— sugestões para chamadas de seguimento úteis
total_available em meta indica quantos resultados existiriam ao todo sem terem sido devolvidos. Assim, o cliente pode decidir se faz sentido fazer uma consulta mais específica.