HireLab Screener — 개인용 MCP 커넥터

여러분의 Claude가 여러분의 HireLab Screener ATS에서 읽을 수 있게 해 줍니다. 읽기 전용이라 안전합니다. 서비스 계정으로 로그인하여 기존 owner 스코프 API를 호출하므로 모든 테넌트 격리 규칙이 그대로 적용됩니다. Claude는 검색하고 읽을 수 있지만 편집하거나 삭제할 수는 없습니다.

Claude가 할 수 있는 일(도구 15개)

읽기(항상 켜짐)

쓰기 / 작업(MCP_ALLOW_WRITES=true일 때 활성화, 기본값)

이제 Claude에게 원하는 것을 말로 지시하면 됩니다. 예: "Ravi Kumar(ABB, 18 LPA, Pune)를 L&T PLC 채용 건에 추가하고, 내일 그에게 전화하도록 알림을 설정해 줘."

안전

• 모든 작업은 여러분의 ATS에서 소유자 범위(owner-scoped) API를 거치므로, Claude는 항상 여러분 회사의 데이터에만 접근합니다.

• 쓰기 도구에는 MCP 어노테이션이 붙어 있어서, 편집과 이메일 전송 전에 Claude가 확인을 요청합니다.

• 삭제 도구는 노출되지 않습니다. 삭제는 앱에서만 가능합니다.

• Render에서 MCP_ALLOW_WRITES=false로 바꾸면 즉시 읽기 전용으로 돌아갑니다.

Related MCP server: Lever ATS MCP Server

1회 설정

1. ATS에 서비스 계정 만들기

강한 비밀번호로 일반 ATS 사용자를 생성합니다(예: 사용자 이름 claude-mcp). 전용 계정을 사용하면 기존 로그인에 영향 없이 MCP 접근 권한을 언제든 해지할 수 있습니다. 이 계정은 반드시 회사 소속이어야 데이터를 볼 수 있습니다.

2. 이 폴더를 새 Render 서비스로 배포

• 이 폴더를 Git 리포지토리(또는 하위 폴더)에 넣고, 해당 폴더를 가리키는 새 Render Web Service를 생성합니다(ATS 서비스와 분리되어 있음).

• Render는 render.yaml을 사용합니다(build: install requirements, start: python mcp_server.py).

• 새 서비스의 Environment에서 다음을 설정합니다:

  • ATS_BASE_URL = ATS URL. 예: https://hirelabscreener.onrender.com(끝 슬래시 없음)

  • ATS_USERNAME = claude-mcp

  • ATS_PASSWORD = 해당 계정의 비밀번호

  • MCP_SECRET = 긴 임의 문자열(30자 이상 권장). 반드시 비공개로 유지합니다.

  • MCP_ALLOW_WRITES = true로 하면 작업(추가/수정/이메일) 허용, false이면 읽기 전용. 기본값은 true입니다.

• 배포 후, https://<your-mcp-service>.onrender.com/health가 {"status":"ok"}를 반환하는지 확인합니다.

3. Claude에 연결하기

• Claude.ai → 설정 → 커넥터 → 사용자 지정 커넥터 추가.

• 이름: HireLab Screener

• URL: https://<your-mcp-service>.onrender.com/mcp ← /mcp만 사용하고, URL에는 secret을 넣지 않습니다.

• OAuth Client ID / Secret은 비워 둔 뒤, 추가(Add) 를 클릭합니다.

• Claude가 작은 "Connect HireLab Screener" 페이지를 띄웁니다. 여기에 MCP_SECRET을 한 번 입력 하고 Authorize를 클릭하면 연결됩니다.

• 채팅에서 커넥터 메뉴를 열어 활성화한 뒤, 이렇게 질문해 보세요: "내 진행 중인 채용 건 목록을 보여 줘."

왜 secret 페이지가 필요할까요? claude.ai의 웹 커넥터 flow는 개인 서버라도 OAuth 로그인 단계를 요구하므로, 커넥터는 가벼운 OAuth handshake를 수행합니다. MCP_SECRET이 일회성 로그인 도구의 역할입니다. 토큰은 30일 동안 유효하며, MCP_SECRET을 변경하면 즉시 접근이 차단됩니다.

보안 참고사항

• MCP 엔드포인트는 secret 경로 뒤에 있으므로, 이 경로가 없으면 404가 응답됩니다.

• 도구는 읽기 전용입니다. 나중에 쓰기 작업(확인 포함)을 추가하려면 mcp_server.py에서 TOOLS를 확장하세요.

• MCP_SECRET 변경(커넥터 URL 업데이트) 또는 ATS의 서비스 계정 비활성화로 접근 권한을 순환 변경할 수 있습니다.

• 무료 Render 서비스는 유휴 상태이면 절전됩니다. 절전 후 첫 번째 호출은 약 30초 걸릴 수 있습니다. 항상 켜 놓으려면 플랜을 업그레이드하세요.