Teetracks MCP-Server mit einem KI-Assistenten nutzen
Von Tristan Doehl · · Aktualisiert am
Wenn du bereits mit einem KI-Assistenten arbeitest, unterbricht der Wechsel in eine andere Anwendung für jede Timer-Aktion den Ablauf. Teetracks MCP-Server ermöglicht einem kompatiblen Assistenten, deine Zeitdaten über Tool-Aufrufe zu lesen und zu ändern. Die Einträge bleiben dabei auch in der Webanwendung verfügbar.
Was die Verbindung ergänzt
MCP steht für Model Context Protocol, einen Standard zur Verbindung von KI-Anwendungen mit externen Tools. In Teetrack decken diese Tools Timer, abgeschlossene Einträge, Projekte, Tags, Kunden, Zusammenfassungen, Einstellungen und die Kalenderprüfung ab. Der Assistent wählt anhand deiner Anfrage passende Tools und verwendet deren Rückgaben für seine Antwort.
„Starte einen Timer für Tests des Bestellvorgangs im Projekt Acme-Neugestaltung“ erfordert beispielsweise, dass der Assistent das Projekt findet und einen laufenden Eintrag erstellt. Der Projektname muss zum gemeinten Auftrag passen. Gibt es mehrere mögliche Treffer, muss diese Unklarheit geklärt werden. Das Protokoll entscheidet nicht, welchen Kunden du gemeint hast.
Verbinde ein Konto und prüfe den Zugriff
Der gehostete MCP-Endpunkt lautet https://teetrack.it/api/mcp. Die meisten KI-Anwendungen verbinden sich über OAuth: Du fügst die Server-URL hinzu, meldest dich im Browser bei Teetrack an und bestätigst die angefragten Berechtigungen. Einen persönlichen API-Token brauchst du nur für Anwendungen ohne OAuth-Unterstützung. Du erstellst ihn über MCP in der Seitenleiste: Öffne unter MCP-Integration den Bereich „Erweitert: Manueller Token“ und wähle „Token generieren“. Kopiere ihn direkt nach dem Erstellen und trage ihn in den Verbindungseinstellungen der Anwendung ein. Jedes Konto hat genau einen Token, ein neu generierter Token trennt daher alle Anwendungen, die noch den alten verwenden.
Beginne mit einer Leseanfrage, etwa einer Liste deiner Projekte oder laufenden Timer. Vergleiche die Antwort mit der Webanwendung, bevor du den Assistenten einen Eintrag erstellen lässt. Damit prüfst du sowohl die Verbindung als auch, ob du das beabsichtigte Konto autorisiert hast.
Bei OAuth kannst du auf der Zustimmungsseite Berechtigungsgruppen abwählen, und der Assistent kann dann nur die Tools nutzen, die die erteilten Berechtigungen abdecken. Ein manueller Token kennt diese Einschränkung nicht: Er erlaubt alle Tools, auch das Löschen. Für Aktionen innerhalb dieser Tools gelten weiterhin die Tarifgrenzen. Prüfe die Rückgabe des Tools, bevor du die Antwort des Assistenten als Bestätigung einer erfolgreichen Änderung wertest.
Verfolge einen Zeiteintrag durch die Tools
Angenommen, du lässt den Assistenten die Arbeit an einem Projekt starten und später den Timer stoppen. Den gespeicherten Eintrag kannst du im Dashboard ebenso prüfen wie einen im Browser erstellten. Du kannst auch nach den abgeschlossenen Einträgen des Tages fragen und Beschreibungen und Dauern mit deiner Arbeit vergleichen. Ist die Kalendersynchronisierung aktiv, frage ausdrücklich nach abgeschlossenen Einträgen, denn eine ungefilterte Liste enthält auch unbestätigte Kalenderentwürfe.
Für eine vergangene Sitzung sind weitere Angaben nötig. Nenne Datum, Start- und Endzeiten, gegebenenfalls die Zeitzone, Projekt und Beschreibung. Prüfe den angelegten Eintrag besonders dann, wenn die Anfrage ein relatives Datum verwendet oder Mitternacht überschreitet. Natürliche Sprache erleichtert die Anfrage, garantiert aber keine fehlerfreie Interpretation.
Welche Daten die KI-Anwendung erhält
Tool-Antworten gehen an den verbundenen Assistenten zurück. Wird dieser von einem anderen Anbieter gehostet, verarbeitet dieser Anbieter die enthaltenen Daten nach seinen Richtlinien und deinen Kontoeinstellungen. Die Kontentrennung in Teetrack sagt nichts Verbindliches über Speicherung oder Trainingsnutzung eines anderen Dienstes aus.
Prüfe die Datensätze vor dem Löschen
Löschungen über MCP sind endgültig. Lasse dir die passenden Datensätze mit ihren IDs zeigen, bevor du das Löschen freigibst. Nutze dafür die Freigabeeinstellungen der KI-Anwendung. Eine falsche Dauer kannst du durch Bearbeiten des Eintrags korrigieren.
Beginne mit einem kleinen, geprüften Ablauf
Starte mit einem Projekt und einem Timer, den du kontrollieren kannst. Wenn das funktioniert, erweitern die Claude-Anleitung, der Leitfaden für ChatGPT und Gemini und die fortgeschrittenen Abläufe dieselbe Verbindung zur täglichen Erfassung und Berichterstellung. Ein geprüftes Ergebnis ist die Grundlage, um längeren Folgen von Tool-Aufrufen zu vertrauen.
