UKG Ready MCP

MCP-Server für UKG Ready REST-Endpunkte, einschließlich Mitarbeiter, Zeitkarten, Ausnahmen, Vergütung, gespeicherte Berichte und ein generisches authentifiziertes Endpunkt-Tool.

Konfiguration

Kopieren Sie .env.example in eine lokale Umgebungskonfiguration und legen Sie Folgendes fest:

• UKG_BASE_URL: Basis-URL des UKG-Mandanten, standardmäßig https://secure.entertimeonline.com.

• UKG_API_KEY, UKG_USERNAME, UKG_PASSWORD, UKG_COMPANY.

• UKG_DEFAULT_REPORT_ID: optionale ID des gespeicherten Berichts.

Übertragen Sie niemals echte Anmeldeinformationen und platzieren Sie diese nicht in Quelldateien.

Related MCP server: woffu-mcp

Ausführen

npm install
npm run build
npm start

Der Server kommuniziert über MCP stdio. Verfügbare Tools:

• get_ukg_saved_report_csv

• list_ukg_employees

• get_ukg_employee

• get_ukg_timecards

• list_ukg_exceptions

• get_ukg_compensation

• call_ukg_endpoint

Die Workforce-Tools verwenden dokumentationsbasierte Standardwerte und bieten eine optionale path-Überschreibung an, da die Verfügbarkeit von UKG Ready-Endpunkten je nach Mandant und aktiviertem Modul variiert. Das generische Tool akzeptiert jeden API-Pfad, sodass die Anmeldeinformationen innerhalb der Serverkonfiguration bleiben. Fügen Sie Schreib-Tools erst hinzu, nachdem der Endpunktvertrag und die Berechtigungen des Mandanten bestätigt wurden.

Zuordnung von UKG-Mitarbeitern und Command Cloud-Fahrern

Die beabsichtigte Integration besteht darin, dass ein UKG-Mitarbeiter einem Fahrer in Command Cloud entspricht. Diese Zuordnung ist eine geplante systemübergreifende Beziehung, noch keine automatische Annahme.

Bei der Implementierung sollten Datensätze anhand stabiler Identifikatoren abgeglichen werden, sofern verfügbar, und anschließend mit unterstützenden Feldern wie Mitarbeiter-/Fahrername, Mitarbeiternummer, Telefon, E-Mail und Aktivstatus validiert werden. Führen Sie eine explizite Zuordnung der UKG-Mitarbeiter-ID zur Command Cloud-Fahrer-ID; verlassen Sie sich nicht nur auf Namen, da Namen sich ändern oder doppelt vorkommen können.

Die Zuordnung wird zukünftige Workflows unterstützen, wie den Vergleich von UKG-Zeitkarten oder Stempelstatus mit Command Cloud-Fahrer-, Dispositions- und Ticketaktivitäten. Die tatsächlichen Abgleichsregeln und Entscheidungen zur Datenquelle müssen noch bestätigt werden, bevor Synchronisierungstools geschrieben werden.