Aufgaben per MCP auflisten: Filter, Paginierung und Beispiele

Entwicklerreferenz für das MCP-Tool list_tasks. So durchsuchen und filtern Sie Aufgaben nach Projekt, Board, Status, Fälligkeitsdatum, Zugewiesenem oder Stichwort. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool list_tasks ermöglicht die Suche und Filterung von Aufgaben in Ihrem Corcava-Arbeitsbereich. Es wird am häufigsten genutzt, um Aufgaben zu finden, Berichte zu erzeugen und Workflows zu planen.

Nur-Lesen-Operation: Dieses Tool liest nur Daten – es ändert keine Aufgaben.

Eingabeparameter

Alle Parameter sind optional. Ohne Parameter werden alle Ihnen zugänglichen Aufgaben zurückgegeben (paginiert).

Ausgabeformat

Das Tool liefert ein JSON-Objekt mit Aufgaben und Paginierungsinformationen:

{
  "tasks": [
    {
      "id": 123,
      "title": "Implement login feature",
      "description": "Add user authentication...",
      "status": "in_progress",
      "due_date": "2026-02-28",
      "project_id": 456,
      "board_id": 789,
      "assignee_id": 101,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-20T14:22:00Z"
    },
    ...
  ],
  "total": 42,
  "limit": 25,
  "offset": 0,
  "has_more": true
}

Antwortfelder

• tasks: Array von Aufgabenobjekten (leeres Array bei keinen Treffern)
• total: Gesamtzahl der den Filtern entsprechenden Aufgaben (über alle Seiten)
• limit: Maximale Anzahl der in dieser Antwort zurückgegebenen Aufgaben
• offset: Anzahl der übersprungenen Aufgaben (für Paginierung)
• has_more: Boolean, ob weitere Aufgaben verfügbar sind

Beispiel-Tool-Aufrufe

Beispiel 1: Alle Aufgaben auflisten

Tool-Aufruf (JSON):

{
  "tool": "list_tasks",
  "arguments": {
    "limit": 50
  }
}

Rückgabe: Die ersten 50 Aufgaben aus Ihrem Arbeitsbereich

Beispiel 2: Diese Woche fällige Aufgaben

Tool-Aufruf (JSON):

{
  "tool": "list_tasks",
  "arguments": {
    "due_date": "this_week",
    "limit": 25
  }
}

Rückgabe: In der aktuellen Woche fällige Aufgaben

Beispiel 3: Suche nach Stichwort

Tool-Aufruf (JSON):

{
  "tool": "list_tasks",
  "arguments": {
    "search": "login",
    "limit": 10
  }
}

Rückgabe: Aufgaben mit „login“ in Titel oder Beschreibung

Beispiel 4: Filter nach Projekt und Status

Tool-Aufruf (JSON):

{
  "tool": "list_tasks",
  "arguments": {
    "project_id": 456,
    "status": "in_progress",
    "limit": 20
  }
}

Rückgabe: In Bearbeitung befindliche Aufgaben in Projekt 456

Beispiel 5: Paginierung

Erste Seite:

{
  "tool": "list_tasks",
  "arguments": {
    "limit": 25,
    "offset": 0
  }
}

Zweite Seite:

{
  "tool": "list_tasks",
  "arguments": {
    "limit": 25,
    "offset": 25
  }
}

Rückgabe: Aufgaben 26–50 (zweite Ergebnisseite)

Beispiele für natürliche Sprache

So nutzen Nutzer list_tasks typischerweise in natürlicher Sprache:

Claude Desktop / Allgemeine KI

Nutzeraufforderung:

"Welche Aufgaben sind diese Woche fällig?"

KI-Verhalten:

1. KI ruft list_tasks mit due_date: "this_week" auf
2. KI erhält die Aufgabenliste
3. KI formatiert und präsentiert die Ergebnisse dem Nutzer

Cursor / IDE-Kontext

Nutzeraufforderung:

"Zeig mir alle in Bearbeitung befindlichen Aufgaben im API-Projekt"

KI-Verhalten:

1. KI ruft list_projects auf, um das „API-Projekt“ zu finden
2. KI ruft list_tasks mit project_id und status: "in_progress" auf
3. KI präsentiert die Aufgabenliste in IDE-freundlichem Format

Wöchentliche Planung

Nutzeraufforderung:

"Welche Aufgaben sind diese Woche fällig und welche sind blockiert?"

KI-Verhalten:

1. KI ruft list_tasks mit due_date: "this_week" auf
2. KI analysiert die Aufgaben und erkennt blockierte
3. KI präsentiert einen geordneten Wochenplan

Typische Anwendungsfälle

• Wöchentliche Planung – Diese Woche fällige Aufgaben auflisten, Blocker identifizieren und Prioritäten setzen
• Täglicher Fokus – Heute oder bald fällige Aufgaben für die Tagesplanung finden
• Projektübergreifende Suche – Aufgaben per Stichwort in allen Projekten suchen
• Statusberichte – Berichte durch Filterung nach Projekt, Status oder Datum erzeugen

Grenzfälle

Leere Ergebnisse

Situation: Keine Aufgaben entsprechen den Filtern

Antwort:

{
  "tasks": [],
  "total": 0,
  "limit": 25,
  "offset": 0,
  "has_more": false
}

Umgang: Vor der Verarbeitung prüfen, ob das tasks-Array leer ist

Große Datenmengen

Situation: Tausende Aufgaben entsprechen den Filtern

Best Practice:

• Immer limit setzen, um die Ergebnisse zu begrenzen (Standard: 50, max: 100)
• offset für die Paginierung nutzen
• has_more prüfen, um zu wissen, ob weitere Seiten existieren
• Spezifischere Filter setzen, um die Ergebnisse einzugrenzen

Paginierung

Muster: Alle Aufgaben über mehrere Seiten abrufen

1. Aufruf mit limit: 50, offset: 0
2. has_more prüfen
3. Bei true erneut mit offset: 50 aufrufen
4. Wiederholen, bis has_more: false

Hinweis: Bei großen Datenmengen eher zusammenfassen als alle Aufgaben abrufen

Ungültige Filter

Situation: Ungültige project_id, board_id oder Statuswert

Antwort: Leere Ergebnisse (kein Fehler)

Best Practice: Vor dem Filtern prüfen, ob die IDs existieren, oder leere Ergebnisse sauber behandeln

Fehlerbehebung

Timeout-Fehler

Symptom: Anfrage läuft beim Abruf vieler Aufgaben in ein Timeout

Ursachen:

• Zu viele Aufgaben entsprechen den Filtern
• Hoher limit-Wert (nahe 100)
• Netzwerklatenz

Lösung:

• limit auf 25–50 reduzieren
• Spezifischere Filter setzen
• Paginierung nutzen statt alles auf einmal abzurufen

Timeout-Fehlerbehebung →

Ratenbegrenzung (429)

Symptom: 429-Fehler bei mehreren Aufrufen

Ursachen:

• Zu viele schnelle Aufrufe
• Paginierungsschleife zu schnell

Lösung:

• Verzögerungen zwischen Paginierungsaufrufen einbauen
• Operationen bündeln, wo möglich
• Ergebnisse cachen, wo sinnvoll

Ratenbegrenzungs-Anleitung →

Ungültige Filterwerte

Symptom: Leere Ergebnisse, obwohl Filter treffen sollten

Ursachen:

• Ungültige project_id oder board_id
• Falscher Statuswert (muss sein: open, in_progress, done, blocked)
• Ungültiges due_date-Format

Lösung:

• Mit list_projects oder list_boards prüfen, ob die IDs existieren
• Korrekte Statuswerte verwenden
• Vordefinierte due_date-Werte nutzen: today, this_week, this_month, overdue

Validierungs-Fehlerbehebung →

Best Practices

list_tasks effektiv nutzen

• ✅ Immer ein sinnvolles limit setzen (25–50 ist ideal)
• ✅ Spezifische Filter nutzen, um Ergebnisse einzugrenzen (project_id, status, due_date)
• ✅ Bei großen Datenmengen Paginierung nutzen statt limit erhöhen
• ✅ has_more prüfen, bevor die nächste Seite abgerufen wird
• ✅ search für Stichwortsuche in Titeln/Beschreibungen nutzen
• ✅ Filter kombinieren für präzise Ergebnisse (z. B. Projekt + Status + due_date)
• ✅ Leere Ergebnisse sauber behandeln
• ✅ Ergebnisse cachen, wo sinnvoll, um API-Aufrufe zu reduzieren

Verwandte Tools

Oft zusammen verwendet mit:

• get_task – Detaillierte Informationen zu einer bestimmten Aufgabe
• list_projects – Projekt-IDs zum Filtern von Aufgaben finden