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

인력 도구는 문서화된 스타일의 기본값을 사용하며, UKG Ready 엔드포인트 가용성은 테넌트와 활성화된 모듈에 따라 다르므로 선택적 path 재정의를 노출합니다. 일반 도구는 모든 API 경로를 허용하므로 자격 증명은 서버 구성 내에 유지됩니다. 테넌트의 엔드포인트 계약과 권한이 확인된 후에만 쓰기 도구를 추가하세요.

UKG 직원과 Command Cloud 드라이버 매핑

의도된 통합은 UKG 직원이 Command Cloud의 드라이버에 대응하는 것입니다. 이 매핑은 계획된 교차 시스템 관계이며, 아직 자동 가정이 아닙니다.

구현할 때는 사용 가능한 안정적인 식별자를 사용하여 레코드를 대조한 다음, 직원/드라이버 이름, 직원 번호, 전화, 이메일, 활성 상태와 같은 보조 필드로 검증하세요. UKG 직원 ID와 Command Cloud 드라이버 ID의 명시적 매핑을 유지하세요. 이름은 변경되거나 중복될 수 있으므로 이름만으로 의존하지 마세요.

이 매핑은 UKG 근무 기록이나 시계 상태를 Command Cloud 드라이버, 디스패치, 티켓 활동과 비교하는 것과 같은 향후 워크플로를 지원할 것입니다. 실제 매칭 규칙과 신뢰 소스 결정은 동기화 도구를 작성하기 전에 여전히 확인이 필요합니다.