Zeiterfassung stoppen per MCP: Ergebnisse und Zusammenfassungen protokollieren

Entwicklerreferenz für das MCP-Tool stop_time_tracking. So stoppen Sie den aktuellen Timer, protokollieren Ergebnisse und fügen Zusammenfassungen hinzu. Inkl. Sicherheitsprüfungen, Bestätigungsmustern, Beispiel-Tool-Aufrufen, natürlicher Sprache, Grenzfällen und Fehlerbehebung.

Tool-Überblick

Zweck

Das Tool stop_time_tracking stoppt den aktuell laufenden Timer und protokolliert die verbrachte Zeit. Nutzen Sie es, um Arbeitssitzungen zu beenden, die Aufgabe zu wechseln oder Zeit mit optionaler Zusammenfassung des Erreichten zu protokollieren.

⚠️ Schreib-Operation: Dieses Tool ändert Daten – immer Bestätigungsmuster verwenden und Dauer in der Vorschau anzeigen, bevor es aufgerufen wird.

Eingabeparameter

Alle Parameter sind optional. Ohne summary wird der Timer ohne Zusammenfassungskommentar gestoppt.

Ausgabeformat

Das Tool liefert das gestoppte Erfassungsobjekt mit Dauer und Zusammenfassung:

{
  "task_id": 123,
  "task_title": "Implement login feature",
  "started_at": "2026-03-19T10:30:00Z",
  "stopped_at": "2026-03-19T12:45:00Z",
  "duration_minutes": 135,
  "duration_hours": 2.25,
  "summary": "Completed OAuth integration",
  "comment_id": 5
}

Antwortfelder

• task_id: ID der erfassten Aufgabe
• task_title: Titel der Aufgabe (zur Orientierung)
• started_at: Zeitstempel, wann der Timer gestartet wurde
• stopped_at: Zeitstempel, wann der Timer gestoppt wurde
• duration_minutes: Gesamtdauer in Minuten
• duration_hours: Gesamtdauer in Stunden (Dezimal)
• summary: Zusammenfassungstext, falls angegeben (null wenn nicht angegeben)
• comment_id: ID des erstellten Kommentars, falls summary angegeben (sonst null)

Sicherheitsprüfungen und Bestätigungsmuster

⚠️ Immer Dauer in der Vorschau anzeigen, bevor gestoppt wird

KI niemals einen Timer stoppen lassen, ohne anzuzeigen, was passieren wird. Diese Muster nutzen:

• Zuerst Status prüfen: get_tracking_status aufrufen, um den aktuellen Timer zu sehen
• Dauer in Vorschau: Anzeigen, wie lange der Timer bereits läuft
• Zusammenfassung anzeigen: Zusammenfassungstext anzeigen, falls angegeben
• Bestätigungstoken: "CONFIRM" verlangen, bevor stop_time_tracking aufgerufen wird

Mehr zu sicheren Schreib-Workflows →

Sicheres Aufforderungsmuster

✅ Sicheres Aufforderungs-Template:

"Ich möchte den Timer stoppen. 
Prüfe zuerst, welcher Timer läuft, und zeig mir, wie lange er schon läuft. 
Zeig mir die Zusammenfassung, die ich hinzufüge (falls vorhanden), dann warte auf CONFIRM, bevor du stoppst. 
Wenn ich nicht CONFIRM tippe, stoppe nichts."

Beispiel-Tool-Aufrufe

Beispiel 1: Timer ohne Zusammenfassung stoppen

Tool-Aufruf (JSON):

{
  "tool": "stop_time_tracking",
  "arguments": {}
}

Rückgabe: Gestopptes Erfassungsobjekt mit Dauer, kein Kommentar erstellt

Beispiel 2: Timer mit Zusammenfassung stoppen

Tool-Aufruf (JSON):

{
  "tool": "stop_time_tracking",
  "arguments": {
    "summary": "Completed OAuth integration and wrote tests"
  }
}

Rückgabe: Gestopptes Erfassungsobjekt mit Dauer und Zusammenfassung, Kommentar zur Aufgabe erstellt

Beispiele für natürliche Sprache

Sicheres Timer-Stopp mit Vorschau

Nutzeraufforderung:

"Stoppe den Timer. Zeig mir zuerst, wie lange er läuft, dann warte auf CONFIRM."

KI-Verhalten:

1. KI ruft get_tracking_status auf, um den aktuellen Timer zu sehen
2. KI berechnet die Dauer: "Timer läuft seit 2 Stunden 15 Minuten für: Login Feature"
3. KI zeigt Vorschau und wartet auf "CONFIRM"
4. KI ruft stop_time_tracking erst nach Bestätigung auf
5. KI bestätigt, dass der Timer gestoppt wurde

Stopp mit Zusammenfassung

Nutzeraufforderung:

"Stoppe den Timer und füge die Zusammenfassung hinzu: 'OAuth-Integration abgeschlossen'. Zeig mir zuerst, was du tun wirst."

KI-Verhalten:

1. KI prüft get_tracking_status für den aktuellen Timer
2. KI zeigt: "Timer stoppen (2h 15m), Kommentar hinzufügen: 'OAuth-Integration abgeschlossen'"
3. KI wartet auf Bestätigung
4. KI ruft stop_time_tracking mit summary auf
5. KI bestätigt, dass Timer gestoppt und Kommentar hinzugefügt wurde

Typische Anwendungsfälle

• Zeiterfassung-Grundlagen – Timer stoppen beim Beenden von Arbeitssitzungen
• Zeiterfassung-Hygiene – Lange laufende Timer stoppen und aufräumen
• Editor-Workflow – Timer stoppen und Fortschritt protokollieren beim Wechsel der Aufgabe
• Zuerst Status prüfen – Immer den Timer-Status prüfen, bevor gestoppt wird

Grenzfälle

Kein Timer läuft

Situation: Derzeit ist kein Timer aktiv

Antwort:

{
  "error": "no_timer_running",
  "message": "No timer is currently running"
}

Umgang: Das ist normal – prüfen, ob der Timer bereits gestoppt oder nie gestartet wurde

Timer nicht gefunden

Situation: Timer wurde von einem anderen Prozess gestoppt oder gelöscht

Antwort: Wie beim Fehler "no timer running"

Umgang: Timer-Status mit get_tracking_status prüfen

Fehlerbehebung

Kein Timer läuft

Symptom: Fehler, dass kein Timer läuft

Ursachen:

• Timer wurde nie gestartet
• Timer wurde bereits gestoppt
• Timer wurde von einem anderen Prozess gelöscht

Lösung:

• get_tracking_status aufrufen, um den Timer-Status zu prüfen
• Wenn kein Timer, einen mit start_time_tracking starten
• Prüfen, ob der Timer in einer anderen Sitzung gestoppt wurde

Best Practices

stop_time_tracking sicher nutzen

• ✅ Immer zuerst get_tracking_status aufrufen, um den Timer-Status zu prüfen
• ✅ Dauer-Vorschau anzeigen, bevor gestoppt wird
• ✅ Zusammenfassungstext anzeigen, falls angegeben
• ✅ Ausdrückliche Bestätigung verlangen (CONFIRM-Token)
• ✅ Aussagekräftige Zusammenfassungen nutzen, um das Erreichte zu dokumentieren
• ✅ Timer stoppen beim Wechsel der Aufgabe oder Beenden der Arbeitssitzung
• ✅ Zusammenfassungen nutzen, um ein Prüfprotokoll der erledigten Arbeit zu erstellen

Verwandte Tools

Oft zusammen verwendet mit:

• get_tracking_status – Timer-Status prüfen, bevor gestoppt wird
• start_time_tracking – Timer starten beim Beginn der Arbeit
• add_task_comment – Detaillierte Kommentare nach dem Stoppen des Timers hinzufügen
• Least-Privilege Workflows – Sichere Schreib-Workflow-Muster