AI Docs · 도구 226개
AI Documentation
이 문서는 사람과 AI가 함께 읽는 작업 설명서입니다. 사람에게는 가능한 일을 설명하고, AI에게는 어떤 tool name과 permission을 써야 하는지 알려줍니다.
조회 기능
출퇴근, 휴가, 직원, 조직, 급여, 경비, 자원, 채용 등 114개 조회 도구를 제공합니다.
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와 역할 권한이 필요합니다. 쓰기 도구 112개.
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