> 인사책 MCP 문서 — 계약. 서버 주소 https://insacheck.com/api/mcp. 전체판 https://insacheck.com/docs/mcp.md · 색인 https://insacheck.com/docs/mcp/llms.txt

# 계약 (contracts)

근로계약 · 전자계약 보내기와 서명 · 증명서 · 인감.

## 할 수 있는 일

- 도구 16개 · 흐름 0개 (AI 로 끝까지 0개 · 화면 안내 0개)
- 이 영역에 따로 적은 흐름은 없어요. 아래 도구 표와 「이 영역 도구가 나오는 흐름」을 봐요.

## 도구

조회는 `run_read`, 쓰기는 `run_write` 에 도구 이름(`tool`)과 값(`args`)을 넣어 불러요. 「이름 그대로」인 기본 도구는 바로 불러요. 등급은 0 바로 조회 · 1 바로 하고 5분 안에 되돌리기 · 2 미리보기 → 확정 · 3 앱 승인이에요.

| 이름 | 조회/쓰기 | 등급 | 필요 역할 | 범위 | 설명 | 부르는 길 |
|---|---|---|---|---|---|---|
| `create_employment_contract` | 쓰기 | 2 미리보기 → 확정 | hr_manager (관리자 이상) | admin | 근로계약서를 작성하여 직원에게 발송합니다. "이주영 근로계약서 작성해서 보내줘" 같은 명령에 사용. 인사 권한 필요. 직원이 앱에서 전자서명. 임금 조건은 근로조건 카드(급여 설정)에서 정한 값이 자동으로 실린다 — 이 도구는 그 값을 인자로 받지 않는다. | run_write |
| `query_my_contracts` | 조회 | 0 바로 조회 | employee (직원) | view | 본인의 근로계약서 목록을 조회합니다. "내 근로계약서 보여줘", "내 계약 만료일?" 같은 질문에 사용. | run_read |
| `query_contracts` | 조회 | 0 바로 조회 | hr_manager (관리자 이상) | view | 회사 근로계약 목록을 상태별로 조회합니다. "서명 대기중 계약?", "발송한 계약서 현황" 같은 질문에 사용. 인사 권한 필요. | run_read |
| `query_contract_expiry` | 조회 | 0 바로 조회 | dept_manager (팀장 이상) | view | 특정 직원의 근로계약 만료일을 조회합니다. "박민수 계약 언제 끝나?" 같은 질문에 사용. 부서장 이상. | run_read |
| `query_expiring_contracts` | 조회 | 0 바로 조회 | hr_manager (관리자 이상) | view | 곧 만료되는 근로계약 목록. "이번달 만료되는 계약 누구?", "30일 내 갱신 필요한 직원" 같은 질문에 사용. 인사 권한 필요. | run_read |
| `contract_send` | 쓰기 | 2 미리보기 → 확정 | hr_manager (관리자 이상) | admin | 직원 한 명에게 근로계약서를 만들어 보냅니다. "이영희에게 근로계약서 보내줘" 같은 명령에 사용. 먼저 보낼 내용(대상·제목·기간·직책·비어 있는 칸)을 보여 주는 확인이 나오고, 사용자가 승인하면 confirmation_id 를 붙여 다시 부르세요. 같은 이름이 여럿이면 후보를 돌려주니 고른 사람의 id 를 person_id 로 넣어 다시 부르세요. 급여 조건은 직원의 근로조건 카드 값이 자동으로 실려요(인자로 받지 않아요). 서명은 직원이 인사책 앱에서 직접 하며, 이 도구는 서명 그림을 받거나 만들지 않아요. 급여 열람 권한이 있는 인사 담당·대표만 쓸 수 있어요. | run_write |
| `contract_cancel` | 쓰기 | 2 미리보기 → 확정 | hr_manager (관리자 이상) | admin | 아직 체결되지 않은 근로계약서를 취소합니다. "이영희 근로계약서 취소해줘" 같은 명령에 사용. 계약서 번호(contract_id)는 query_contracts 로 찾아요. 먼저 취소할 계약서를 보여 주는 확인이 나오고, 사용자가 승인하면 confirmation_id 를 붙여 다시 부르세요. 서명이 끝난 계약서는 보존되어 취소할 수 없고, 취소하면 직원에게 알림이 가요. 급여 열람 권한이 있는 인사 담당·대표만 쓸 수 있어요. | run_write |
| `contract_company_sign` | 쓰기 | 3 앱 승인 | hr_manager (관리자 이상) | admin | 근로계약서에 회사(대표) 서명을 합니다. 회사 서명은 서명 그림과 서명자 이름이 필요한 법적 효력의 의사표시라, 인사책 앱에서 사람이 직접 해야 해요. 이 도구는 서명 그림이나 서명자 이름을 받지 않고 만들지도 않으며, 앱 승인 화면이 열리기 전에는 실행하지 않아요. 인사 담당·대표만 부를 수 있어요. | run_write |
| `request_certificate` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | send | 재직증명서 등 제증명을 신청합니다. "재직증명서 1부 신청", "경력증명서 발급해줘" 같은 명령에 사용. | run_write |
| `certificate_request` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | send | 재직증명서·경력증명서 등 증명서를 신청합니다. "재직증명서 1부 신청해줘" 같은 말에 사용. 바로 신청되고, 회사 결재선에 따라 결재가 시작돼요. 결재 전이면 5분 안에 undo 로 취소할 수 있어요. 발급되면 certificate_link 로 열어 볼 수 있어요. | run_write |
| `certificate_link` | 조회 | 0 바로 조회 | employee (직원) | view | 내 증명서 신청 한 건의 진행 상태를 보여 주고, 발급됐으면 인사책에 로그인해서 여는 화면 주소를 줍니다. "재직증명서 나왔어?", "증명서 열어줘" 같은 말에 사용. 이 주소는 로그인한 본인만 열 수 있어요(공개 주소 아님). request_id 는 certificate_request 결과나 query_my_certificates 에서 얻어요. | run_read |
| `query_my_certificates` | 조회 | 0 바로 조회 | employee (직원) | view | 본인 제증명 신청 목록. "내 증명서 신청 현황" 같은 질문에 사용. | run_read |
| `query_pending_certificates` | 조회 | 0 바로 조회 | hr_manager (관리자 이상) | view | 발급 대기/승인된 제증명 신청 목록 (인사용). "증명서 발급할 거 뭐 있어?", "대기중인 재직증명서" 같은 질문에 사용. 인사 권한 필요. | run_read |
| `issue_certificate` | 쓰기 | 2 미리보기 → 확정 | hr_manager (관리자 이상) | admin | 최종 승인된 제증명을 발급 완료 처리하고 발급번호(cert_no)를 부여합니다. "재직증명서 3번 발급해줘" 같은 명령에 사용. 인사 권한 필요. | run_write |
| `query_seals` | 조회 | 0 바로 조회 | employee (직원) | view | 회사 등록 인감(도장) 목록. "우리 회사 인감 뭐있어?" 같은 질문에 사용. | run_read |
| `request_seal_use` | 쓰기 | 2 미리보기 → 확정 | employee (직원) | send | 인감 사용을 신청합니다. "법인인감 계약서용으로 신청" 같은 명령에 사용. | run_write |

도구마다 따로 읽는 문서: [create_employment_contract](https://insacheck.com/docs/mcp/tools/create_employment_contract.md) · [query_my_contracts](https://insacheck.com/docs/mcp/tools/query_my_contracts.md) · [query_contracts](https://insacheck.com/docs/mcp/tools/query_contracts.md) · [query_contract_expiry](https://insacheck.com/docs/mcp/tools/query_contract_expiry.md) · [query_expiring_contracts](https://insacheck.com/docs/mcp/tools/query_expiring_contracts.md) · [contract_send](https://insacheck.com/docs/mcp/tools/contract_send.md) · [contract_cancel](https://insacheck.com/docs/mcp/tools/contract_cancel.md) · [contract_company_sign](https://insacheck.com/docs/mcp/tools/contract_company_sign.md) · [request_certificate](https://insacheck.com/docs/mcp/tools/request_certificate.md) · [certificate_request](https://insacheck.com/docs/mcp/tools/certificate_request.md) · [certificate_link](https://insacheck.com/docs/mcp/tools/certificate_link.md) · [query_my_certificates](https://insacheck.com/docs/mcp/tools/query_my_certificates.md) · [query_pending_certificates](https://insacheck.com/docs/mcp/tools/query_pending_certificates.md) · [issue_certificate](https://insacheck.com/docs/mcp/tools/issue_certificate.md) · [query_seals](https://insacheck.com/docs/mcp/tools/query_seals.md) · [request_seal_use](https://insacheck.com/docs/mcp/tools/request_seal_use.md)

## 말 → 호출 순서 (흐름)

이 영역의 이름으로 묶은 흐름은 없어요.

### 이 영역 도구가 나오는 다른 흐름

- ADM-21 곧 끝나는 근로계약을 봐요. → https://insacheck.com/docs/mcp/admin.md
- ADM-22 발급을 기다리는 증명서를 봐요. → https://insacheck.com/docs/mcp/admin.md

## 안 되는 것 · 대안

이 영역에서 화면으로만 되는 일로 적어 둔 흐름은 없어요.
