MCP-Server — Grenzen, Timeouts und Performance-Hinweise
Der Picasi-MCP-Server ist auf schnelle Datenzugriffe (< 5 Sekunden) ausgelegt. Diese Seite listet die aktuellen technischen Grenzen und Timeout-Regeln, damit KI-Assistenten Anfragen richtig dimensionieren.
Tool-Grenzen
Grenzen pro Tool-Aufruf, wie sie der Server aktuell akzeptiert.
search_updates
| Parameter | Grenze |
|---|---|
limit | 1 – 100 (Standard: 20) |
days | 1 – 365 (Standard: 7) |
date_from / date_to | Beliebiger Zeitraum, überschreibt days |
Wird limit über 100 gesetzt, kürzt der Server auf 100 und weist im meta-Block darauf hin (total_available zeigt die tatsächlich verfügbare Anzahl).
list_sources
Keine harten Obergrenzen. Die Antwort enthält alle Quellen des Workspace. Bei sehr großen Workspaces empfiehlt sich include_channels: false (Standard), um die Payload klein zu halten.
list_reports
| Parameter | Grenze |
|---|---|
limit | Standard 10, keine harte Obergrenze bekannt |
Alle übrigen Tools
Für get_update_details, get_report, get_team_context, list_tags sowie die Write-Tools gibt es keine harten Antwortgrenzen. Payloads sind an die Ressource gebunden (ein Report, ein Update, ein Team).
Antwortzeiten
Datenabfragen sind auf Sub-Sekunden-Antwort optimiert.
| Tool | Erwartete Antwortzeit |
|---|---|
search_updates | typisch < 1 s |
list_sources | typisch < 1 s (ohne Kanäle) |
list_sources mit include_channels: true | 1 – 3 s (workspace-abhängig) |
get_update_details | typisch < 1 s |
get_report | 1 – 3 s (report-abhängig) |
get_team_context | typisch < 1 s |
Write-Tools (create_*, update_*, delete_*, toggle_*) | typisch < 2 s |
MCP-Timeouts
Der Picasi-Server erzwingt kein eigenes Server-Timeout. Wirksam sind die Timeouts des jeweiligen KI-Clients.
| Client | Effektives Client-Timeout |
|---|---|
| Claude Code (CLI) | Standard 30 s pro Tool-Aufruf |
| Claude.ai | Standard 30 s pro Tool-Aufruf |
| ChatGPT (Custom Connector) | Standard 30 s pro Tool-Aufruf |
Deshalb sind Analyse-Tools mit langen Laufzeiten (generate_feedback, summarize_updates — 15 bis 45 Sekunden) aktuell deaktiviert. Für längere Analysen die Picasi-App nutzen oder die Ergebnisse eines bereits erzeugten Reports über get_report abholen.
Ratenbegrenzung
Der MCP-Server verwendet aktuell keine dedizierte Rate-Limit-Middleware. Es gelten die allgemeinen Schutzmechanismen der Picasi-Plattform (Auth-Rate-Limits, WAF).
Empfehlung für Client-Implementierungen:
- Ergebnisse cachen, wenn identische Abfragen wiederholt gestellt werden.
- Bei Bulk-Auswertungen
limitgezielt setzen, statt in Schleife über kleine Seiten zu paginieren. - Bei mehreren parallelen Anfragen einen einzelnen Tool-Aufruf pro logischer Frage bevorzugen.
Sobald der MCP-Server Ratenbegrenzung einführt, wird diese Seite mit Zahlen und HTTP-Header-Verhalten (Retry-After, X-RateLimit-*) aktualisiert.
Payload-Struktur
Alle Tool-Antworten liefern drei Blöcke:
result– Nutzdaten (Updates, Quellen, Reports, …)meta– Ausführungszeit, angewandte Filter,total_availablebei Suchenhints– Vorschläge für sinnvolle Folgeaufrufe
total_available in meta zeigt, wie viele Ergebnisse insgesamt vorhanden wären, ohne dass sie zurückgegeben wurden. So kann der Client entscheiden, ob eine gezielte Nachfrage sinnvoll ist.