Einzelne Aufgabe per MCP abrufen: Felder, Status und Kontext

Entwicklerreferenz für das MCP-Tool get_task. So rufen Sie vollständige Details einer bestimmten Aufgabe inkl. aller Felder, Status, Kommentare und Metadaten ab. Inkl. Beispiel-Tool-Aufrufe, natürliche Sprache, Grenzfälle und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool get_task ruft die vollständigen Details einer bestimmten Aufgabe anhand ihrer ID ab. Nutzen Sie es, wenn Sie vor Änderungen, Prüfung der Historie oder Übergabe den vollen Kontext einer Aufgabe benötigen.

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

Eingabeparameter

Das Tool benötigt eine Aufgaben-ID, um die Aufgabendetails abzurufen.

Ausgabeformat

Das Tool liefert ein vollständiges Aufgabenobjekt mit allen verfügbaren Feldern:

{
  "id": 123,
  "title": "Implement login feature",
  "description": "Add user authentication with email/password and OAuth support",
  "status": "in_progress",
  "priority": "high",
  "due_date": "2026-02-28",
  "project_id": 456,
  "board_id": 789,
  "assignee_id": 101,
  "assignee_name": "John Doe",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-02-20T14:22:00Z",
  "created_by_id": 99,
  "comments": [
    {
      "id": 1,
      "content": "Started working on OAuth integration",
      "author_id": 101,
      "author_name": "John Doe",
      "created_at": "2026-02-20T14:22:00Z"
    }
  ],
  "tags": ["authentication", "backend"],
  "estimated_hours": 8,
  "actual_hours": 4.5
}

Antwortfelder

• id: Eindeutige Aufgabenkennung
• title: Aufgabentitel/-name
• description: Vollständige Aufgabenbeschreibung
• status: Aktueller Status (open, in_progress, done, blocked)
• priority: Aufgabenpriorität (low, medium, high, urgent)
• due_date: Fälligkeitsdatum im ISO-Format (YYYY-MM-DD) oder null
• project_id: ID des Projekts, zu dem die Aufgabe gehört
• board_id: ID des Boards, auf dem die Aufgabe liegt
• assignee_id: ID des der Aufgabe zugewiesenen Benutzers
• assignee_name: Name des zugewiesenen Benutzers
• created_at: Zeitstempel der Erstellung
• updated_at: Zeitstempel der letzten Aktualisierung
• created_by_id: ID des Benutzers, der die Aufgabe erstellt hat
• comments: Array von Kommentarobjekten mit Inhalt, Autor und Zeitstempeln
• tags: Array von Tag-Strings
• estimated_hours: Geschätzte Bearbeitungszeit (falls gesetzt)
• actual_hours: Tatsächlich erfasste Zeit (falls erfasst)

Beispiel-Tool-Aufrufe

Beispiel 1: Aufgabe anhand ID abrufen

Tool-Aufruf (JSON):

{
  "tool": "get_task",
  "arguments": {
    "task_id": 123
  }
}

Rückgabe: Vollständiges Aufgabenobjekt mit allen Feldern

Beispiele für natürliche Sprache

So nutzen Nutzer get_task typischerweise in natürlicher Sprache:

Claude Desktop / Allgemeine KI

Nutzeraufforderung:

"Zeig mir die Details für Aufgabe #123"

KI-Verhalten:

1. KI ruft get_task mit task_id: 123 auf
2. KI erhält das vollständige Aufgabenobjekt
3. KI formatiert und präsentiert die Aufgabendetails dem Nutzer

Cursor / IDE-Kontext

Nutzeraufforderung:

"Was sind die Abnahmekriterien für die Login-Feature-Aufgabe?"

KI-Verhalten:

1. KI findet die Aufgabe mit list_tasks und Suche: "login feature"
2. KI ruft get_task mit der Aufgaben-ID auf
3. KI extrahiert die Abnahmekriterien aus Beschreibung oder Kommentaren
4. KI präsentiert die Kriterien in IDE-freundlichem Format

Vorbereitung von Updates

Nutzeraufforderung:

"Zeig mir den aktuellen Stand von Aufgabe #456, bevor ich sie aktualisiere"

KI-Verhalten:

1. KI ruft get_task auf, um den aktuellen Stand zu lesen
2. KI zeigt die aktuellen Aufgabendetails
3. KI wartet auf die vom Nutzer gewünschten Änderungen
4. KI kann vor dem Aufruf von update_task eine Diff-Ansicht zeigen

Typische Anwendungsfälle

• Aufgabenübergabe – Vollständigen Aufgabenkontext für die Übergabe an einen neuen Verantwortlichen
• Abnahmekriterien – Aufgabendetails prüfen, um Abnahmekriterien vorzuschlagen oder zu verifizieren
• Aufgabenverwaltung – Aufgabendetails vor Änderungen prüfen
• Pre-Update-Prüfung – Aktuellen Stand lesen, bevor Aufgabenfelder aktualisiert werden

Grenzfälle

Aufgabe nicht gefunden (404)

Situation: Die Aufgaben-ID existiert nicht oder die Aufgabe wurde gelöscht

Antwort:

{
  "error": "not_found",
  "message": "Task with ID 123 not found"
}

Umgang: Prüfen, ob die Aufgaben-ID korrekt ist oder die Aufgabe gelöscht wurde

Berechtigung verweigert (403)

Situation: Die Aufgabe existiert, aber Sie haben keinen Zugriff

Antwort:

{
  "error": "forbidden",
  "message": "You don't have permission to access this task"
}

Umgang: Prüfen, ob Sie im richtigen Arbeitsbereich sind oder die Aufgabe privat ist

403-Fehlerbehebungsanleitung →

Ungültige Aufgaben-ID

Situation: Die Aufgaben-ID ist keine gültige Ganzzahl

Antwort:

{
  "error": "validation_error",
  "message": "Invalid task_id format",
  "field": "task_id"
}

Umgang: Sicherstellen, dass task_id eine gültige Ganzzahl ist

Fehlerbehebung

Ungültige Aufgaben-ID

Symptom: 400-Validierungsfehler oder 404 Not Found

Ursachen:

• Aufgaben-ID ist keine Zahl
• Aufgaben-ID existiert nicht
• Aufgabe wurde gelöscht

Lösung:

• Prüfen, ob die Aufgaben-ID eine gültige Ganzzahl ist
• Mit list_tasks die richtige Aufgaben-ID finden
• Prüfen, ob die Aufgabe in Corcava noch existiert

Zugriff verweigert (403)

Symptom: 403 Forbidden

Ursachen:

• Aufgabe gehört einem anderen Arbeitsbereich
• Aufgabe ist privat und Sie sind nicht zugewiesen
• API-Schlüssel hat keinen Zugriff auf den Arbeitsbereich

Lösung:

• Prüfen, ob Sie den richtigen Arbeitsbereich nutzen
• Aufgabenberechtigungen in Corcava prüfen
• Prüfen, ob der API-Schlüssel Zugriff auf den Arbeitsbereich hat

403-Fehlerbehebungsanleitung →

Best Practices

get_task effektiv nutzen

• ✅ Vor update_task immer get_task aufrufen, um den aktuellen Stand zu lesen
• ✅ Mit get_task prüfen, ob die Aufgabe existiert, bevor Updates versucht werden
• ✅ Aufgabenkommentare prüfen, um Kontext und Historie zu verstehen
• ✅ Aufgabenstatus prüfen, bevor Statusänderungen vorgenommen werden
• ✅ Aufgabendetails für Übergaben und Zusammenfassungen nutzen
• ✅ Vor Operationen prüfen, ob die Aufgabe zum erwarteten Projekt/Board gehört

Verwandte Tools

Oft zusammen verwendet mit:

• list_tasks – Aufgaben-IDs finden, bevor get_task aufgerufen wird
• update_task – Aufgabendetails lesen, bevor aktualisiert wird
• list_task_comments – Detaillierte Kommentarhistorie (get_task enthält die letzten Kommentare)