Paginierung und Filterung in MCP: Weniger Aufrufe, schnellere Ergebnisse
Prompts und Tool-Nutzung so gestalten, dass große Listen vermieden werden. Der Guide behandelt Paginierungsstrategien, eingrenzende Filter und Zusammenfassungstechniken – mit praktischen Beispielen für Aufgaben- und Kommentarlisten in Corcava.
Warum Paginierung wichtig ist
Große Listen führen zu Performance-Problemen:
Probleme mit sehr großen Listen
- Langsame Antworten: Tausende Aufgaben abzurufen dauert
- Hoher Speicherbedarf: Große Antworten verbrauchen Ressourcen
- Rate Limiting: Große Abfragen können API-Limits treffen
- Schlechte Nutzererfahrung: Lange Wartezeiten auf Ergebnisse
- Unnötige Daten: Oft wird nur eine Teilmenge benötigt
Strategie 1: Filter auf Tool-Ebene nutzen
Daten an der Quelle filtern, nicht in Prompts:
Effizient: Filter im Tool-Aufruf
Was die KI macht:
- Ruft
list_tasksmit Filtern auf: status='open', due_date='this_week' - Erhält gefiltertes, kleineres Ergebnis
- Zeigt die Top 10 aus den Ergebnissen
- Gesamt: 1 Aufruf, kleine Antwort
✓ Effizient: Server filtert, minimaler Datentransfer
⚠️ Ineffizient: Filter im Prompt
Ergebnis:
- Ruft
list_tasksauf (erhält ALLE Aufgaben) - KI filtert im Speicher (unnötig)
- Zeigt Top 10
- Gesamt: 1 Aufruf, holt aber viel mehr Daten als nötig
✗ Ineffizient: Holt unnötige Daten
Strategie 2: Paginierung nutzen
Daten seitenweise anfordern statt auf einmal:
Paginierungs-Muster
Was die KI macht:
- Ruft
list_tasksmit limit=20, offset=0 auf - Liefert die ersten 20 Aufgaben
- Zeigt die Ergebnisse
- Wartet auf Anforderung der nächsten Seite
✓ Effizient: Kleine, handhabbare Portionen
Beispiel Paginierung
Mehrseiten-Anfrage-Muster
Dieses Muster: Lädt seitenweise, zeigt Fortschritt, ermöglicht bedarfsgerechtes Nachladen
Strategie 3: Zusammenfassung
Zusammenfassungen anfordern statt voller Listen:
Zusammenfassungs-Muster
Was die KI macht:
- Ruft
list_tasksmit Filtern auf - Ergebnisse zu einer Zusammenfassung verarbeiten
- Zusammenfassung statt voller Liste zurückgeben
- Deutlich kleinere Antwort
✓ Effizient: Zusammenfassung ist deutlich kürzer als die volle Liste
Beispiele: Aufgaben und Kommentare
Beispiel 1: Paginierte Aufgabenliste
Effiziente paginierte Anfrage
Dieses Muster: Lädt handhabbare Portionen, zeigt Fortschritt
Beispiel 2: Gefilterte Kommentarliste
Effiziente gefilterte Kommentare
Dieses Muster: Begrenzt Ergebnisse, Fokus auf aktuelle Aktivität
Beispiel 3: Zusammenfassende Aufgabenübersicht
Effiziente Zusammenfassungsanfrage
Dieses Muster: Kennzahlen ohne volle Aufgabenlisten erhalten
Filter eingrenzen
Sinnvolle Filterkombinationen
- Projekt + Status:
project_id + statusgrenzt stark ein - Datumsbereich:
due_date: "this_week"auf Aktuelles begrenzen - Verantwortlicher + Status:
assignee + statusfindet konkrete Arbeit - Mehrere Filter: Filter für präzise Ergebnisse kombinieren
Beispiel: Filterkombination
Stark gefilterte Anfrage
Angewendete Filter:
- Projektfilter
- Statusfilter (mehrere Werte)
- Verantwortlichen-Filter
- Datumsfilter
- Limit-Filter
✓ Sehr effizient: Mehrere Filter grenzen Ergebnisse stark ein
Bewährte Praktiken
Best Practices für Paginierung und Filterung
- Immer Filter nutzen: Auf Tool-Ebene filtern, nicht in Prompts
- Angemessene Limits setzen: Limit-Parameter nutzen (z. B. 20–50 Einträge)
- Große Listen paginieren: Seiten anfordern statt alle Daten
- Zusammenfassen wo möglich: Um Zusammenfassungen bitten statt voller Listen
- Filter kombinieren: Mehrere Filter für präzisere Ergebnisse nutzen
- Anforderungen klar machen: Deutlich sagen, welche Daten nötig sind
Performance-Tipps
Optimierungsstrategien
- Klein starten: Zuerst 10–20 Einträge anfordern, bei Bedarf erweitern
- Datumsfilter nutzen: Auf aktuelle Daten beschränken (diese Woche, dieser Monat)
- Projektspezifisch: Nach Projekt filtern, um den Umfang zu reduzieren
- Statusfilter: Auf bestimmte Status fokussieren (offen, in Bearbeitung)
- „Alle“ vermeiden: Nie alle Aufgaben ohne Filter anfordern
Weitere Ressourcen
Batching-Anleitung
Tool-Aufrufe reduzieren
Timeout-Probleme
Langsame Antworten beheben
Ratenlimit (429)
API-Aufrufe reduzieren
Tool-Referenz
Verfügbare Filter
MCP-Anfragen optimieren
Paginierung und Filterung nutzen für schnellere Ergebnisse und weniger API-Aufrufe
