불러오는 중
불러오는 중
사용 설명서 · RC-119
만들려는 MCP 서버가 AI에게 내줄 도구를 이름, 입력·출력 스키마, 권한 범위, 오류 케이스 수준에서 정의하는 담당입니다. 구현 언어나 배포 구조가 아닌 인터페이스 계약에 집중합니다.
추천 방식: Claude Code 또는 Codex — 코드·설정 초안을 직접 검토·실행하는 개발·자동화 업무라 터미널형 코딩 도구(Claude Code 또는 Codex) 중 이미 쓰는 쪽을 권합니다.
업무 흐름에 맞춘 제품 추천이며 모델 성능 비교가 아닙니다. 외부 AI 요금은 Recrua 결제와 별도입니다.
로그인한 내 워크스페이스에서 MCP 도구 인터페이스 설계 담당을(를) 내 팀에 추가하고 채팅으로 맡깁니다. 대화·첨부 자료·사용량이 이 사이트에 남습니다.
프로필에서 하는 일·하지 않는 일을 보고, AI 실행 상태(연결 안 됨)와 무료 체험 1회를 확인합니다.
필수 입력 항목(만들 서버 설명)을 채웁니다. "예시로 채우기"로 형식을 익히고, 요금제가 있으면 회사 팩에 판단 기준을 등록합니다.
도구 목록과 이름 규칙, 입력·출력 스키마 초안, 권한 범위표, 오류 케이스 정의 초안을 받고 후속 질문으로 고칩니다. 메시지 1개 = 1회 호출, 제공자 오류 시 복구.
검수 포인트 표에서 "도구 이름이 하는 일을 분명히 드러내고 서로 겹치지 않는지 확인" 등을 확인하고 승인·반려합니다.
| 도구·기능·자료 | 필수 | 용도 | 준비 방법·권한 | 단계 | 상태 |
|---|---|---|---|---|---|
| 웹 브라우저 | 필수 | 초안용 | 설치할 앱 없음. 최신 브라우저로 접속 | 준비 | 사용 가능 |
| 구독 | 선택 | 초안용 | 개별 구독 월 19,000원(월 50회) · AI 개발·스킬 직무 영역 팀 월 99,000원 · 전체 월 990,000원 | 준비 | 구독·권한 필요 |
| 자료: 만들 서버 설명 | 필수 | 초안용 | 예: 연결할 시스템, AI에게 맡길 일 | 자료 연결 | 사용자가 직접 준비 |
| 자료: 데이터 구조 | 선택 | 초안용 | 예: 테이블 열, 기존 API 응답 예 | 자료 연결 | 사용자가 직접 준비 |
| 자료: 제약 조건 | 선택 | 초안용 | 예: 읽기 전용 여부, 승인 절차 | 자료 연결 | 사용자가 직접 준비 |
| 회사 전문성 팩 | 선택 | 초안용 | 구독 중 + 팩 편집 권한. 작업 화면 "전문성 팩"에서 등록 | 자료 연결 | 구독·권한 필요 |
| MCP SDK(사용자 선택) | 선택 | 실행용 | 구현과 실행은 사용자가 직접 하며 Recrua는 실행하지 않습니다. 스펙과 SDK 사용법은 [공식 문서 확인]. | 실행 | 사용자가 직접 준비 |
| AI 실행(Recrua 서버) | 필수 | 초안용 | 운영자가 AI 제공자를 연결하기 전까지 실행하지 않고 차감도 없음 | 실행 | 연결 안 됨 |
| 무료 체험 1회 | 선택 | 초안용 | 에이전트마다 1회 무료(AI 실행 연결 시) | 실행 | 연결 안 됨 |
| 로그인 후 웹 채팅 | 선택 | 초안용 | 가입·로그인 → 내 팀에 추가 → 채팅. 후속 질문과 파일 첨부(TXT·MD·CSV·JSON·PDF·DOCX)도 1회 호출로 셉니다 | 실행 | 연결 안 됨 |
| 항목 | 필수 | 예시 (작성 예) |
|---|---|---|
| 만들 서버 설명 | 필수 | 사내 재고 관리 DB를 조회하는 MCP 서버를 만들려 합니다. AI가 품목 재고 확인과 입고 예정 조회를 하고, 발주 요청 초안까지 만들 수 있게 하고 싶습니다. |
| 데이터 구조 | 선택 | items(sku, name, qty, location), inbound(sku, eta, qty) |
| 제약 조건 | 선택 | 쓰기 작업은 사람 승인 후에만 가능해야 합니다. |
사내 재고 조회 MCP 서버 도구 인터페이스 예시
| get_item_stock | 품목 재고 조회 |
| list_inbound | 입고 예정 조회 |
| draft_purchase_request | 발주 요청 초안 |
| 조회 도구 | 읽기 전용 |
| 발주 초안 | 사람 승인 후 반영 |
| 없는 sku | 품목 없음 안내 |
| 권한 부족 | 승인 필요 안내 |
성공 기준: 도구 목록과 이름 규칙, 입력·출력 스키마 초안, 권한 범위표, 오류 케이스 정의가 모두 들어 있고, 검수 포인트의 ✗ 항목이 해소되었으며, 확인 필요 사항이 사용자 자료나 담당자 확인으로 정리된 상태.
| 문제 | 해결 |
|---|---|
| 필수 항목이 비어 실행되지 않음 | 필수 입력 항목(만들 서버 설명)을 채웁니다. 무엇을 넣을지 모르면 "예시로 채우기"를 먼저 봅니다. |
| "AI 제공자가 연결되지 않아 실행하지 않았습니다" | 운영자가 AI 제공자를 연결하기 전입니다. 차감되지 않았으니 GPT·Claude 지시문 방식으로 진행할 수 있습니다. |
| 무료 체험 1회를 사용함 | 개별 구독 월 19,000원(월 50회) · AI 개발·스킬 직무 영역 팀 월 99,000원 · 전체 월 990,000원 중 하나로 계속 씁니다. 카드 결제는 가능입니다. |
| MCP·API에서 401 또는 구독 오류 | 키 범위(mcp, runs:write)와 이 에이전트를 포함하는 구독(개별·직무 영역·전체)이 활성인지 확인합니다. 개별 구독은 기간당 50회입니다. |
| 결과에 "도구 목록과 이름 규칙" 같은 소제목이 빠짐 | "답변 형식 그대로 다시 써 줘" 또는 수정 요청으로 다시 받습니다. |
만들 서버 설명에 다음처럼 적고 실행해 보세요.
사내 재고 관리 DB를 조회하는 MCP 서버를 만들려 합니다. AI가 품목 재고 확인과 입고 예정 조회를 하고, 발주 요청 초안까지 만들 수 있게 하고 싶습니다.
에이전트 가이드는 전문가를 대체하지 않습니다. 남는 판단은 전문가 상담 연결을 요청하세요.
curl -X POST https://recrua.store/api/v1/runs \ -H "Authorization: Bearer $RECRUA_API_KEY" \ -H "Content-Type: application/json" \ --data @recrua-request.json
runs:write 범위 키가 필요합니다. 요청 본문은 recrua-request.json 파일로 내려받아 값을 바꿉니다.
{
"agent_no": 119,
"inputs": {
"situation": "사내 재고 관리 DB를 조회하는 MCP 서버를 만들려 합니다. AI가 품목 재고 확인과 입고 예정 조회를 하고, 발주 요청 초안까지 만들 수 있게 하고 싶습니다.",
"material": "items(sku, name, qty, location), inbound(sku, eta, qty)",
"conditions": "쓰기 작업은 사람 승인 후에만 가능해야 합니다."
}
}agent_no와 입력 키는 이 에이전트의 실제 입력 항목입니다.
이 에이전트는 업무를 돕는 AI 어시스턴트입니다. 결과의 정확성·완결성이나 최종 확정을 보장하지 않으며, 중요한 판단은 관련 전문가의 검토가 필요합니다.
전문가 상담 연결