Was brauchst du?
Drei Dinge: ein Konto bei einer Zeiterfassung mit MCP-Server, einen KI-Assistenten, der MCP unterstützt, und die Adresse des Servers. Bei Half5 lautet sie https://app.half5.com/mcp.
Du installierst nichts und kopierst keinen API-Schlüssel. Beim Verbinden öffnet der Assistent eine Anmeldeseite in deinem Browser. Dort meldest du dich mit deinem normalen Konto an und stimmst zu. Was MCP genau ist, erklärt Was ist MCP?.
- Code-Assistenten: Claude Code, Codex und Cursor. Sie arbeiten in deinem Projekt und können den Namen des Repositorys mitschicken.
- Chat-Assistenten: Claude.ai (auch Claude Desktop und die mobile App) und ChatGPT. Sie kennen dein Repository nicht und fragen deshalb öfter nach dem Kunden.
- Weitere: VS Code und andere Programme, die einen entfernten MCP-Server mit OAuth unterstützen.
Wie verbindest du deinen Assistenten?
Jeder Assistent hat die Einstellung an einer anderen Stelle. Die Tabelle folgt der Einrichtungsanleitung in Half5. Menünamen ändern sich in diesen Apps manchmal; such dann nach ‚MCP‘, ‚Connector‘ oder ‚Custom Connector‘.
| Assistent | Wo | Was du tust |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, dann in Claude Code /mcp, half5 wählen und anmelden |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, danach codex mcp login half5; Codex öffnet deinen Browser |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, dann Connect unter Settings → MCP |
| Claude.ai, Desktop, App | Settings → Connectors | Add custom connector, URL einfügen und anmelden |
| ChatGPT | Settings → Apps & Connectors → Advanced | Developer mode einschalten, Create wählen, URL einfügen, OAuth wählen |
| VS Code und andere | MCP-Einstellungen | Einen entfernten MCP-Server (HTTP) mit der URL hinzufügen |
Der Developer mode in ChatGPT ist nicht in jedem Abo verfügbar. Siehst du die Option nicht, prüf, was dein Abo erlaubt.
Was sagst du dem Assistenten?
Normale Sprache reicht. Du brauchst keine IDs, Kundennummern oder Projektcodes. Nenn aber den Kunden oder das Projekt, wenn du es weißt, und die Zeit, wenn du sie weißt.
- ‚Buch anderthalb Stunden auf diese Arbeit.‘
- ‚Ich habe von 9:00 bis 11:30 an der Anbindung des Zahlungsanbieters gearbeitet. Buch das auf Bäckerei Jansen.‘
- ‚Buch diese Sitzung auf das Projekt Webshop.‘ (ohne Dauer: Die Zeiterfassung schlägt eine vor, die du bestätigst)
- ‚Was habe ich gestern gebucht?‘
- ‚Verschieb die Buchung von heute Morgen auf das Projekt Wartung.‘
- ‚Lösch die doppelte Buchung von heute.‘
Was passiert nach dem Buchen?
Eine Buchung eines Agenten ist keine Randnotiz, sondern eine normale Erfassung, die dieselbe Prüfung durchläuft wie deine anderen Stunden.
- Der Assistent schickt eine kurze Beschreibung, das Datum, die Dauer (falls bekannt) und bei Code-Assistenten den Namen des Repositorys und den Branch.
- Die Zeiterfassung wählt Kunde, Projekt und Tätigkeit. Ist sie unsicher, stellt dir der Assistent eine Frage mit einigen Optionen.
- Ohne Dauer schlägt die Zeiterfassung eine vor, zum Beispiel vom Ende deiner letzten Buchung bis jetzt. Gespeichert wird erst, wenn du bestätigst.
- Die Buchung kommt als nicht freigegeben an. Du oder eine freigebende Person prüft sie wie deine anderen Stunden.
- Nach der Freigabe fließt sie in Berichte und Rechnungsstellung.
Welche Gewohnheiten vermeiden Fehler?
Ein Assistent ist schnell, weiß aber nicht, wie lange du wirklich gearbeitet hast. Diese Gewohnheiten halten deine Zeiterfassung belastbar, auch wenn du später erklären musst, wohin die Stunden gegangen sind.
- Eine Buchung pro zusammenhängender Aufgabe. Lieber drei Buchungen à eine Stunde für drei Aufgaben als eine über drei Stunden mit allem darin.
- Erfinde nie eine Dauer. Weißt du sie nicht, lass sie weg und bestätige oder korrigiere den Vorschlag.
- Schau zuerst, was schon da ist. Bevor du einen ganzen Tag buchst, lass den Assistenten die Buchungen dieses Tages abrufen, damit nichts doppelt landet.
- Schreib für den Kunden. Die Beschreibung kann auf einer Rechnung stehen. Eine lesbare Zeile, ohne Dateinamen oder Code.
- Nenn den Kunden, wenn du unsicher bist. Ein ausdrücklich genannter Kunde oder ein Projekt geht immer vor dem, was der Assistent ableitet.
Was kann es nicht?
Ein Assistent bucht, was du oder er begründen kann; er misst deine Zeit nicht. Willst du deinen Arbeitstag von selbst festhalten, brauchst du eine Zeitachse, wie in Automatische Zeiterfassung beschrieben.
Außerdem sieht ein verbundener Agent nur deine eigenen Stunden. Er kann keine Stunden von Kolleginnen und Kollegen sehen, nichts freigeben und keine Rechnungen erstellen. Ändern oder löschen kann er nur deine eigenen Buchungen, solange sie noch nicht freigegeben sind.
So macht es Half5
In Half5 findest du die Anleitung unter Einstellungen → ‚Verbundene Agents‘, bei ‚Agent verbinden‘. Auf der Zustimmungsseite siehst du, welche Organisation du verbindest und was der Agent darf: Stunden ansehen und Stunden erfassen. Ein unbekannter Client erscheint dort als nicht verifizierte App.
Buchungen eines Agenten kommen als ‚Noch nicht freigegeben‘ an und laufen dann denselben Weg wie deine anderen Stunden. Half5 wählt Kunde und Projekt anhand dessen, was der Agent mitschickt, deiner früheren Buchungen und welches Repository du schon auf welchen Kunden gebucht hast. Details stehen in So funktioniert log_work, der Umgang mit deinen Daten in Datenschutz bei KI-Agenten.
Häufige Fragen
Muss ich etwas installieren, um mit Claude oder ChatGPT Stunden zu buchen?
Nein. Du fügst die Serveradresse in deinem Assistenten hinzu und meldest dich im Browser an. Nur bei Claude Code und Codex fügst du dafür einen Befehl ins Terminal ein.
Kann der Assistent selbst festlegen, wie lange ich gearbeitet habe?
Das sollte er nicht. Nennst du keine Dauer, schlägt Half5 eine vor, anhand deiner letzten Buchung und der aktuellen Uhrzeit, und du bestätigst oder korrigierst sie.
Warum fragt ChatGPT öfter nach dem Kunden als Claude Code?
Ein Chat-Assistent kennt dein Repository nicht und hat weniger, woran er den Kunden erkennen kann. Nach ein paar bestätigten Buchungen kennt Half5 deine Gewohnheiten und fragt seltener.
Kann ein Agent die Stunden meiner Kolleginnen und Kollegen sehen oder freigeben?
Nein. Ein verbundener Agent sieht nur deine eigenen Stunden und die Kunden, Projekte und Tätigkeiten, die du sehen darfst. Freigegeben wird in Half5 selbst.
Was, wenn der Agent etwas falsch bucht?
Bitte den Assistenten, die Buchung zu ändern oder zu löschen, oder mach es selbst in Half5. Solange sie nicht freigegeben ist, kann der Agent sie ändern; danach machst du das in der App.
