Lever 채용 자동화
Lever ATS에서 채용 운영을 Claude Code로 직접 자동화하세요. 채용 공고를 관리하고, 후보자 파이프라인을 추적하며, 인력 요청을 업데이트하고, 기회를 터미널을 벗어나지 않고 조회할 수 있습니다.
툴킷 문서: composio.dev/toolkits/lever
설정
- Composio MCP 서버를 구성에 추가하세요:
https://rube.app/mcp - Lever 명령어를 실행하면 프롬프트가 표시될 때 Lever 계정을 연결하세요. 에이전트가 OAuth 링크를 제공하여 인증을 진행합니다.
- Lever API 키에 필요한 작업(채용 공고, 기회, 인력 요청에 대한 읽기/쓰기 권한)에 충분한 스코프가 있는지 확인하세요.
핵심 워크플로우
1. 채용 공고 조회 및 필터링
모든 채용 공고를 상태, 팀, 부서, 위치 또는 고용 유형별로 선택적으로 필터링하여 검색합니다.
도구: LEVER_LIST_POSTINGS
주요 매개변수:
state--published,internal,closed,draft,pending,rejected로 필터링team,department,location,commitment-- 조직 속성으로 결과 좁히기limit(1-100) 및offset-- 큰 공고 세트를 페이지네이션tag-- 공고 태그로 필터링
예시 프롬프트: "Lever에서 게시된 모든 엔지니어링 채용 공고를 보여줘"
2. 후보자 기회 탐색
채용 파이프라인의 모든 기회를 풍부한 필터링 옵션과 함께 나열하여 파이프라인 분석 및 후보자 추적에 활용합니다.
도구: LEVER_LIST_OPPORTUNITIES
주요 매개변수:
posting_id,stage_id,tag-- 채용 공고, 파이프라인 단계 또는 태그로 필터링email,contact_id-- 특정 후보자의 기회 찾기archived-- 보관 상태로 필터링 (true/false)created_at_start,created_at_end-- 날짜 범위 필터링 (ISO 8601)expand--applications,contact,owner,stage,stageChanges,sources,sourcedBy를 전체 객체로 확장
예시 프롬프트: "시니어 엔지니어 채용 공고에 대한 모든 활성 기회를 연락처 세부 정보와 함께 확장해서 보여줘"
3. 기회 세부 정보 가져오기
단일 후보자 기회에 대한 연락처 정보, 단계 진행 상황, 출처 및 지원 내역 등 포괄적인 세부 정보를 가져옵니다.
도구: LEVER_GET_OPPORTUNITY
주요 매개변수:
opportunity(필수) -- 고유 기회 UIDexpand-- 쉼표로 구분된 확장 필드:contact,stage,owner
예시 프롬프트: "기회 31c9716c-d4e3-47e8-a6a1-54078a1151d6의 전체 세부 정보를 연락처 및 단계와 함께 확장해서 가져와"
4. 인력 요청 관리
인력 요청을 생성, 조회, 업데이트 및 삭제하여 인원 계획과 채용 수요를 추적합니다.
도구: LEVER_LIST_REQUISITIONS, LEVER_GET_REQUISITION, LEVER_UPDATE_REQUISITION, LEVER_DELETE_REQUISITION
업데이트에 필요한 필드:
requisition(필수) -- 인력 요청의 UUIDrequisitionCode(필수) --REQ-001과 같은 고유 코드name(필수) -- 인력 요청 제목headcountTotal(필수) -- 포지션 수 (최소 1)status--open또는closed- 선택 사항:
hiringManager,owner,department,team,location,compensationBand
예시 프롬프트: "인력 요청 REQ-001을 업데이트하여 정원을 3명으로 늘리고 상태를 open으로 변경해"
5. 파이프라인 단계 보기
Lever 계정에 설정된 모든 채용 파이프라인 단계를 검색합니다.
도구: LEVER_LIST_STAGES
주요 매개변수:
limit(1-100) -- 페이지당 최대 항목 수offset-- 이전 응답의 페이지네이션 토큰
예시 프롬프트: "Lever 계정의 모든 파이프라인 단계를 나열해줘"
6. 태그 관리
후보자, 기회 및 채용 공고를 분류하는 데 사용되는 모든 태그를 나열합니다.
도구: LEVER_LIST_TAGS
주요 매개변수:
limit-- 페이지당 최대 항목 수offset-- 페이지네이션 토큰
예시 프롬프트: "Lever의 모든 후보자 태그를 보여줘"
알려진 문제점
- 대용량 데이터셋에 페이지네이션 필요:
LEVER_LIST_OPPORTUNITIES및LEVER_LIST_POSTINGS는 기본적으로 페이지당 최대 100개의 결과를 반환합니다. 응답에서 항상offset토큰을 확인하고 반복하여 전체 결과를 가져오세요. - Expand 파라미터 형식:
LEVER_LIST_OPPORTUNITIES의expand필드는 문자열 배열을 허용하는 반면,LEVER_GET_OPPORTUNITY및LEVER_GET_REQUISITION에서는 쉼표로 구분된 문자열을 허용합니다. 각 도구의 정확한 스키마를 따르세요. - 인력 요청 업데이트는 전체 교체:
LEVER_UPDATE_REQUISITION은 하나의 필드만 변경하려는 경우에도 모든 필수 필드(requisitionCode,name,headcountTotal)가 필요합니다. 항상LEVER_GET_REQUISITION으로 현재 인력 요청을 먼저 가져오세요. - 타임스탬프: 기회 날짜 필터는 ISO 8601 형식을 사용하고,
LEVER_LIST_POSTINGS는updated_at_start에 Unix 타임스탬프(밀리초)를 사용합니다. - 연결 스코프: 쓰기 작업(인력 요청 업데이트/삭제)은 읽기가 성공하더라도 API 토큰에 필요한 권한이 없으면 실패합니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
LEVER_LIST_POSTINGS | 상태, 팀, 부서별 필터링으로 모든 채용 공고 나열 |
LEVER_LIST_OPPORTUNITIES | 파이프라인 필터링으로 후보자 기회 나열 |
LEVER_GET_OPPORTUNITY | 단일 기회의 상세 정보 가져오기 |
LEVER_GET_REQUISITION | ID로 단일 인력 요청 검색 |
LEVER_LIST_REQUISITIONS | 상태/코드 필터링으로 모든 인력 요청 나열 |
LEVER_UPDATE_REQUISITION | 기존 인력 요청 업데이트 (전체 교체) |
LEVER_DELETE_REQUISITION | 인력 요청 삭제/보관 |
LEVER_LIST_STAGES | 모든 파이프라인 단계 나열 |
LEVER_LIST_TAGS | 분류를 위한 모든 태그 나열 |
Composio 제공