Servidor MCP: límites, tiempos de espera y consejos sobre rendimiento
El servidor Picasi-MCP está diseñado para un acceso rápido a los datos (< 5 segundos). En esta página se enumeran los límites técnicos actuales y las reglas de tiempo de espera, para que los asistentes de IA dimensionen correctamente las solicitudes.
Límites de las herramientas
Límites por llamada a la herramienta, tal y como los acepta actualmente el servidor.
search_updates
| Parámetro | Límite |
|---|---|
limit | 1 – 100 (por defecto: 20) |
days | 1 – 365 (por defecto: 7) |
date_from / date_to | Periodo de tiempo cualquiera; anula days |
Si limit se establece en un valor superior a 100, el servidor lo reduce a 100 y lo indica en el bloque meta (total_available muestra el número realmente disponible).
list_sources
No hay límites máximos estrictos. La respuesta incluye todas las fuentes del espacio de trabajo. En espacios de trabajo muy grandes, se recomienda include_channels: false (valor predeterminado) para mantener la carga útil reducida.
list_reports
| Parámetro | Límite |
|---|---|
limit | Por defecto 10, no se conoce ningún límite máximo estricto |
El resto de herramientas
Para get_update_details, get_report, get_team_context, list_tags y las herramientas de escritura no hay límites estrictos de respuesta. Las cargas útiles están vinculadas al recurso (un informe, una actualización, un equipo).
Tiempos de respuesta
Las consultas de datos están optimizadas para obtener una respuesta en fracciones de segundo.
| Herramienta | Tiempo de respuesta esperado |
|---|---|
search_updates | típicamente < 1 s |
list_sources | típicamente < 1 s (sin canales) |
list_sources con include_channels: true | 1 – 3 s (dependiendo del espacio de trabajo) |
get_update_details | típicamente < 1 s |
get_report | 1 – 3 s (dependiendo del informe) |
get_team_context | típicamente < 1 s |
Herramientas de escritura (create_*, update_*, delete_*, toggle_*) | típicamente < 2 s |
Tiempos de espera de MCP
El servidor Picasi no impone ningún tiempo de espera propio. Lo que se aplica son los tiempos de espera de cada cliente de IA.
| Cliente | Tiempo de espera efectivo del cliente |
|---|---|
| Claude Code (CLI) | Por defecto, 30 s por llamada a la herramienta |
| Claude.ai | Por defecto, 30 s por llamada a la herramienta |
| ChatGPT (conector personalizado) | Por defecto, 30 s por llamada a la herramienta |
Por ello, las herramientas de análisis con tiempos de ejecución prolongados (generate_feedback, summarize_updates — de 15 a 45 segundos) están desactivadas actualmente. Para análisis más largos, utiliza la aplicación Picasi o recupera los resultados de un informe ya generado a través de get_report.
Límite de frecuencia
El servidor MCP no utiliza actualmente ningún middleware dedicado al límite de frecuencia. Se aplican los mecanismos de protección generales de la plataforma Picasi (límites de frecuencia de autenticación, WAF).
Recomendación para implementaciones de cliente:
- Almacenar en caché los resultados cuando se repitan consultas idénticas.
- En evaluaciones masivas, establecer específicamente
limit, en lugar de paginar en bucle a través de páginas pequeñas. - En caso de varias solicitudes paralelas, dar prioridad a una única llamada a la herramienta por cada pregunta lógica.
Tan pronto como el servidor MCP aplique una limitación de frecuencia, esta página se actualizará con cifras y el comportamiento de los encabezados HTTP (Retry-After, X-RateLimit-*).
Estructura de la carga útil
Todas las respuestas de la herramienta proporcionan tres bloques:
result– Datos útiles (actualizaciones, fuentes, informes, …)meta– Tiempo de ejecución, filtros aplicados,total_availableen búsquedashints– Sugerencias para consultas posteriores relevantes
total_available en meta indica cuántos resultados habría en total sin que se hayan devuelto. De este modo, el cliente puede decidir si tiene sentido realizar una consulta específica.