UKG Ready MCP

用于 UKG Ready REST 端点的 MCP 服务器，包括员工、考勤卡、异常、薪酬、已保存报表，以及一个通用的已认证端点工具。

配置

将 .env.example 复制到本地环境配置中，并设置：

• UKG_BASE_URL：UKG 租户基础 URL，默认为 https://secure.entertimeonline.com。

• UKG_API_KEY、UKG_USERNAME、UKG_PASSWORD、UKG_COMPANY。

• UKG_DEFAULT_REPORT_ID：可选的已保存报表 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 员工 ID 与 Command Cloud 驾驶员 ID 之间的显式映射；不要仅依赖姓名，因为姓名可能发生变化或重复。

该映射将支持未来的工作流，例如将 UKG 考勤卡或打卡状态与 Command Cloud 的驾驶员、调度和工单活动进行比较。在编写同步工具之前，仍需确认实际的匹配规则和权威数据源决策。