자동화할 수 있는 것
1차 면접의 처음부터 끝까지
공고로 면접 만들기
공고 텍스트나 공개 URL 과 함께 언어·질문 수·제한 시간을 보내요. 초안을 미리 보고, 아바타와 목소리를 정해 저장해요.
지원자 초대
한 번에 최대 50명까지 개인 링크를 만들어 이메일로 보내거나 돌려받아요. 만료는 3·7·14·30일 중에서. 공고에 걸 공개 링크도 만들 수 있어요.
진행 상황 확인
상태(초대됨, 진행 중, 완료 등)로 지원자를 거르고 최신순·점수순·추천순으로 정렬해요.
리포트 조회
요약, 역량별 점수, 강점, 우려 사항, 종합 점수, AI 추천을 가져오고, 필요하면 대화 기록과 녹화도 받아요.
결정 기록
합격·불합격·보류를 AI Interview 에 다시 기록해 팀이 대시보드에서 같은 결정을 보게 해요.
리마인더 발송
초대받고 아직 마치지 않은 지원자에게 알림을 보내요.
레퍼런스
REST 와 MCP 에서 같은 이름의 기능 8개
REST 기본 경로 / · MCP 엔드포인트 / (AI STUDIOS 앱 주소 기준)
| 도구 / 기능 | REST 엔드포인트 | 하는 일 | 스코프 |
|---|---|---|---|
list_ | GET / | 면접 목록과 초대·미응시·완료 수 | learning:read |
create_ | POST / | 채용 공고(텍스트·URL)로 면접 생성 — 초안 미리보기 후 저장 | learning:write |
get_ | GET / | 공고 요약, 질문, 제한 시간, 초대 수, 공개 링크 | learning:read |
invite_ | POST / | 개인 링크(이메일 발송 선택) 또는 공개 링크 생성 | learning:write |
list_ | GET / | 지원자별 상태, 종합 점수, AI 추천, 합불 결정 | learning:results |
get_ | GET / | 역량별 점수·강점·우려 사항, 선택 시 대화 기록·녹화 | learning:results |
set_ | PATCH / | 끝난 면접에 합격·불합격·보류 기록 | learning:write |
send_ | POST / | 응시를 마치지 않은 지원자에게 리마인더 | learning:write |
대표 흐름
채용 포지션부터 합불 결정까지
- 1
면접 만들기
create_를interview draft=로 부르면 생성된 질문을 미리 볼 수 있어요.true draft=에 아바타와 목소리를 넣어 다시 부르면 저장돼요.false - 2
지원자 초대
invite_개인 모드는 지원자마다 개인 링크를 돌려주고,candidates send_면 이메일로 보내요. 공개 모드는 공유용 링크 하나를 만들어요.email= true - 3
결과 기다리기
list_를candidates status=,completed sort=로 조회하면 누가 끝냈고 결과가 어떤지 보여요. 나머지는score send_로 알려요.reminders - 4
리포트 보고 결정
get_로 평가를 가져오고, 필요하면candidate_ report include_나transcript include_을 더해요.recording set_으로 결정을 기록해요.candidate_ decision
AI 에이전트용 MCP
반복 업무는 AI 에이전트에게
MCP 서버는 Streamable HTTP 로 동작하는 원격 서버예요. 에이전트가 진행 중인 포지션을 확인하고, 스프레드시트의 지원자를 한꺼번에 초대하고, 누가 끝냈는지 보고, 상위 리포트를 요약해 줄 수 있어요. REST API 와 같은 도구 8개, 같은 권한을 써요.
- 표준 MCP 메서드: initialize, tools/list, tools/call, ping
- 서버가 에이전트에게 대표 호출 순서를 안내해요
- 모든 호출은 현재 워크스페이스에서 소유자·관리자 권한으로 실행

ATS·스크립트용 REST
예측 가능한 JSON, OpenAPI 로 문서화
앞선 호출이 돌려준 ID 를 그대로 쓰고, 커서 페이지네이션과 JSON 본문을 써요. OpenAPI 3.1 명세는 MCP 도구와 같은 정의에서 만들어져 둘이 어긋나지 않아요.
- 오류는 요청 ID 와 함께 application/problem+json 으로
- 키 단위 요청 제한, 초과 시 Retry-After 안내
- 리포트의 녹화 URL 은 10분 뒤 만료

접근 권한·보안
스코프가 있는 키, 워크스페이스 권한
스코프가 있는 API 키
AI STUDIOS API 키를 Bearer 토큰으로 보내요. 읽기·쓰기·결과 조회 권한이 스코프로 나뉘어 있어요.
소유자·관리자만
호출은 현재 워크스페이스에서 실행되고 소유자나 관리자 권한이 필요해요. 회사(팀) 계정이어야 해요.
안전한 테스트
테스트 키는 메일을 보내지 않아서, 실제 지원자에게 연락하지 않고 초대 흐름을 시험해 볼 수 있어요.
자주 묻는 질문
API·MCP 는 어느 요금제에서 쓸 수 있나요?
REST API 와 MCP 서버는 Hiring Team 요금제(월 $179, 연 결제 시 월 $143)부터, 그리고 Enterprise 에 포함돼요.
인증은 어떻게 하나요?
AI STUDIOS API 키를 Bearer 토큰으로 보내요. 키에는 스코프(learning:read, learning:write, learning:results)가 있고, 호출은 현재 워크스페이스에서 소유자나 관리자 권한으로 실행돼요.
면접이 끝나면 웹훅으로 알려 주나요?
지금은 지원하지 않아요. list_candidates 를 status=completed 로 조회해 끝난 면접을 가져오세요. 이벤트 방식 연동이 필요하면 Enterprise 로 문의해 주세요.
ATS 와 기본 연동이 되나요?
지금은 클릭 한 번으로 붙는 ATS 커넥터는 없어요. 대신 REST API 로 ATS 나 스크립트에서 면접 생성, 지원자 초대, 리포트 조회를 할 수 있어요. Enterprise 요금제에는 ATS 연동 지원이 포함돼요.
실제 지원자에게 메일을 보내지 않고 테스트할 수 있나요?
네. 테스트 키는 메일을 보내지 않아요. send_email=false 로 초대하면 링크만 돌려받고, 테스트 모드에서는 리마인더 요청을 거절해요.
어떤 AI 에이전트가 MCP 서버를 쓸 수 있나요?
Bearer 토큰으로 원격 서버(Streamable HTTP)에 연결할 수 있는 MCP 클라이언트라면 쓸 수 있어요. REST API 와 같은 도구 8개를 제공해요.

