API·MCP

우리 시스템에서
1차 면접을 돌리세요

대시보드를 열지 않고도 채용 공고로 면접을 만들고, 지원자를 초대하고, 점수 리포트를 읽어요. ATS 나 스크립트에서는 REST API 로, AI 에이전트는 MCP 서버로 연결해요.

REST API 와 MCP 는 Hiring Team 요금제부터 포함돼요.

API 로 가져오는 리포트 데이터 — AI 추천 의견, 역량 요약, 녹화, 시간별 스크립트
같은 리포트의 역량별 점수와 역량 균형 차트
REST · JSON 원격 MCP 서버 OpenAPI 3.1 명세 스코프가 있는 API 키

자동화할 수 있는 것

1차 면접의 처음부터 끝까지

공고로 면접 만들기

공고 텍스트나 공개 URL 과 함께 언어·질문 수·제한 시간을 보내요. 초안을 미리 보고, 아바타와 목소리를 정해 저장해요.

지원자 초대

한 번에 최대 50명까지 개인 링크를 만들어 이메일로 보내거나 돌려받아요. 만료는 3·7·14·30일 중에서. 공고에 걸 공개 링크도 만들 수 있어요.

진행 상황 확인

상태(초대됨, 진행 중, 완료 등)로 지원자를 거르고 최신순·점수순·추천순으로 정렬해요.

리포트 조회

요약, 역량별 점수, 강점, 우려 사항, 종합 점수, AI 추천을 가져오고, 필요하면 대화 기록과 녹화도 받아요.

결정 기록

합격·불합격·보류를 AI Interview 에 다시 기록해 팀이 대시보드에서 같은 결정을 보게 해요.

리마인더 발송

초대받고 아직 마치지 않은 지원자에게 알림을 보내요.

레퍼런스

REST 와 MCP 에서 같은 이름의 기능 8개

REST 기본 경로 /api/interview/v1 · MCP 엔드포인트 /api/interview/mcp (AI STUDIOS 앱 주소 기준)

도구 / 기능REST 엔드포인트하는 일스코프
list_interviewsGET /interviews면접 목록과 초대·미응시·완료 수learning:read
create_interviewPOST /interviews채용 공고(텍스트·URL)로 면접 생성 — 초안 미리보기 후 저장learning:write
get_interviewGET /interviews/{interview_id}공고 요약, 질문, 제한 시간, 초대 수, 공개 링크learning:read
invite_candidatesPOST /interviews/{interview_id}/invites개인 링크(이메일 발송 선택) 또는 공개 링크 생성learning:write
list_candidatesGET /interviews/{interview_id}/candidates지원자별 상태, 종합 점수, AI 추천, 합불 결정learning:results
get_candidate_reportGET /interviews/{interview_id}/candidates/{session_id}/report역량별 점수·강점·우려 사항, 선택 시 대화 기록·녹화learning:results
set_candidate_decisionPATCH /interviews/{interview_id}/candidates/{session_id}끝난 면접에 합격·불합격·보류 기록learning:write
send_remindersPOST /interviews/{interview_id}/reminders응시를 마치지 않은 지원자에게 리마인더learning:write

대표 흐름

채용 포지션부터 합불 결정까지

  1. 1

    면접 만들기

    create_interview 를 draft=true 로 부르면 생성된 질문을 미리 볼 수 있어요. draft=false 에 아바타와 목소리를 넣어 다시 부르면 저장돼요.

  2. 2

    지원자 초대

    invite_candidates 개인 모드는 지원자마다 개인 링크를 돌려주고, send_email=true 면 이메일로 보내요. 공개 모드는 공유용 링크 하나를 만들어요.

  3. 3

    결과 기다리기

    list_candidates 를 status=completed, sort=score 로 조회하면 누가 끝냈고 결과가 어떤지 보여요. 나머지는 send_reminders 로 알려요.

  4. 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
  • 서버가 에이전트에게 대표 호출 순서를 안내해요
  • 모든 호출은 현재 워크스페이스에서 소유자·관리자 권한으로 실행
API 가 구조화된 데이터로 돌려주는 지원자 리포트

ATS·스크립트용 REST

예측 가능한 JSON, OpenAPI 로 문서화

앞선 호출이 돌려준 ID 를 그대로 쓰고, 커서 페이지네이션과 JSON 본문을 써요. OpenAPI 3.1 명세는 MCP 도구와 같은 정의에서 만들어져 둘이 어긋나지 않아요.

  • 오류는 요청 ID 와 함께 application/problem+json 으로
  • 키 단위 요청 제한, 초과 시 Retry-After 안내
  • 리포트의 녹화 URL 은 10분 뒤 만료
create_interview 가 자동화하는 공고로 면접 만들기 화면

접근 권한·보안

스코프가 있는 키, 워크스페이스 권한

스코프가 있는 API 키

AI STUDIOS API 키를 Bearer 토큰으로 보내요. 읽기·쓰기·결과 조회 권한이 스코프로 나뉘어 있어요.

소유자·관리자만

호출은 현재 워크스페이스에서 실행되고 소유자나 관리자 권한이 필요해요. 회사(팀) 계정이어야 해요.

안전한 테스트

테스트 키는 메일을 보내지 않아서, 실제 지원자에게 연락하지 않고 초대 흐름을 시험해 볼 수 있어요.

지원자 이름·이메일·리포트는 개인정보예요. 채용 결정에 참여하는 사람에게만 공유하고, 최종 판단은 사람이 하세요. AI 추천 의견은 참고용이에요.

연동

웹훅이나 더 깊은 ATS 연동이 필요하세요?

지금 API 는 조회(pull) 방식이고, 클릭 한 번으로 붙는 ATS 커넥터는 없어요. Enterprise 요금제에는 ATS 연동 지원이 포함되고, SSO·SLA·데이터 위치 요건은 영업팀과 협의해요.

자주 묻는 질문

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개를 제공해요.

1차 면접 파이프라인을 만들어 보세요

무료로 제품을 먼저 써 보고, 연동할 준비가 되면 Hiring Team 으로 옮기세요.