MCP 연결

Recrua는 MCP로 연결해 씁니다

쓰던 AI 클라이언트(ChatGPT, Claude, Claude Code, Codex)에 Recrua MCP 서버를 연결하면, 구독한 에이전트의 작업 방식과 내 워크스페이스 데이터를 도구로 불러 업무를 진행합니다. 웹사이트에서는 구독·키·업무 자료·전문성 팩을 관리합니다.

  1. 로그인

    계정으로 로그인합니다.

  2. 체험 또는 구독

    에이전트 사용 설명서에서 체험 키(24시간, 예시 데이터로 작업 1건) 또는 구독: 개별 월 19,000원(관리 작업 월 50건), 직무 영역 팀 월 99,000원, 전체 월 990,000원.

  3. 데이터 연결·점검

    역할 키트의 CSV 양식으로 업무 자료를 등록하고 슬롯에 연결한 뒤 사전 점검을 통과시킵니다.

  4. MCP 연결·작업

    클라이언트를 연결하고 get_kit → prepare_work → start_work → submit_work 순서로 작업합니다.

  5. 검토·후속 조치

    내 팀 → 작업에서 근거와 결과를 보고 사람이 검토하고, 후속 조치를 기록합니다.

요금의 월 50건은 관리 작업(start_work) 수입니다. 키트·점검·조회·제출·검토·내보내기는 차감하지 않습니다. Recrua는 Recrua 도구로 연 작업만 셀 수 있으며, 외부 AI 클라이언트 안에서 따로 나누는 대화는 보지도 세지도 않습니다. Claude·Codex 이용 요금은 별도입니다.

클라이언트별 연결

클라이언트Recrua 연결근거
ChatGPT 웹·앱OAuth — Recrua 로그인 후 작업 공간 승인. 요금제·설정(개발자 모드 등)에 따라 다름OpenAI MCP 문서
Claude Code공식 문서상 지원 (--header)Claude Code MCP 문서
Claude 웹·데스크톱 사용자 정의 커넥터 기본 추천OAuth — Recrua 로그인 후 작업 공간 승인. 요금제·워크스페이스 권한에 따라 다름Claude 커넥터 문서
Codex공식 문서상 지원 (bearer_token_env_var)Codex MCP 문서

지원 여부는 각 공식 문서 기준입니다. Claude Code(키 방식)는 로컬 테스트 서버에 실제로 연결해 작업을 끝까지 실행해 확인했습니다. Claude 웹은 운영 서버에서 Recrua 로그인·OAuth 연결·역할 키트 조회를 확인했습니다. ChatGPT·Codex와 Claude 데스크톱·모바일의 실제 연결은 아직 확인하지 않았습니다.

ChatGPT (OAuth)

  1. ChatGPT 설정의 앱(커넥터) 메뉴에서 새 MCP 앱을 추가합니다. 메뉴 이름과 사용 가능 여부(개발자 모드 등)는 ChatGPT 요금제·워크스페이스 설정에 따라 다릅니다.
  2. MCP 서버 URL에 https://recrua.store/api/mcp를 넣고 인증은 OAuth를 고릅니다.
  3. Recrua 로그인 화면이 열리면 기존 Recrua 계정으로 로그인하고, 승인 화면에서 연결할 앱·작업 공간·범위를 확인한 뒤 허용합니다.

Claude 웹·데스크톱 (OAuth)

  1. Claude 설정의 커넥터에서 사용자 정의 커넥터를 추가합니다(요금제·조직 권한에 따라 다름).
  2. 원격 MCP 서버 URL에 https://recrua.store/api/mcp를 넣고 OAuth로 연결합니다(요청 헤더 불필요).
  3. Recrua 로그인 → 승인 화면에서 앱·작업 공간·범위를 확인하고 허용합니다.

서버 URL은 https://recrua.store/api/mcp를 그대로 입력합니다. 승인 화면은 연결할 앱(돌아갈 주소), 작업 공간, 범위(mcp, 연결 유지 offline_access)를 보여 주며, 허용하기 전에는 아무 권한도 생기지 않습니다. 연결은 설정 → 연결된 AI 앱에서 확인·해지합니다. 도구 사용에는 이 작업 공간의 구독이 필요하고, 체험은 체험 키로만 합니다. 연결된 AI 앱

Claude Code
export RECRUA_API_KEY="<설정에서 발급한 mcp 범위 키>"
claude mcp add --transport http recrua https://recrua.store/api/mcp \
  --header "Authorization: Bearer $RECRUA_API_KEY"
Codex config.toml
[mcp_servers.recrua]
url = "https://recrua.store/api/mcp"
bearer_token_env_var = "RECRUA_API_KEY"

도구와 실행 방식

도구하는 일차감
get_kit역할 키트: 끝낼 업무, 데이터 슬롯·필수 열·형식 규칙, 필수 매개변수, 서버 계산과 AI 작성 범위, 결과 스키마, 후속 조치무료
bind_data내 데이터셋을 역할 슬롯에 명시 연결(항목마다 다른 열)무료
prepare_work사전 점검: 누락 열·형식 오류·중복·관계·매개변수 → ready 여부무료
start_work관리 작업 1건 열기: 근거 스냅샷(source_id)·서버 계산·후속 조치 고정. 같은 request_id 재시도는 같은 작업관리 작업 1건
get_work · list_work작업 상태·계산 결과·근거 행·제출 결과·검토·후속 조치 읽기무료
submit_work클라이언트 모델이 쓴 결과를 스키마로 제출(근거 ID가 이 작업 스냅샷 안인지 확인, 내용 정확성은 검증 안 함)무료
update_followup · export_work후속 조치 기록, Markdown·CSV 내보내기(수식 실행 방지)무료
list_agents · get_agent_context에이전트 목록, 역할 맥락·데이터 연결 요약무료
search_db · search_knowledge내 데이터 검색·매칭(source_id), 검증된 규정 자료 검색무료
import_dataset내 워크스페이스 업무 DB에 CSV 가져오기(웹 가져오기와 같은 규칙: 2MB·5,000행·40열, 자료 편집 권한 필요, 체험 키 불가). 돌려주는 값은 dataset_id·이름·행 수·열 이름무료
get_business_evidence공동구매·정산(47)·CS(86·87·90) 업무 근거 조회: 내 워크스페이스의 사례·결과·수정·출처 기록 연결, 보류 사유·한계 표시(조회 전용, 자료 권한 필요)무료
settlement_register공구 정산 대장(집계) 합산·실마진 대사(47번 포함 구독, 원본 보고값이며 확정 순매출 아님)무료
get_pack · set_pack · pipeline전문성 팩, L4 진행 기록무료
run_agent · refine_runRecrua 서버 모델 초안 — 운영자 AI 연결 시에만. work_id를 주면 그 작업 안에서 추가 차감 없음(작업당 3회)work_id 없으면 1건

관리 작업 도구는 Recrua 서버 AI 없이 동작합니다. 서버는 데이터 점검·계산·근거 고정을 하고, 결과 문장은 연결한 클라이언트의 모델이 근거(source_id)를 인용해 씁니다. 서버 실행(run_agent)은 운영자가 AI 제공자를 연결한 경우에만 됩니다(서비스 상태).

모든 고객에게 공용으로 제공하는 전문가·에이전시 데이터셋은 아직 없습니다. 회사별로 승인·등록한 자료만 해당 워크스페이스에서 조회하며, 역할별 계산에는 필요한 데이터 슬롯을 별도로 연결합니다.

연결 설정과 역할 지시문은 다릅니다

이 페이지에서 입력하는 것은 서버 주소와 인증(OAuth 승인 또는 키 자리표시자)뿐입니다. Recrua는 역할 지시문을 복사해 외부 대화에 붙여 쓰는 방식을 제공하지 않습니다. 역할의 키트와 계산은 인증(OAuth 또는 키)을 거친 MCP 도구로만 전달되고, 근거는 작업마다 고정한 스냅샷의 source_id로 추적됩니다.