Сервер MCP — ограничения, таймауты и рекомендации по производительности
Сервер Picasi-MCP рассчитан на быстрый доступ к данным (< 5 секунд). На этой странице перечислены текущие технические ограничения и правила таймаута, чтобы ИИ-помощники могли правильно определять размер запросов.
Без квоты на запросы
Число запросов MCP не ограничено — ни на одном тарифе. Picasi по-прежнему считает вызовы по каждому Workspace, но только для статистики; порога, который блокирует доступ, нет.
Ограничения инструментов
Ограничения на один вызов инструмента, которые в настоящее время принимает сервер.
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, а также инструментов записи жестких ограничений на размер ответа нет. Полевые данные привязаны к ресурсу (отчёт, Update, команда).
Время отклика
Запросы данных оптимизированы для отклика в доли секунды.
| Инструмент | Ожидаемое время отклика |
|---|---|
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.
Экономные запросы всё равно окупаются:
- Кэшируйте результаты, если повторно выполняются идентичные запросы.
- При массовых анализах целенаправленно устанавливайте
limitвместо того, чтобы в цикле выполнять пагинацию по небольшим страницам. - При нескольких параллельных запросах отдавайте предпочтение одному вызову инструмента на каждый логический вопрос.
Структура полезных данных
Все ответы инструмента содержат три блока:
result– полезные данные (Updates, источники, отчёты и т. д.)meta— время выполнения, примененные фильтры,total_availableпри поискеhints— предложения по целесообразным последующим запросам
total_available в meta показывает, сколько всего результатов было бы, если бы они не были возвращены. Таким образом, клиент может решить, имеет ли смысл отправлять целевой запрос.