ComposioHQ/Workday-Automation

Workday 자동화

Claude Code에서 직접 Workday HR 작업을 자동화하세요. 터미널을 벗어나지 않고 직원 검색, 휴가 요청 생성, 잔여 휴가 확인, 휴가 자격 검증을 수행할 수 있습니다.

툴킷 문서: composio.dev/toolkits/workday

---

설정

1. Claude Code 설정에 Rube MCP 서버를 추가합니다: https://rube.app/mcp
2. 프롬프트가 표시되면 제공된 연결 링크를 통해 Workday 계정을 인증합니다.
3. 자연어로 HR 워크플로를 자동화하기 시작합니다.

---

핵심 워크플로

1. 직원 검색 및 목록

검색 및 페이지네이션을 통해 직원 정보를 조회합니다.

도구: WORKDAY_LIST_WORKERS

"Sarah"라는 이름의 직원을 검색하고 퇴직자를 포함하세요.

주요 매개변수:

• search -- 이름 또는 직원 ID로 검색 (대소문자 구분 없음, 공백으로 구분하여 OR 검색)
• includeTerminatedWorkers -- 결과에 퇴직자 포함
• limit (기본값 20, 최대 100) / offset -- 페이지네이션 제어

2. 휴가 요청 생성

전체 비즈니스 프로세스 지원으로 직원의 휴가 요청을 제출합니다.

도구: WORKDAY_CREATE_TIME_OFF_REQUEST

직원 abc123의 2026년 3월 15일부터 17일까지 휴가 요청을 생성하세요 (매일 8시간).

주요 매개변수:

• ID (필수) -- Workday 직원 ID
• businessProcessParameters (필수) -- id 필드가 있는 action을 포함해야 함 (제출 작업에 "d9e4223e446c11de98360015c5e6daf6" 사용)
• days (필수) -- 각각 다음을 포함하는 휴가 항목 배열:
  • date (필수) -- yyyy-mm-dd 형식의 날짜
  • timeOffType (필수) -- 적격 휴가 유형의 id를 포함하는 객체
  • dailyQuantity -- 시간 또는 일수
  • comment, start, end, position, reason -- 선택적 필드
• businessProcessParameters.comment -- 선택적 비즈니스 프로세스 설명

3. 휴가 자격 확인

요청을 제출하기 전에 직원이 특정 날짜에 휴가를 사용할 수 있는지 확인합니다.

도구: WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES

직원 abc123이 2026년 3월 15일에 휴가를 사용할 수 있는지 확인하세요.

주요 매개변수:

• ID (필수) -- Workday 직원 ID
• date -- 확인할 특정 날짜 (yyyy-mm-dd)
• position -- 특정 직위 ID로 필터링
• timeOff -- 특정 휴가 계획/유형 ID로 필터링
• limit (최대 100) / offset -- 페이지네이션

4. 잔여 휴가 확인

모든 계획에 대한 직원의 잔여 휴가를 확인합니다.

도구: WORKDAY_LIST_ABSENCE_BALANCES

조직의 모든 직원에 대한 잔여 휴가를 보여주세요.

• 휴가 계획 및 휴직 유형에 대한 잔여량을 조회합니다.
• 직원 ID, 카테고리, 유효 날짜로 필터링할 수 있습니다.

5. 현재 사용자 프로필 가져오기

인증된 직원의 프로필 정보를 조회합니다.

도구: WORKDAY_GET_CURRENT_USER

내 Workday 프로필 정보를 보여주세요.

• 매개변수가 필요하지 않습니다.
• 인증된 직원의 프로필을 반환합니다.
• 이후 작업을 위해 직원 ID를 얻으려면 먼저 이 도구를 사용하세요.

6. 휴가 내역 보기

특정 직원의 휴가 세부 정보 및 내역을 조회합니다.

도구: WORKDAY_GET_WORKER_TIME_OFF_DETAILS

직원 abc123의 휴가 내역을 보여주세요.

• 지정된 직원의 휴가 세부 정보 컬렉션을 조회합니다.
• 휴가 사용 및 잔여량 감사에 유용합니다.

---

알려진 문제점

• 직원 ID 확인: 항상 WORKDAY_GET_CURRENT_USER 또는 WORKDAY_LIST_WORKERS를 먼저 호출하여 Workday 직원 ID를 확인하세요. 직원 ID는 Workday 고유 UUID이며 직원 번호가 아닙니다.
• 휴가 유형 ID는 유효해야 함: WORKDAY_CREATE_TIME_OFF_REQUEST의 timeOffType.id는 해당 직원에 대해 유효한 적격 휴가 유형을 참조해야 합니다. "Get Worker Eligible Absence Types" 워크플로를 사용하여 유효한 유형 ID를 찾으세요.
• 제출 작업 ID: businessProcessParameters.action.id는 제출 작업에 대해 "d9e4223e446c11de98360015c5e6daf6"여야 합니다. 잘못된 ID를 사용하면 비즈니스 프로세스가 실패합니다.
• 날짜 형식: 모든 날짜 필드는 yyyy-mm-dd 형식을 사용합니다. 날짜 전용 필드에는 타임스탬프가 있는 ISO 8601이 허용되지 않습니다.
• 페이지네이션 제한: 모든 Workday 엔드포인트에서 최대 limit는 100입니다. 기본값은 20입니다. 완전한 데이터셋을 위해 항상 페이지네이션을 사용하세요.
• 비즈니스 프로세스 승인: 휴가 요청 생성은 비즈니스 프로세스를 시작하지만 승인을 보장하지는 않습니다. 요청은 일반 승인 워크플로에 들어갑니다.

---

빠른 참조

도구 슬러그	설명
WORKDAY_LIST_WORKERS	직원 검색 및 인력 정보 목록 표시
WORKDAY_GET_CURRENT_USER	인증된 직원의 프로필 가져오기
WORKDAY_CREATE_TIME_OFF_REQUEST	휴가 요청 제출 (ID, businessProcessParameters, days 필요)
WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES	휴가 날짜 자격 확인 (ID 필요)
WORKDAY_LIST_ABSENCE_BALANCES	휴가 계획별 잔여 휴가 조회
WORKDAY_GET_WORKER_TIME_OFF_DETAILS	직원의 휴가 내역 가져오기

---

Composio 제공