Ashby 자동화은(는) 무엇을 하나요?
Claude Code에서 직접 Ashby ATS 채용 운영을 자동화하세요. 지원자 생성, 채용 공고 게시, 지원서 관리, 면접 일정 확인, 인재 풀 검색을 터미널을 벗어나지 않고 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/ashby
설정
- Claude Code 설정에 URL
https://rube.app/mcp로 Rube MCP 서버를 추가합니다. - 안내가 나타나면 제공된 연결 링크를 통해 Ashby 계정을 인증합니다.
- 자연어로 채용 워크플로우 자동화를 시작합니다.
핵심 워크플로우
1. 지원자 관리
지원자를 생성, 목록 조회, 검색, 업데이트 및 상세 정보를 검색합니다.
도구: ASHBY_CREATE_CANDIDATE, ASHBY_LIST_CANDIDATES, ASHBY_SEARCH_CANDIDATES, ASHBY_GET_CANDIDATE_INFO, ASHBY_UPDATE_CANDIDATE
"Jane Smith"라는 지원자를 생성합니다. 이메일은 [email protected], LinkedIn 프로필은 https://linkedin.com/in/janesmith 입니다.
ASHBY_CREATE_CANDIDATE 주요 매개변수:
name(필수) -- 지원자의 전체 이름email-- 기본 이메일 주소phoneNumber,linkedInUrl,githubUrl,websiteUrl-- 연락처/소셜 프로필
ASHBY_SEARCH_CANDIDATES 주요 매개변수:
email-- 정확한 이메일 일치name-- 부분 이름 일치
ASHBY_LIST_CANDIDATES 주요 매개변수:
perPage(최대 100) /cursor-- 페이지네이션syncToken-- 마지막 동기화 이후 증분 업데이트용
2. 채용 공고 생성 및 조회
새 채용 공고를 게시하고 기존 포지션을 검색합니다.
도구: ASHBY_CREATE_JOB, ASHBY_LIST_JOBS, ASHBY_GET_JOB_INFO
팀 dept-123, 위치 loc-456, 브랜드 brand-789에 "Senior Software Engineer" 채용 공고를 새로 생성합니다.
ASHBY_CREATE_JOB 주요 매개변수:
title(필수) -- 채용 공고 제목teamId(필수) -- 부서/팀 ID (부서 목록에서 확인)locationId(필수) -- 사무실 위치 ID (위치 목록에서 확인)brandId(필수) -- 고용주 브랜드 ID (브랜드 목록에서 확인)defaultInterviewPlanId-- 지원서를 받기 위해 공고를 개설하는 데 필요jobTemplateId-- 템플릿에서 미리 채우기
ASHBY_LIST_JOBS 주요 매개변수:
perPage(최대 100) /cursor/syncToken-- 페이지네이션 및 증분 동기화
참고: 새로 생성된 채용 공고는 "Draft" 상태로 시작합니다. 공고를 게시/개설하려면 defaultInterviewPlanId를 설정해야 합니다.
3. 지원서 관리
지원자를 채용 공고에 연결하고 진행 상황을 추적하는 지원서를 생성합니다.
도구: ASHBY_CREATE_APPLICATION, ASHBY_LIST_APPLICATIONS
지원자 cand-abc123을 채용 공고 job-xyz789에 지원합니다. 출처는 src-referral입니다.
ASHBY_CREATE_APPLICATION 주요 매개변수:
candidateId(필수) -- 기존 지원자의 UUIDjobId(필수) -- 기존 채용 공고의 UUIDsourceId-- 지원 출처의 UUID (LinkedIn, 추천 등)creditedToUserId-- 크레딧을 부여할 채용 담당자/추천인의 UUIDinterviewStageId-- 특정 단계에 직접 배치 (기본값은 첫 번째 단계)
ASHBY_LIST_APPLICATIONS 주요 매개변수:
perPage(최대 100) /cursor/syncToken-- 페이지네이션 및 증분 동기화
4. 면접 일정 확인
면접 시간, 면접관, 지원자 세부 정보가 포함된 예정된 면접 목록을 확인합니다.
도구: ASHBY_LIST_INTERVIEW_SCHEDULES
예정된 모든 면접 일정을 보여주세요.
주요 매개변수:
perPage(최대 100) /cursor-- 페이지네이션syncToken-- 변경된 일정의 증분 동기화
5. 지원자 메모
지원자에 대한 내부 메모, 관찰 내용, 채용 담당자 코멘트를 확인합니다.
도구: ASHBY_LIST_CANDIDATE_NOTES
지원자 cand-abc123에 대한 모든 메모를 보여주세요.
- 채용 담당자 및 채용 팀 구성원이 추가한 모든 메모 검색
- 면접 피드백 및 내부 평가 검토에 유용
6. 파이프라인 보고
목록 도구를 결합하여 채용 파이프라인 보고서를 작성합니다.
도구: ASHBY_LIST_CANDIDATES, ASHBY_LIST_APPLICATIONS, ASHBY_LIST_JOBS
모든 지원서를 나열하여 현재 채용 파이프라인 상태를 확인합니다.
- 증분 데이터 가져오기를 위해
syncToken사용 (반복 보고서에 효율적) - 전체 파이프라인 가시성을 위해 지원자, 지원서, 채용 공고 데이터 결합
- 완전한 데이터셋을 위해
cursor로 모든 결과 페이지네이션
알려진 문제점
- 채용 공고가 Draft로 시작:
ASHBY_CREATE_JOB을 통해 새로 생성된 채용 공고는 "Draft" 상태로 시작하며,defaultInterviewPlanId가 설정되고 공고가 개설될 때까지 지원서를 받을 수 없습니다. - 채용 공고에 4개의 필수 필드:
ASHBY_CREATE_JOB에는title,teamId,locationId,brandId가 필요합니다. 부서, 위치, 브랜드 목록 엔드포인트를 사용하여 유효한 ID를 찾으세요. - 지원서보다 먼저 지원자: 지원서를 생성하기 전에 지원자가 먼저 존재해야 합니다. 항상 먼저 지원자를 생성하거나 찾은 다음 지원서를 생성하세요.
- 커서 기반 페이지네이션: 모든 목록 엔드포인트는
perPage(최대 100) 및cursor와 함께 커서 기반 페이지네이션을 사용합니다. 임의 페이지로 이동할 수 없으며 순차적으로 반복해야 합니다. - 효율성을 위한
syncToken: 이전 응답의syncToken을 사용하여 변경된 레코드만 가져옵니다. 이렇게 하면 반복 워크플로우에서 API 호출이 크게 줄어듭니다. - 모든 곳에서 UUID 형식: 모든 ID(지원자, 채용 공고, 지원서, 단계)는 UUID입니다. 형식이 잘못된 ID를 전달하면 400 오류가 반환됩니다.
- 검색 제한 사항:
ASHBY_SEARCH_CANDIDATES는 정확한 이메일 일치 또는 부분 이름 일치를 지원하지만 결합 쿼리나 다른 필드는 지원하지 않습니다. 더 광범위한 검색을 위해서는 페이지네이션과 함께ASHBY_LIST_CANDIDATES를 사용하세요.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
ASHBY_CREATE_CANDIDATE | 새 지원자 생성 (name 필수) |
ASHBY_LIST_CANDIDATES | 페이지네이션 및 동기화로 모든 지원자 목록 조회 |
ASHBY_SEARCH_CANDIDATES | 이메일 또는 이름으로 지원자 검색 |
ASHBY_GET_CANDIDATE_INFO | 지원자 전체 세부 정보 가져오기 (candidateId 필수) |
ASHBY_UPDATE_CANDIDATE | 지원자 프로필 정보 업데이트 |
ASHBY_LIST_CANDIDATE_NOTES | 지원자에 대한 내부 메모 목록 조회 |
ASHBY_CREATE_JOB | 채용 공고 생성 (title, teamId, locationId, brandId 필수) |
ASHBY_LIST_JOBS | 페이지네이션 및 동기화로 모든 채용 공고 목록 조회 |
ASHBY_GET_JOB_INFO | ID로 채용 공고 전체 세부 정보 가져오기 |
ASHBY_CREATE_APPLICATION | 지원자를 채용 공고에 지원 (candidateId, jobId 필수) |
ASHBY_LIST_APPLICATIONS | 페이지네이션 및 동기화로 모든 지원서 목록 조회 |
ASHBY_LIST_INTERVIEW_SCHEDULES | 페이지네이션으로 예정된 면접 목록 조회 |
Composio 제공