Сервер MCP — ограничения, таймауты и рекомендации по производительности
Сервер Picasi-MCP рассчитан на быстрый доступ к данным (< 5 секунд). На этой странице перечислены текущие технические ограничения и правила таймаута, чтобы ИИ-помощники могли правильно определять размер запросов.
Ограничения инструментов
Ограничения на один вызов инструмента, которые в настоящее время принимает сервер.
search_updates
| Параметр | Ограничение |
|---|---|
limit | 1 – 100 (по умолчанию: 20) |
days | 1 – 365 (по умолчанию: 7) |
date_from / date_to | Любой период времени, переопределяет days |
Если limit установлено больше 100, сервер сокращает значение до 100 и указывает на это в блоке meta (total_available показывает фактически доступное количество).
list_sources
Жестких верхних ограничений нет. Ответ содержит все источники рабочей области. Для очень больших рабочих областей рекомендуется использовать include_channels: false (по умолчанию), чтобы уменьшить размер полезной нагрузки.
list_reports
| Параметр | Ограничение |
|---|---|
limit | По умолчанию 10, жёсткого верхнего предела не известно |
Все остальные инструменты
Для get_update_details, get_report, get_team_context, list_tags, а также инструментов записи жестких ограничений на размер ответа нет. Полевые данные привязаны к ресурсу (отчёт, обновление, команда).
Время отклика
Запросы данных оптимизированы для отклика в доли секунды.
| Инструмент | Ожидаемое время отклика |
|---|---|
search_updates | обычно < 1 с |
list_sources | обычно < 1 с (без каналов) |
list_sources с include_channels: true | 1–3 с (в зависимости от рабочей среды) |
get_update_details | обычно < 1 с |
get_report | 1–3 с (в зависимости от отчёта) |
get_team_context | типично < 1 с |
Инструменты записи (create_*, update_*, delete_*, toggle_*) | обычно < 2 с |
Таймауты MCP
Сервер Picasi не навязывает собственный серверный таймаут. Действуют таймауты соответствующего ИИ-клиента.
| Клиент | Эффективный таймаут клиента |
|---|---|
| Claude Code (CLI) | По умолчанию 30 с на каждый вызов инструмента |
| Claude.ai | По умолчанию 30 с на каждый вызов инструмента |
| ChatGPT (пользовательский коннектор) | По умолчанию 30 с на каждый вызов инструмента |
Поэтому инструменты анализа с длительным временем выполнения (generate_feedback, summarize_updates — от 15 до 45 секунд) в настоящее время отключены. Для более длительных анализов используйте приложение Picasi или загрузите результаты уже сгенерированного отчёта с помощью get_report.
Ограничение скорости
Сервер MCP в настоящее время не использует выделенное промежуточное ПО для ограничения скорости. Применяются общие механизмы защиты платформы Picasi (ограничения скорости аутентификации, WAF).
Рекомендации для клиентских реализаций:
- Кэшируйте результаты, если повторно выполняются идентичные запросы.
- При массовых анализах целенаправленно устанавливайте
limitвместо того, чтобы в цикле выполнять пагинацию по небольшим страницам. - При нескольких параллельных запросах отдавайте предпочтение одному вызову инструмента на каждый логический вопрос.
Как только сервер MCP вводит ограничение скорости, эта страница обновляется с указанием цифр и поведения HTTP-заголовков (Retry-After, X-RateLimit-*).
Структура полезных данных
Все ответы инструмента содержат три блока:
result– полезные данные (обновления, источники, отчёты и т. д.)meta— время выполнения, примененные фильтры,total_availableпри поискеhints— предложения по целесообразным последующим запросам
total_available в meta показывает, сколько всего результатов было бы, если бы они не были возвращены. Таким образом, клиент может решить, имеет ли смысл отправлять целевой запрос.