Zeiterfassungs-Status per MCP abrufen: Was gerade läuft

Entwicklerreferenz für das MCP-Tool get_tracking_status. So prüfen Sie, ob die Zeiterfassung aktuell aktiv ist und für welche Aufgabe sie läuft. Inkl. Beispiel-Tool-Aufrufe, natürlicher Sprache, Grenzfällen und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool get_tracking_status prüft, ob ein Timer aktuell läuft, und liefert Details zur aktiven Erfassungssitzung. Nutzen Sie es vor dem Start eines neuen Timers, um Konflikte zu vermeiden, oder um zu prüfen, für welche Aufgabe gerade Zeit erfasst wird.

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

Eingabeparameter

Das Tool benötigt keine Parameter. Es liefert den aktuellen Erfassungsstatus für Ihren Arbeitsbereich.

Ausgabeformat

Das Tool liefert den aktuellen Erfassungsstatus:

Wenn ein Timer läuft:

{
  "is_running": true,
  "task_id": 123,
  "task_title": "Implement login feature",
  "started_at": "2026-03-19T10:30:00Z"
}

Wenn kein Timer läuft:

{
  "is_running": false,
  "task_id": null,
  "task_title": null,
  "started_at": null
}

Antwortfelder

• is_running: Boolean, ob aktuell ein Timer aktiv ist
• task_id: ID der erfassten Aufgabe (null wenn kein Timer)
• task_title: Titel der Aufgabe (null wenn kein Timer)
• started_at: Zeitstempel, wann der Timer gestartet wurde (null wenn kein Timer)

Beispiel-Tool-Aufrufe

Beispiel 1: Erfassungsstatus prüfen

Tool-Aufruf (JSON):

{
  "tool": "get_tracking_status",
  "arguments": {}
}

Rückgabe: Aktuelles Erfassungsstatus-Objekt

Beispiele für natürliche Sprache

Prüfen vor dem Start des Timers

Nutzeraufforderung:

"Prüfe, ob ein Timer läuft, dann starte die Erfassung für Aufgabe #123"

KI-Verhalten:

1. KI ruft get_tracking_status auf
2. Wenn ein Timer existiert, warnt KI den Nutzer und bittet, zuerst zu stoppen
3. Wenn kein Timer, fährt KI fort und startet den Timer für Aufgabe #123

Aktuellen Timer prüfen

Nutzeraufforderung:

"Für welche Aufgabe erfasse ich gerade Zeit?"

KI-Verhalten:

1. KI ruft get_tracking_status auf
2. KI meldet: "Sie erfassen Zeit für: Login Feature (vor 2 Stunden gestartet)"
3. Oder: "Aktuell läuft kein Timer"

Typische Anwendungsfälle

• Zeiterfassung-Grundlagen – Status prüfen, bevor neue Timer gestartet werden
• Zeiterfassung-Hygiene – Lange laufende Timer erkennen
• Timer starten – Immer Status prüfen, bevor gestartet wird
• Timer stoppen – Status prüfen, bevor gestoppt wird

Grenzfälle

Kein Timer läuft

Situation: Derzeit ist kein Timer aktiv

Antwort:

{
  "is_running": false,
  "task_id": null,
  "task_title": null,
  "started_at": null
}

Umgang: Das ist normal – Sie können einen neuen Timer starten

Fehlerbehebung

Immer „Kein Timer“

Symptom: Gibt immer is_running: false zurück, obwohl ein Timer laufen sollte

Ursachen:

• Timer wurde in einer anderen Sitzung gestoppt
• Timer ist abgelaufen oder wurde gelöscht
• Arbeitsbereichs-Problem

Lösung:

• Timer in der Corcava-Weboberfläche prüfen
• Einen neuen Timer starten
• Arbeitsbereich-Einstellungen prüfen

Best Practices

get_tracking_status effektiv nutzen

• ✅ Immer get_tracking_status vor start_time_tracking aufrufen
• ✅ Vor dem Stoppen den Status prüfen, um zu bestätigen, dass ein Timer existiert
• ✅ Status nutzen, um mehrere Timer zu vermeiden
• ✅ Aktuelle Timer-Details dem Nutzer vor Aktionen anzeigen

Verwandte Tools

Oft zusammen verwendet mit:

• start_time_tracking – Status prüfen, bevor gestartet wird
• stop_time_tracking – Status prüfen, bevor gestoppt wird
• get_task – Aufgabendetails für die erfasste Aufgabe abrufen