Serwer MCP — ograniczenia, limity czasu i wskazówki dotyczące wydajności
Serwer Picasi-MCP został zaprojektowany z myślą o szybkim dostępie do danych (< 5 sekund). Na tej stronie wymieniono aktualne ograniczenia techniczne i zasady dotyczące limitów czasu, aby asystenci AI mogli odpowiednio skalować zapytania.
Ograniczenia narzędzi
Ograniczenia na jedno wywołanie narzędzia, zgodnie z aktualnymi ustawieniami serwera.
search_updates
| Parametr | Ograniczenie |
|---|---|
limit | 1 – 100 (domyślnie: 20) |
days | 1 – 365 (domyślnie: 7) |
date_from / date_to | Dowolny okres, zastępuje days |
Jeśli wartość limit zostanie ustawiona powyżej 100, serwer ograniczy liczbę do 100 i poinformuje o tym w bloku meta (total_available pokazuje faktycznie dostępną liczbę).
list_sources
Brak sztywnych limitów górnych. Odpowiedź zawiera wszystkie źródła obszaru roboczego. W przypadku bardzo dużych obszarów roboczych zaleca się ustawienie include_channels: false (domyślnie), aby ograniczyć rozmiar danych użytkowych.
list_reports
| Parametr | Limit |
|---|---|
limit | Domyślnie 10, brak znanego sztywnego limitu górnego |
Wszystkie pozostałe narzędzia
W przypadku get_update_details, get_report, get_team_context, list_tags oraz narzędzi do zapisu nie ma sztywnych limitów odpowiedzi. Dane użytkowe są powiązane z zasobem (raport, aktualizacja, zespół).
Czasy odpowiedzi
Zapytania o dane są zoptymalizowane pod kątem odpowiedzi trwającej ułamki sekundy.
| Narzędzie | Przewidywany czas odpowiedzi |
|---|---|
search_updates | zazwyczaj < 1 s |
list_sources | zazwyczaj < 1 s (bez kanałów) |
list_sources z include_channels: true | 1–3 s (w zależności od obszaru roboczego) |
get_update_details | zazwyczaj < 1 s |
get_report | 1 – 3 s (w zależności od raportu) |
get_team_context | typowo < 1 s |
Narzędzia do zapisu (create_*, update_*, delete_*, toggle_*) | zazwyczaj < 2 s |
Limity czasu MCP
Serwer Picasi nie narzuca własnego limitu czasu serwera. Obowiązują limity czasu poszczególnych klientów AI.
| Klient | Efektywny limit czasu klienta |
|---|---|
| Claude Code (CLI) | Domyślnie 30 s na każde wywołanie narzędzia |
| Claude.ai | Domyślnie 30 s na każde wywołanie narzędzia |
| ChatGPT (Custom Connector) | Domyślnie 30 s na każde wywołanie narzędzia |
Dlatego narzędzia analityczne o długim czasie działania (generate_feedback, summarize_updates — od 15 do 45 sekund) są obecnie wyłączone. W przypadku dłuższych analiz należy skorzystać z aplikacji Picasi lub pobrać wyniki już wygenerowanego raportu za pomocą get_report.
Ograniczenie częstotliwości
Serwer MCP nie korzysta obecnie z żadnego dedykowanego oprogramowania pośredniczącego do ograniczania częstotliwości. Obowiązują ogólne mechanizmy zabezpieczające platformy Picasi (ograniczenia częstotliwości uwierzytelniania, WAF).
Zalecenia dotyczące implementacji po stronie klienta:
- Buforuj wyniki, jeśli identyczne zapytania są wysyłane wielokrotnie.
- W przypadku analiz zbiorczych ustaw
limitw sposób ukierunkowany, zamiast paginować w pętli po małych stronach. - W przypadku wielu równoległych zapytań preferuj pojedyncze wywołanie narzędzia na każde logiczne pytanie.
Gdy tylko serwer MCP wprowadzi ograniczenie częstotliwości, ta strona zostanie zaktualizowana o dane liczbowe i informacje dotyczące zachowania nagłówków HTTP (Retry-After, X-RateLimit-*).
Struktura ładunku
Wszystkie odpowiedzi narzędzia zawierają trzy bloki:
result– dane użytkowe (aktualizacje, źródła, raporty itp.)meta– czas wykonania, zastosowane filtry,total_availablew przypadku wyszukiwańhints– propozycje sensownych kolejnych zapytań
total_available w meta wskazuje, ile wyników byłoby łącznie dostępnych, gdyby nie zostały one zwrócone. Dzięki temu klient może zdecydować, czy celowe zapytanie ma sens.