AI Docs · 도구 220개

인사책 AI 연동 문서

이 문서는 사람과 AI가 함께 읽는 작업 설명서입니다.
사람에게는 가능한 일을 설명하고,
AI에게는 어떤 tool name과 permission을 써야 하는지 알려줍니다.

조회 기능

출퇴근,
휴가,
직원,
조직,
급여,
경비,
자원,
채용 등 112개 조회 도구를 제공합니다.

AI Tool Name 예: query_attendance_today

생성 기능

공지,
휴가신청,
경비청구,
프로젝트,
온보딩,
알림 규칙 등 업무 데이터를 생성할 수 있습니다.

AI Tool Name 예: create_announcement

수정 기능

직원 정보,
프로젝트,
메뉴 표시,
정책성 설정,
상태값을 권한에 따라 수정할 수 있습니다.

AI Tool Name 예: update_worker_position

삭제/비활성 기능

데이터 삭제보다 감사 가능한 비활성화/상태변경 패턴을 우선합니다.
인사 데이터 보존과 추적성을 지킵니다.

AI Tool Name 예: deactivate_alert_rule

승인 기능

휴가,
가입,
결재,
퇴직원 등 승인성 작업은 read_write scope와 역할 권한이 필요합니다.
쓰기 도구 108개.

AI Tool Name 예: approve_leave_request

AI용 작업 설명 형식

모든 도구는 registry에서 이름,
설명,
permission,
input/output schema,
example,
version,
status를 제공합니다.
AI는 이 값을 읽고 사용자에게 필요한 권한과 입력값을 설명해야 합니다.

{
  "name": "query_attendance_today",
  "permission": "insacheck.mcp.dept_manager.read",
  "description": "오늘 우리 회사 직원들의 출퇴근 기록을 조회합니다.",
  "input_schema": {
    "type": "object",
    "properties": {
      "date": {
        "type": "string",
        "description": "YYYY-MM-DD"
      }
    }
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "content": {
        "type": "array"
      },
      "isError": {
        "type": "boolean"
      }
    }
  },
  "example": "오늘 누가 출근했어?"
}

사용 예시

출퇴근 조회

"오늘 누가 출근했어?" → AI는 query_attendance_today를 호출합니다.

Permission: insacheck.mcp.dept_manager.read

휴가 승인

"이주영 연차 승인해줘" → AI는 대기 목록을 확인한 뒤 승인 도구를 호출합니다.

Permission: insacheck.mcp.dept_manager.write

메뉴 설정

"경비 메뉴 꺼줘" → AI는 owner 권한과 read_write scope를 확인한 뒤 토글합니다.

Permission: insacheck.mcp.owner.write

미구현 요청

적절한 도구가 없으면 request_feature로 개발팀에 요청을 기록합니다.

AI Tool Name: request_feature
회사 무료 등록 MCP 문서 보기 Tool Registry