Сервер 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 (Custom Connector) | Стандартно 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 показує, скільки результатів загалом було б, якби вони не були повернуті. Таким чином клієнт може вирішити, чи доцільно робити цілеспрямований запит.