UKG Ready MCP

MCP-сервер для REST-эндпоинтов UKG Ready, включая сотрудников, табели учета рабочего времени, исключения, компенсации, сохраненные отчеты и универсальный инструмент для аутентифицированных эндпоинтов.

Конфигурация

Скопируйте .env.example в локальный файл конфигурации окружения и задайте:

• UKG_BASE_URL: базовый URL тенанта UKG, по умолчанию https://secure.entertimeonline.com.

• UKG_API_KEY, UKG_USERNAME, UKG_PASSWORD, UKG_COMPANY.

• UKG_DEFAULT_REPORT_ID: необязательный идентификатор сохраненного отчета.

Никогда не фиксируйте реальные учетные данные в системе контроля версий и не помещайте их в исходные файлы.

Related MCP server: woffu-mcp

Запуск

npm install
npm run build
npm start

Сервер взаимодействует через MCP stdio. Доступные инструменты:

• get_ukg_saved_report_csv

• list_ukg_employees

• get_ukg_employee

• get_ukg_timecards

• list_ukg_exceptions

• get_ukg_compensation

• call_ukg_endpoint

Инструменты для работы с персоналом используют значения по умолчанию, соответствующие документированным, и предоставляют необязательный параметр path для переопределения, поскольку доступность эндпоинтов UKG Ready зависит от тенанта и включенных модулей. Универсальный инструмент принимает любой путь API, поэтому учетные данные остаются внутри конфигурации сервера. Добавляйте инструменты записи только после подтверждения контракта эндпоинтов и прав доступа тенанта.

Сопоставление сотрудника UKG и драйвера Command Cloud

Предполагаемая интеграция заключается в том, что сотрудник UKG соответствует драйверу в Command Cloud. Это сопоставление — запланированная межсистемная связь, а не автоматическое допущение на текущий момент.

При реализации сверяйте записи, используя стабильные идентификаторы там, где они доступны, затем проверяйте по вспомогательным полям, таким как имя сотрудника/драйвера, табельный номер, телефон, электронная почта и статус активности. Ведите явное сопоставление идентификатора сотрудника UKG с идентификатором драйвера Command Cloud; не полагайтесь только на имена, поскольку имена могут меняться или дублироваться.

Сопоставление будет поддерживать будущие рабочие процессы, такие как сравнение табелей UKG или статуса отметок времени с активностью драйвера, диспетчеризации и заявок в Command Cloud. Фактические правила сопоставления и решения об источнике достоверных данных еще предстоит подтвердить перед написанием инструментов синхронизации.