UKG Ready MCP

Servidor MCP para los endpoints REST de UKG Ready, incluidos empleados, tarjetas de tiempo, excepciones, compensación, informes guardados y una herramienta genérica de endpoint autenticado.

Configuración

Copia .env.example a una configuración de entorno local y establece:

• UKG_BASE_URL: URL base del tenant de UKG, con valor predeterminado https://secure.entertimeonline.com.

• UKG_API_KEY, UKG_USERNAME, UKG_PASSWORD, UKG_COMPANY.

• UKG_DEFAULT_REPORT_ID: ID de informe guardado opcional.

Nunca confirmes credenciales reales ni las coloques en archivos fuente.

Related MCP server: woffu-mcp

Ejecución

npm install
npm run build
npm start

El servidor se comunica mediante MCP stdio. Herramientas disponibles:

• get_ukg_saved_report_csv

• list_ukg_employees

• get_ukg_employee

• get_ukg_timecards

• list_ukg_exceptions

• get_ukg_compensation

• call_ukg_endpoint

Las herramientas de personal usan valores predeterminados de estilo documentado y exponen una anulación opcional de path porque la disponibilidad de endpoints de UKG Ready varía según el tenant y el módulo habilitado. La herramienta genérica acepta cualquier ruta de API, por lo que las credenciales permanecen dentro de la configuración del servidor. Añade herramientas de escritura solo después de confirmar el contrato de endpoints y los permisos del tenant.

Mapeo de empleados de UKG y conductores de Command Cloud

La integración prevista es que un empleado de UKG corresponda a un conductor en Command Cloud. Este mapeo es una relación planificada entre sistemas, no una suposición automática todavía.

Al implementarlo, concilia los registros usando identificadores estables cuando estén disponibles y luego valida con campos de respaldo como nombre de empleado/conductor, número de empleado, teléfono, correo electrónico y estado activo. Mantén un mapeo explícito del ID de empleado de UKG al ID de conductor de Command Cloud; no te bases solo en los nombres porque pueden cambiar o duplicarse.

El mapeo respaldará futuros flujos de trabajo, como comparar tarjetas de tiempo o estado de reloj de UKG con la actividad de conductor, despacho y tickets de Command Cloud. Las reglas reales de coincidencia y las decisiones sobre la fuente de verdad aún deben confirmarse antes de escribir herramientas de sincronización.