인사책 MCP 연동 문서
AI 클라이언트는 이 문서를 읽고 MCP 서버 URL, OAuth 방식, 권한 범위, 도구 목록과 예제 요청을 이해할 수 있습니다.
AI 가 읽는 마크다운판: /docs/mcp.md · 영역별 색인 /docs/mcp/llms.txt
AI 도구에 연결하기 — 3단계
길게 눌러(또는 선택해) 복사하세요.
Claude (웹·데스크톱)
- 1단계 설정 › 커넥터 › 「사용자 지정 커넥터 추가」를 누르세요.
- 2단계 위 서버 주소를 붙여 넣으세요.
- 3단계 열린 인사책 화면에서 계정을 확인하고 「연결 승인」을 누르세요.
ChatGPT
메뉴 이름은 요금제·버전에 따라 다를 수 있어요.
- 1단계 설정 › 앱과 커넥터(개발자 모드) › 「만들기」를 누르세요.
- 2단계 위 서버 주소를 붙여 넣고 인증은 OAuth를 고르세요.
- 3단계 인사책 화면에서 「연결 승인」을 누르세요.
Claude Code
- 1단계 터미널에
claude mcp add --transport http insacheck https://insacheck.com/api/mcp을 입력하세요. - 2단계 Claude Code 안에서
/mcp를 열어 인사책 「인증」을 누르세요. - 3단계 브라우저에 열린 인사책 화면에서 「연결 승인」을 누르세요.
Cursor
지금은 데스크톱 앱 연결이 거절돼요 — Claude · ChatGPT · Claude Code 로 연결해 주세요.
- 1단계 설정 › MCP › 「새 MCP 서버 추가」를 누르세요.
- 2단계 아래 내용을 붙여 넣고 「로그인」을 누르세요.
{"mcpServers":{"insacheck":{"url":"https://insacheck.com/api/mcp"}}} - 3단계 인사책 화면에서 「연결 승인」을 누르세요.
- 브라우저가 링크를 못 열면,
AI 도구가 보여 준 연결 링크를 복사해 인사책 설정 › 기능 › AI·연결의 『AI 연결 링크 열기』 칸에 붙여 넣으세요. - 다른 계정으로 로그인돼 있으면 승인 화면 맨 위 『다른 계정으로』를 누르세요.
연결한 뒤에는 내 연결 목록·끊기(내 계정) 와 회사 연결된 앱·끊기(회사 관리자) 에서 확인하고 끊을 수 있어요.
바로 설치
터미널에 붙여 넣고,
claude 안에서 /mcp 로 로그인해요.
claude mcp add --transport http insacheck https://insacheck.com/api/mcp
터미널에 붙여 넣으면 처음 부를 때 로그인 창이 떠요.
codex mcp add insacheck --url https://insacheck.com/api/mcp --oauth-resource https://insacheck.com/api/mcp --oauth-client-registration dcr
커넥터 설정에 이 주소를 넣고 인사책으로 로그인해요.
https://insacheck.com/api/mcp
처음 3분
안내문 읽는 차례
- 연결하면 서버가 먼저 안내문을 줘요.
이것부터 읽어요. - 처음에는 guide 를 불러 큰 그림을 봐요.
- 할 일이 생기면 find_tools 로 맞는 도구를 찾아요.
- 보기만 하면 run_read,
바로 되는 내 일은 run_write 로 불러요.
확인이나 앱 승인이 필요한 일은 run_destructive 로 불러요. - 바꾸는 일은 미리보기를 보여 주고,
사람이 좋다고 하면 확정해요.
서버를 부르는 차례
아래 보기는 시험 회사(가짜 값)로 실제 서버에 보내고 받은 그대로예요.
긴 글은 「…」로 잘랐어요.
1.
연결해요
- 주소는 /api/mcp 하나예요.
요청은 모두 POST 로 보내요. - 열쇠 없이 부르면 401 과 로그인 주소가 와요.
- AI 앱이 그 주소로 인사책 로그인 창을 열어요.
- 로그인하고 회사를 고른 뒤 [허락]을 누르면 열쇠가 생겨요.
- 그다음부터 요청 머리에 Authorization: Bearer 열쇠를 붙여요.
열쇠 없이 부르면 — 보낸 것과 받은 것
{
"http": "POST /api/mcp",
"headers": {
"content-type": "application/json"
},
"body": {
"jsonrpc": "2.0",
"id": 0,
"method": "tools/list",
"params": {}
}
}{
"status": 401,
"www-authenticate": "Bearer resource_metadata=\"https://insacheck.com/.well-known/oauth-protected-resource\", scope=\"view mine send admin\", error=\"invalid_token\", …",
"body": {
"jsonrpc": "2.0",
"id": 0,
"error": {
"code": -32001,
"message": "인사책 로그인이 필요해요. 브라우저에서 https://insacheck.com/oauth/authorize 로 로그인·승인하세요. (Unauthorized: OAuth access token or PAT required.)",
"data": {
"error": "unauthorized"
}
}
}
}2.
인사해요 (initialize)
- 처음 한 번 initialize 를 불러요.
- 답의 instructions 가 서버 안내문이에요.
꼭 읽어요.
initialize — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "내 AI",
"version": "1.0"
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-11-25",
"capabilities": {
"tools": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
},
"serverInfo": {
"name": "insacheck-mcp",
"version": "0.2.0"
},
"instructions": "인사책(insacheck) HR 플랫폼 MCP 서버입니다. 한국 중소기업의 출퇴근·휴가·결재·업무·메일 등을 자연어로 처리합니다. 이 문서는 계속 갱신됩니다 — 도구 답 끝에 「가이드가 바뀌었어요」 한 줄이 붙으면 guide 도구로 바뀐 것(chang…"
}
}3.
도구 목록을 받아요 (tools/list)
- 기본 도구 16개가 와요.
나머지는 찾아서 써요. - 도구마다 받는 값(inputSchema)이 같이 와요.
tools/list — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}{
"jsonrpc": "2.0",
"id": 2,
"result": {
"tools": [
{
"name": "whoami",
"description": "나·회사·역할·허락 범위·쓸 수 있는 기능.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "내 정보",
"readOnlyHint": true
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"view"
]
}
]
},
{
"name": "today"
},
"…(모두 16개)"
],
"meta": {
"oauth_scope": "read_write",
"user_role": "employee",
"enterprise_id": 9001,
"available_tool_count": 16,
"filtered_tool_count": 0,
"filtered_reasons": {},
"filtered_tools_sample": [],
"more_tools_via": "find_tools"
}
}
}4.
할 일에 맞는 도구를 찾아요 (find_tools)
- 사람 말을 그대로 query 에 넣어요.
- 도구 이름 · 보기인지 쓰기인지(kind) · 등급(grade) · 부를 입구(run_with)가 와요.
find_tools — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "find_tools",
"arguments": {
"query": "휴가 신청"
}
}
}{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [
{
"type": "text",
"text": "- request_leave [쓰기 · run_destructive · 남에게 알림 · 확인 필요] 본인의 휴가를 신청합니다. \"내일 연차 신청해줘\", \"다음주 월요일 반차\" 같은 명령에 사용하세요.\n 인자(*=필수): start_date*(stri…"
},
{
"type": "text",
"text": "가이드가 바뀌었어요(2026-10-28.1) — 바뀐 것: guide('changes')"
}
],
"structuredContent": {
"tools": [
{
"name": "request_leave",
"kind": "write",
"grade": 2,
"run_with": "run_destructive",
"description": "본인의 휴가를 신청합니다. \"내일 연차 신청해줘\", \"다음주 월요일 반차\" 같은 명령에 사용하세요.",
"input_schema": {
"properties": {
"start_date": {
"type": "string",
"description": "시작일 YYYY-MM-DD"
},
"end_date": {
"type": "string",
"description": "종료일 YYYY-MM-DD (생략하면 start_date 와 동일)"
},
"leave_type": {
"type": "string",
"enum": [
"annual",
"half_morning",
"…(모두 12개)"
],
"description": "휴가 종류 (annual=연차, half_morning=오전반차, half_afternoon=오후반차, q…"
},
"start_time": {
"type": "string",
"description": "반반차·시간 단위 연차 시작 시각 HH:MM"
},
"hours": {
"type": "number",
"description": "시간 단위 연차 시간(1~8시간)"
},
"reason": {
"type": "string",
"description": "사유 (선택)"
}
},
"required": [
"start_date"
]
}
},
{
"name": "cancel_leave_request",
"kind": "write",
"grade": 2,
"run_with": "run_destructive",
"description": "본인이 신청한 대기중(pending) 휴가를 취소합니다. \"어제 신청한 휴가 취소해줘\" 같은 명령에 사용.",
"input_schema": {
"properties": {
"leave_id": {
"type": "number",
"description": "휴가 신청 ID (query_my_leaves 로 먼저 조회)"
}
},
"required": [
"leave_id"
]
}
},
"…(모두 5개)"
],
"items": 5,
"has_more": true,
"next_cursor": "5"
},
"isError": false
}
}5.
불러요 (run_read · run_destructive)
- run_read 는 바로 답이 와요.
- run_destructive 는 먼저 미리보기와 confirmation_id 가 와요.
- 미리보기를 사람에게 보여 줘요.
좋다고 하면 다음으로 가요. - 같은 인자에 confirmation_id 를 붙여 다시 부르면 확정돼요.
run_read — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "run_read",
"arguments": {
"tool": "query_my_leave_balance",
"args": {}
}
}
}{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [
{
"type": "text",
"text": "{\"year\":2026,\"granted\":15,\"carry_over\":0,\"used\":0,\"pending\":1,\"remaining\":15,\"message\":\"2026년 잔여 연차 15일 (부여 15 + 이월 0 − 사용 0). 대기 1일은 아직 차감되…"
}
],
"isError": false,
"structuredContent": {
"year": 2026,
"granted": 15,
"carry_over": 0,
"used": 0,
"pending": 1,
"remaining": 15,
"message": "2026년 잔여 연차 15일 (부여 15 + 이월 0 − 사용 0). 대기 1일은 아직 차감되지 않았습니다."
}
}
}run_destructive — 미리보기 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "run_destructive",
"arguments": {
"tool": "clock_in",
"args": {}
}
}
}{
"jsonrpc": "2.0",
"id": 5,
"result": {
"content": [
{
"type": "text",
"text": "{\"requires_confirmation\":true,\"confirmation_id\":\"<미리보기 답의 confirmation_id>\",\"confirmation_message\":\"지금 시각으로 내 출근을 기록할까요?\",\"permission\":\"atte…"
}
],
"isError": false,
"structuredContent": {
"requires_confirmation": true,
"confirmation_id": "<미리보기 답의 confirmation_id>",
"confirmation_message": "지금 시각으로 내 출근을 기록할까요?",
"permission": "attendance.write",
"action_preview": {
"tool_name": "clock_in",
"arguments": {}
},
"next_step": "사용자가 명시적으로 승인하면 같은 tool arguments에 confirmation_id를 포함해 다시 호출하세요."
}
}
}run_destructive — 확정 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "run_destructive",
"arguments": {
"tool": "clock_in",
"args": {},
"confirmation_id": "<미리보기 답의 confirmation_id>"
}
}
}{
"jsonrpc": "2.0",
"id": 6,
"result": {
"content": [
{
"type": "text",
"text": "{\"ok\":true,\"type\":\"checkin\",\"type_label\":\"출근\",\"timestamp\":\"2026-10-28T01:57:35Z\",\"message\":\"출근 처리 완료 (2026. 10. 28. AM 10:57:35).\"}"
}
],
"isError": false,
"structuredContent": {
"ok": true,
"type": "checkin",
"type_label": "출근",
"timestamp": "2026-10-28T01:57:35Z",
"message": "출근 처리 완료 (2026. 10. 28. AM 10:57:35).",
"action_result": {
"job_id": "fb5b0741aee6e854-yYGOZwhKq7jT6gRd9qEEMYWW",
"target": "clock_in",
"status": "done",
"status_label": "처리 완료",
"changes": [],
"error_code": null,
"checked_at": "2026-10-28 01:57:35",
"link": null
}
}
}
}6.
되물으면 골라서 다시 불러요 (needs_choice)
- 같은 이름이 둘이면 서버가 대신 고르지 않아요.
- needs_choice 에 후보와 물을 말이 와요.
- 사람에게 물어 고른 id 를 field 칸에 넣어 다시 불러요.
되묻기가 온 답 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "task_create",
"arguments": {
"title": "주간 보고서 정리",
"to": [
"박가상"
],
"due": "2026-10-31"
}
}
}{
"jsonrpc": "2.0",
"id": 7,
"result": {
"content": [
{
"type": "text",
"text": "'박가상' 님이 여러 명이에요. 누구인지 골라 주세요. 고른 사람의 id 를 to 에 넣어 다시 불러 주세요.\n1. 박가상 과장(영업부)\n2. 박가상 사원(영업2팀)"
}
],
"structuredContent": {
"needs_choice": {
"field": "to",
"question": "'박가상' 님이 여러 명이에요. 누구인지 골라 주세요. 고른 사람의 id 를 to 에 넣어 다시 불러 주세요.",
"candidates": [
{
"id": 9613,
"name": "박가상",
"dept": "영업부",
"title": "과장"
},
{
"id": 9617,
"name": "박가상",
"dept": "영업2팀",
"title": "사원"
}
]
}
},
"isError": false
}
}고른 id 로 다시 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 8,
"method": "tools/call",
"params": {
"name": "task_create",
"arguments": {
"title": "주간 보고서 정리",
"to": [
9613
],
"due": "2026-10-31"
}
}
}{
"jsonrpc": "2.0",
"id": 8,
"result": {
"content": [
{
"type": "text",
"text": "{\"requires_confirmation\":true,\"confirmation_id\":\"<미리보기 답의 confirmation_id>\",\"confirmation_message\":\"업무 요청: 주간 보고서 정리 · 받는 사람: 박가상 · 참조: 없음 ·…"
}
],
"structuredContent": {
"requires_confirmation": true,
"confirmation_id": "<미리보기 답의 confirmation_id>",
"confirmation_message": "업무 요청: 주간 보고서 정리 · 받는 사람: 박가상 · 참조: 없음 · 기한 10/31(토) 18:00 · 기한을 10/31(토) 18:00으로 정했어요 (시각을 안 정하셔서)",
"permission": "task.write",
"action_preview": {
"action": "task_create",
"title": "주간 보고서 정리",
"to": [
{
"id": 9613,
"name": "박가상"
}
],
"cc": [],
"due": "10/31(토) 18:00",
"due_time_defaulted": true,
"due_time_basis": "default"
}
},
"isError": false
}
}7.
5분 안에 되돌려요 (undo_id)
- 1등급 일은 확인 없이 바로 되고,
답에 undo_id 가 와요. - 5분 안에 run_write 로 undo 를 부르면 되돌려져요.
1등급 일 — undo_id 가 온 답 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 9,
"method": "tools/call",
"params": {
"name": "run_write",
"arguments": {
"tool": "journal_write",
"args": {
"body": "보고서 초안 정리"
}
}
}
}{
"jsonrpc": "2.0",
"id": 9,
"result": {
"content": [
{
"type": "text",
"text": "10/28(수) 업무일지를 저장했어요.\n되돌리기: undo_id 41dd6e92-f7d6-4173-9124-486a60dbaadd (5분 안)"
}
],
"structuredContent": {
"id": 1,
"date": "2026-10-28",
"cc": [],
"undo": {
"undo_id": "41dd6e92-f7d6-4173-9124-486a60dbaadd",
"expires_in_sec": 300
},
"action_result": {
"job_id": "41dd6e92-f7d6-4173-9124-486a60dbaadd",
"target": "journal_write",
"status": "done",
"status_label": "처리 완료",
"changes": [],
"error_code": null,
"checked_at": "2026-10-28 01:57:35",
"link": null
}
},
"isError": false
}
}undo 로 되돌리기 — 보낸 것과 받은 것
{
"jsonrpc": "2.0",
"id": 10,
"method": "tools/call",
"params": {
"name": "run_write",
"arguments": {
"tool": "undo",
"args": {
"undo_id": "41dd6e92-f7d6-4173-9124-486a60dbaadd"
}
}
}
}{
"jsonrpc": "2.0",
"id": 10,
"result": {
"content": [
{
"type": "text",
"text": "{\"ok\":true,\"undone\":\"journal_write\",\"message\":\"방금 한 \\\"journal_write\\\" 을(를) 되돌렸어요.\"}"
}
],
"isError": false
}
}자주 막히는 곳
| 권한 없음 | role_denied · scope_denied | 내 역할이나 허락한 범위로는 못 하는 일이에요. 고치기 답의 who_can 을 보고 할 수 있는 사람에게 부탁해요. |
| 회사 고르기 | 로그인 화면 | 연결 하나는 회사 하나만 다뤄요. 고치기 다른 회사 일은 그 회사를 골라 다시 연결해요. |
| 확인 안 함 | requires_confirmation | 바꾸는 일이 미리보기에서 멈춘 상태예요. 고치기 사람에게 묻고, 같은 인자에 confirmation_id 를 붙여요. |
| 시간 지남 | confirmation_id 10분 · app_approval_expired | 확인 번호나 앱 승인 요청의 시간이 끝났어요. 고치기 번호 없이 처음부터 다시 불러 새 번호를 받아요. |
| 기능 꺼짐 | feature_off · company_locked | 회사가 그 기능이나 AI 연결을 꺼 두었어요. 고치기 회사 관리자에게 켜 달라고 해요. 웹·앱은 그대로 돼요. |
서버 연결 정보
MCP Server URL
MCP JSON-RPC 2.0 over HTTP endpoint입니다.
기존 /mcp 경로도 호환됩니다.
OAuth 방식
OAuth 2.1 authorization_code + PKCE S256 + Dynamic Client Registration + refresh/revoke/introspect를 지원합니다.
Protocol Version
MCP protocol 2025-06-18, server 0.2.0.
Tool Registry
전체 도구의 schema, permission, example을 공개합니다.
인증 전 공개 카탈로그(/mcp/tools.json)는 그중 조회 도구만 싣습니다.
기존 고객 연결
OAuth 커넥터 (권장)
Claude·ChatGPT에 https://insacheck.com/api/mcp를 추가한 뒤 인사책 계정으로 로그인·승인합니다.
별도 PAT 발급이 필요하지 않습니다.
PAT 지원 클라이언트
토큰 입력을 지원하는 CLI·개발 도구에서만 /worker/mcp의 PAT를 Bearer 인증으로 사용합니다.
OAuth Discovery
{
"issuer": "https://insacheck.com",
"mcp_server_url": "https://insacheck.com/api/mcp",
"authorization_endpoint": "https://insacheck.com/oauth/authorize",
"token_endpoint": "https://insacheck.com/oauth/token",
"registration_endpoint": "https://insacheck.com/oauth/register",
"revocation_endpoint": "https://insacheck.com/oauth/revoke",
"introspection_endpoint": "https://insacheck.com/oauth/introspect",
"scopes_supported": [
"read",
"read_write"
],
"scope_rule": "read_write includes read. Request scope=read_write alone for full access. scope=read read_write is accepted and normalized to read_write for compatibility.",
"code_challenge_methods_supported": [
"S256"
]
}
권한 범위
OAuth scope: read
조회 전용 token입니다.
write 도구는 tools/list에서 제외됩니다.
OAuth scope: read_write
조회 + 변경 token입니다.
read를 포함하는 상위 권한입니다.
실제 사용자 권한
read_write token이어도 employee/dept_manager/hr_manager/owner 역할과 회사 내 권한 안에서만 실행됩니다.
| 역할 | role | 전체(조회+변경) |
|---|---|---|
| 직원 | employee | 59개 |
| 부서장 | dept_manager | 37개 |
| 인사팀장 | hr_manager | 75개 |
| 대표 | owner | 14개 |
쓰기 도구는 OAuth scope read_write가 필요합니다.
조회 도구는 read로 사용할 수 있습니다.
표준 호환을 위해 scope=read read_write 요청은 read_write로 정규화하지만, 클라이언트는 전체 권한 요청 시 scope=read_write만 보내는 것을 권장합니다.
안전 경계
되돌리기 어려운 작업은 scope 와 역할만으로 실행하지 않습니다.
아래 permission 에 속한 도구는 이 문서 끝의 Tool 목록에서 「확인」 표시가 붙어 있고, 첫 호출이 실행 대신 확인 요청을 돌려줍니다.
AI 클라이언트는 이 응답을 사람에게 보여 주고, 사람이 승인하면 같은 arguments 에 confirmation_id 를 넣어 다시 호출합니다.
확인 코드는 한 번 쓰면 소모되고 유효 시간이 지나면 만료되며, arguments 가 한 글자라도 달라지면 그 코드로는 실행되지 않습니다.
만료·재사용은 -32004 로 거절합니다.
action_preview 의 인자 중 확인 코드·초대 코드·API 키·Authorization·쿠키·비밀번호 형태는 가려서 보여 줍니다.
{
"requires_confirmation": true,
"confirmation_id": "<서버가 발급한 1회용 코드>",
"confirmation_message": "<사람에게 보여 줄 확인 문장>",
"permission": "leave.request",
"action_preview": {
"tool_name": "cancel_leave_request",
"arguments": {
"leave_id": 1234
}
},
"next_step": "사용자가 명시적으로 승인하면 같은 tool arguments에 confirmation_id를 포함해 다시 호출하세요."
}
예제 요청
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "query_attendance_today",
"arguments": {
"date": "2026-06-13"
}
}
}
예제 응답
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{ \"date\": \"2026-06-13\", \"employees\": [] }"
}
],
"isError": false
}
}
많이 쓰는 일 300가지 — 말 → 호출 순서
사람이 이렇게 말하면,
AI 는 이 순서로 서버를 불러요.
300개 중 231개는 AI 로 끝까지 되고,
69개는 화면으로 안내해요.
출퇴근
ATT-01 · 지금 출근을 찍어요. AI 로 끝까지 돼요
/worker| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"clock_in","args":{"note":"외근"}}} |
몸통 src/routes/mcp-tool-handlers.ts:_clockToggle · 함수 src/lib/attendance-submission.ts:submitAttendance · 웹 API POST /api/attendance {type, note} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"clock_in","args":{"note":"외근"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:_clockToggle · 함수 src/lib/attendance-submission.ts:submitAttendance · 웹 API POST /api/attendance {type, note} |
출근 시각 |
ATT-02 · 지금 퇴근을 찍어요. AI 로 끝까지 돼요
/worker| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"clock_out","args":{}}} |
몸통 src/routes/mcp-tool-handlers.ts:_clockToggle · 함수 src/lib/attendance-submission.ts:submitAttendance · 웹 API POST /api/attendance {type, note} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"clock_out","args":{},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:_clockToggle · 함수 src/lib/attendance-submission.ts:submitAttendance · 웹 API POST /api/attendance {type, note} |
퇴근 시각 |
ATT-03 · 내 출퇴근 기록을 봐요. AI 로 끝까지 돼요
/worker/history| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_attendance","args":{"days":14}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_my_attendance | — |
ATT-04 · 잘못 찍힌 출퇴근 시각을 고쳐 달라고 올려요. AI 로 끝까지 돼요
/worker/attendance-correction| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"attendance_fix"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 |
| 2-미리보기 | 먼저 묻기: 「며칠 몇 시로 고칠까요?」 {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"20:30","reason":"야근 뒤 퇴근 시각이 잘못 찍힘"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/lib/attendance-correction-submit-core.ts:attendanceCorrectionSubmitCore · 웹 API POST /api/workers/me/attendance-corrections {date, checkin_time, checkout_time, reason} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재를 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"20:30","reason":"야근 뒤 퇴근 시각이 잘못 찍힘","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/lib/attendance-correction-submit-core.ts:attendanceCorrectionSubmitCore · 웹 API POST /api/workers/me/attendance-corrections {date, checkin_time, checkout_time, reason} |
결재 id |
ATT-05 · 출퇴근을 어떻게 하는지 안내를 받아요. AI 로 끝까지 돼요
/worker/dashboard| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"guide","arguments":{"topic":"attendance"}} |
몸통 src/routes/mcp-tools/base-guide.ts:guide | 안내 내용 |
ATT-06 · 직원의 출퇴근 기록을 관리자가 대신 고쳐요. 아직 AI 로 안 돼요 · 대신 화면
/worker/attendance-correction호출 없음 — 화면에서 해요.
ATT-07 · 한 달 출퇴근 기록을 표로 내려받아요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"export_attendance_csv","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/export.ts:export_attendance_csv | 표 내용 |
ATT-08 · 출퇴근을 찍는 방법을 켜고 꺼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/attendance-methods호출 없음 — 화면에서 해요.
ATT-09 · 출퇴근 GPS 강도와 사무실 반경을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「GPS 강도와 반경을 어떻게 할까요?」 {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"gps_mode":"soft","office_radius_m":150}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"gps_mode":"soft","office_radius_m":150},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | 바뀐 값 |
ATT-10 · 우리 팀 오늘 출근 기록을 봐요. AI 로 끝까지 돼요
/worker/team| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_attendance","args":{"date":"2026-10-21","limit":10}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_team_attendance | — |
ATT-11 · 점심 외출과 복귀 시각을 기록해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/dashboard호출 없음 — 화면에서 해요.
ATT-12 · 사무실 위치와 출근 인정 거리를 등록해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/hr/office-location호출 없음 — 화면에서 해요.
ATT-13 · 올린 출퇴근 정정이 어디까지 갔는지 봐요. AI 로 끝까지 돼요
/worker/requests| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList | 결재 번호 · 결재 종류 |
| 2 | {"name":"run_read","arguments":{"tool":"approval_get","args":{}}}1.items.0.id → id · 1.items.0.type → type |
몸통 src/routes/mcp-tools/approval-read.ts:approvalGet | 결재 상태 · 결재자 이름 |
ATT-14 · 올린 출퇴근 정정을 거둬요. AI 로 끝까지 돼요
/worker/requests| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList | 결재 번호 · 결재 종류 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"approval_cancel","args":{}}}1.items.0.id → id · 1.items.0.type → type |
몸통 src/routes/mcp-tools/approval-read.ts:approvalCancel · 웹 API POST /api/workers/me/attendance-corrections/:id/cancel | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"approval_cancel","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 1.items.0.type → type · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-read.ts:approvalCancel · 웹 API POST /api/workers/me/attendance-corrections/:id/cancel | — |
ATT-15 · 이번 주 52시간이 넘을 사람을 점검해요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"check_52h_compliance","args":{"warn_hours":48}}} |
몸통 src/routes/mcp-tools/worktime.ts:check_52h_compliance | — |
ATT-16 · 이번 달 내 근무시간 합계를 봐요. AI 로 끝까지 돼요
/worker/history| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_work_hours","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/worktime.ts:query_my_work_hours | — |
ATT-17 · 지금 회사에 있는 사람을 봐요. AI 로 끝까지 돼요
/worker/team| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_who_is_in","args":{}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_who_is_in | — |
ATT-18 · 그날 사람별 첫 출근과 마지막 퇴근을 봐요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_today","args":{"date":"2026-10-20"}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_attendance_today | — |
ATT-19 · 우리 팀 이번 달 근무시간을 정리해요. AI 로 끝까지 돼요
/worker/team/monthly-hours| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_work_hours","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/worktime.ts:query_team_work_hours | — |
ATT-20 · 팀원의 근무일에 근무조를 정해요. AI 로 끝까지 돼요
/worker/team/operations| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_templates","args":{}}} |
몸통 src/routes/mcp-tools/shift.ts:query_shift_templates | 근무조 이름 |
| 2-미리보기 | 먼저 묻기: 「어느 근무조로 할까요?」 {"name":"run_destructive","arguments":{"tool":"assign_shift","args":{"worker":"이가상","work_date":"2026-10-22"}}}1.templates.0.template_id → shift_template_id |
몸통 src/routes/mcp-tools/shift.ts:assign_shift · 웹 API POST /api/admin/shift-assignments | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이면 누구예요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"assign_shift","args":{"worker":"이가상","work_date":"2026-10-22"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.templates.0.template_id → shift_template_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift.ts:assign_shift · 웹 API POST /api/admin/shift-assignments | 정해진 근무 |
ATT-21 · 여러 사람의 교대표를 패턴으로 한 번에 만들어요. AI 로 끝까지 돼요
/worker/team/operations| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_templates","args":{}}} |
몸통 src/routes/mcp-tools/shift.ts:query_shift_templates | 근무조 이름 |
| 2-미리보기 | 먼저 묻기: 「누구를 어떤 순서로 돌릴까요?」 {"name":"run_destructive","arguments":{"tool":"generate_rotation","args":{"workers":["이가상","박가상"],"pattern":["주간","야간","휴무"],"from_date":"2026-11-01","days":30}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:generate_rotation | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"generate_rotation","args":{"workers":["이가상","박가상"],"pattern":["주간","야간","휴무"],"from_date":"2026-11-01","days":30},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift-ops.ts:generate_rotation | 만든 일수 |
ATT-22 · 오늘 늦게 온 사람을 봐요. 아직 AI 로 안 돼요 · 대신 화면
/worker/team호출 없음 — 화면에서 해요.
ATT-23 · 오늘 출근 안 한 사람과 이상 징후를 봐요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_anomaly","args":{}}} |
몸통 src/routes/mcp-tools/insights.ts:query_attendance_anomaly | — |
ATT-24 · 한 직원의 이번 달 근무시간을 봐요. AI 로 끝까지 돼요
/worker/team/monthly-hours| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구의 근무시간을 볼까요?」 {"name":"run_read","arguments":{"tool":"query_employee_work_hours","args":{"worker":"김가상","month":"2026-10"}}} |
몸통 src/routes/mcp-tools/worktime.ts:query_employee_work_hours | — |
ATT-25 · 우리 팀 야근이 많은 사람 순위를 봐요. AI 로 끝까지 돼요
/worker/team/monthly-hours| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_overtime","args":{"start_date":"2026-10-19","end_date":"2026-10-25","top_n":5}}} |
몸통 src/routes/mcp-tools/worktime.ts:query_team_overtime | — |
ATT-26 · 우리 팀 외근 나간 사람과 신청 대기를 봐요. AI 로 끝까지 돼요
/worker/team| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_remote_work","args":{"date":"2026-10-21"}}} |
몸통 src/routes/mcp-tools/remote.ts:query_remote_work | — |
ATT-27 · 올라온 외근 신청을 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests호출 없음 — 화면에서 해요.
ATT-28 · 올라온 연장근무 신청을 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests호출 없음 — 화면에서 해요.
ATT-29 · 외근을 나간다고 신청해요. AI 로 끝까지 돼요
/worker/remote| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「며칠부터 외근인가요?」 {"name":"run_destructive","arguments":{"tool":"request_remote_work","args":{"work_mode":"field","start_date":"2026-10-22","end_date":"2026-10-23","reason":"고객사 방문","location":"고객사"}}} |
몸통 src/routes/mcp-tools/remote.ts:request_remote_work · 웹 API POST /api/worker/remote-work | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"request_remote_work","args":{"work_mode":"field","start_date":"2026-10-22","end_date":"2026-10-23","reason":"고객사 방문","location":"고객사"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/remote.ts:request_remote_work · 웹 API POST /api/worker/remote-work | 신청 번호 |
ATT-30 · 연장근무를 미리 신청해요. AI 로 끝까지 돼요
/worker/overtime| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「몇 시부터 몇 시까지 하나요?」 {"name":"run_destructive","arguments":{"tool":"submit_overtime_request","args":{"request_date":"2026-10-21","start_time":"18:30","end_time":"21:00","reason":"월말 정산 마감 작업"}}} |
몸통 src/routes/mcp-tools/worktime.ts:submit_overtime_request · 함수 src/lib/approval-request-create.ts:createApprovalRequestWithAtomicRoute · 웹 API POST /api/worker/overtime | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"submit_overtime_request","args":{"request_date":"2026-10-21","start_time":"18:30","end_time":"21:00","reason":"월말 정산 마감 작업"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/worktime.ts:submit_overtime_request · 함수 src/lib/approval-request-create.ts:createApprovalRequestWithAtomicRoute · 웹 API POST /api/worker/overtime | 신청 번호 |
ATT-31 · 이번 달 내 연장근무 시간을 봐요. AI 로 끝까지 돼요
/worker/history| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_overtime","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/worktime.ts:query_my_overtime | — |
ATT-32 · 오늘 부서별 출근율을 봐요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_rate_today","args":{}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_attendance_rate_today | — |
ATT-33 · 내가 올린 외근 신청 상태를 봐요. AI 로 끝까지 돼요
/worker/remote| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_remote_work","args":{}}} |
몸통 src/routes/mcp-tools/remote.ts:query_my_remote_work | — |
ATT-34 · 내가 올린 출장 신청 상태를 봐요. AI 로 끝까지 돼요
/worker/business-trip| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_trips","args":{}}} |
몸통 src/routes/mcp-tools/ops.ts:query_my_trips | — |
ATT-35 · 출장을 가겠다고 신청해요. AI 로 끝까지 돼요
/worker/business-trip| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「어디로 며칠 가나요?」 {"name":"run_destructive","arguments":{"tool":"submit_business_trip","args":{"trip_type":"domestic_overnight","destination":"부산 고객사","purpose":"제품 시연","start_date":"2026-10-27","end_date":"2026-10-28"}}} |
몸통 src/routes/mcp-tools/ops.ts:submit_business_trip · 함수 src/lib/approval-request-create.ts:createApprovalRequestWithAtomicRoute · 웹 API POST /api/worker/business-trip | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"submit_business_trip","args":{"trip_type":"domestic_overnight","destination":"부산 고객사","purpose":"제품 시연","start_date":"2026-10-27","end_date":"2026-10-28"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/ops.ts:submit_business_trip · 함수 src/lib/approval-request-create.ts:createApprovalRequestWithAtomicRoute · 웹 API POST /api/worker/business-trip | 신청 번호 |
휴가
LV-01 · 올라온 휴가 신청을 승인하거나 반려하고 싶어요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests?view=history&tab=need| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_pending_leaves","args":{"limit":10}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_team_pending_leaves | 신청자 · 날짜 · 종류 · 신청 번호 |
LV-02 · 내 연차가 왜 이 숫자인지 알고 싶어요. 아직 AI 로 안 돼요 · 대신 화면
/worker/leave/table| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leave_balance","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leave_balance · 함수 src/lib/leave-balance.ts:remainingAnnualLeaveDays · 웹 API GET /api/leave/balance/me | 부여 일수 · 이월 일수 · 사용 일수 · 대기 일수 |
LV-03 · 결재함에 휴가 신청이 안 보여요. AI 로 끝까지 돼요
/worker/requests?view=history&tab=need| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_approval_inbox","args":{}}} |
몸통 src/routes/mcp-tools/approvals.ts:query_my_approval_inbox | 결재 종류 · 신청자 · 신청 번호 |
LV-04 · 남은 연차를 봐요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leave_balance","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leave_balance · 함수 src/lib/leave-balance.ts:remainingAnnualLeaveDays · 웹 API GET /api/leave/balance/me | 남은 일수 · 부여 일수 · 사용 일수 · 대기 일수 |
LV-05 · 연차를 하루나 여러 날 신청해요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 · 참조인 이름 |
| 2-미리보기 | 먼저 묻기: 「언제부터 언제까지 쉴까요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-26","end_date":"2026-10-27","leave_type":"annual","reason":"개인 사정"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-26","end_date":"2026-10-27","leave_type":"annual","reason":"개인 사정","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
휴가 신청 번호 · 결재자 이름 |
LV-06 · 올린 휴가가 아직 결재 전이면 취소해요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"status":"pending","year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves · 웹 API GET /api/leave/requests/me | 신청 번호 · 날짜 · 종류 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"cancel_leave_request","args":{}}}1.leaves.0.leave_id → leave_id |
몸통 src/routes/mcp-tools/leave.ts:cancelMcpLeaveAtomically · 웹 API PATCH /api/leave/requests/:id/cancel | confirmation_id 후보가 여럿이면(needs_choice) 「어느 휴가 신청을 취소할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"cancel_leave_request","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.leaves.0.leave_id → leave_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/leave.ts:cancelMcpLeaveAtomically · 웹 API PATCH /api/leave/requests/:id/cancel | 취소된 날짜 |
LV-07 · 반차·병가·무급 같은 휴가를 쓸 수 있게 켜고 꺼요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leave_policy","args":{}}} |
몸통 src/routes/mcp-tools/policies.ts:query_leave_policy · 함수 src/lib/leave-policy.ts:resolveLeavePolicy · 웹 API GET /api/leave/policies/:eid | 지금 허용 상태 |
| 2-미리보기 | 먼저 묻기: 「어떤 휴가를 켜고 어떤 휴가를 끌까요?」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"half_day_supported":true,"allow_unpaid":true}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy · 웹 API PATCH /api/leave/policies/:eid {half_day_supported, quarter_day_supported, allow_unpaid, allow_sick_leave, allow_family_event} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"half_day_supported":true,"allow_unpaid":true},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy · 웹 API PATCH /api/leave/policies/:eid {half_day_supported, quarter_day_supported, allow_unpaid, allow_sick_leave, allow_family_event} |
바뀐 항목 |
LV-08 · 직원이 취소해 달라고 한 승인된 휴가를 처리해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/leave호출 없음 — 화면에서 해요.
LV-09 · 내 휴가를 누가 결재하는지 먼저 봐요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 · 참조인 이름 |
LV-10 · 연차 기준과 남은 연차 처리 방식을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leave_policy","args":{}}} |
몸통 src/routes/mcp-tools/policies.ts:query_leave_policy · 함수 src/lib/leave-policy.ts:resolveLeavePolicy · 웹 API GET /api/leave/policies/:eid | 지금 부여 기준 · 지금 이월 방식 |
| 2-미리보기 | 먼저 묻기: 「무엇을 어떻게 바꿀까요?」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"accrual_basis":"hire_date","carryover_method":"next_year","base_annual_days":15}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy · 웹 API PATCH /api/leave/policies/:eid {accrual_basis, carryover_method, base_annual_days} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"accrual_basis":"hire_date","carryover_method":"next_year","base_annual_days":15},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy · 웹 API PATCH /api/leave/policies/:eid {accrual_basis, carryover_method, base_annual_days} |
바뀐 항목 |
LV-11 · 반차(오전·오후)를 신청해요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 |
| 2-미리보기 | 먼저 묻기: 「오전 반차인가요, 오후 반차인가요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-23","leave_type":"half_morning","reason":"병원 방문"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, leave_type, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-23","leave_type":"half_morning","reason":"병원 방문","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, leave_type, reason} |
휴가 신청 번호 · 결재자 이름 |
LV-12 · 이미 승인된 내 휴가를 취소하고 싶어요. 아직 AI 로 안 돼요 · 대신 화면
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"status":"approved","year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves · 웹 API GET /api/leave/requests/me | 신청 번호 · 날짜 · 종류 |
LV-13 · 휴가를 결재하는 사람을 더하거나 빼요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_approval_lines","args":{}}} |
몸통 src/routes/mcp-tools/approvals.ts:query_approval_lines | 지금 결재 순서 |
| 2 | 먼저 묻기: 「누구를 휴가 결재자로 더할까요?」 {"name":"run_destructive","arguments":{"tool":"set_approval_line","args":{"action":"add","item_type":"leave","worker":"박가상"}}} |
몸통 src/routes/mcp-tools/approval-roster-tool.ts:set_approval_line · 함수 src/lib/approval-authority-write.ts:addApprovalAuthority | 바뀐 결재자 명단 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구일까요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
LV-14 · 내가 올린 휴가 신청의 상태를 봐요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"status":"all","year":2026,"limit":10}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves · 웹 API GET /api/leave/requests/me | 신청 번호 · 날짜 · 종류 · 상태 · 반려 사유 |
LV-15 · 반반차나 시간 단위로 쉬는 휴가를 신청해요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「몇 시부터 쉬시나요?」 {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-10-28","leave_type":"quarter","start_time":"14:00","reason":"개인 용무"}}} |
몸통 src/routes/mcp-tool-handlers.ts:request_leave · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, leave_type, start_time, hours, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-10-28","leave_type":"quarter","start_time":"14:00","reason":"개인 용무"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:request_leave · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, leave_type, start_time, hours, reason} |
휴가 신청 번호 · 쉬는 일수 · 결재자 이름 |
LV-16 · 남은 연차를 쓰도록 직원에게 알려요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/leave-encouragement호출 없음 — 화면에서 해요.
LV-17 · 직원 연차를 더하거나 빼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/hr/leave-ledger호출 없음 — 화면에서 해요.
LV-18 · 우리 팀에서 승인 기다리는 휴가를 봐요. AI 로 끝까지 돼요
/worker/requests?view=history&tab=need| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_pending_leaves","args":{"limit":10}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_team_pending_leaves | 신청자 · 날짜 · 종류 · 신청 번호 |
LV-19 · 우리 회사 휴가 규칙을 봐요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leave_policy","args":{}}} |
몸통 src/routes/mcp-tools/policies.ts:query_leave_policy · 함수 src/lib/leave-policy.ts:resolveLeavePolicy · 웹 API GET /api/leave/policies/:eid | 기본 연차 일수 · 부여 기준 · 반차·병가 허용 |
LV-20 · 우리 회사만 쓰는 휴가 종류를 만들어요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/hr/leave-types호출 없음 — 화면에서 해요.
LV-21 · 병가나 경조 같은 다른 종류 휴가를 올려요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 |
| 2-미리보기 | 먼저 묻기: 「어떤 종류의 휴가인가요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-11-02","end_date":"2026-11-04","leave_type":"family_event","reason":"본인 결혼"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-11-02","end_date":"2026-11-04","leave_type":"family_event","reason":"본인 결혼","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
휴가 신청 번호 · 결재자 이름 |
LV-22 · 팀원의 남은 연차를 봐요. AI 로 끝까지 돼요
/worker/team?tab=leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구의 연차를 볼까요?」 {"name":"run_read","arguments":{"tool":"query_leave_balance","args":{"worker":"김가상","year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_leave_balance | 남은 일수 · 사용 일수 |
LV-23 · 연차를 거의 안 쓴 직원이 누구인지 봐요. AI 로 끝까지 돼요
/admin/enterprise/leave-encouragement| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_low_leave_users","args":{"year":2026,"max_used_days":3}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_low_leave_users | 이름 · 부서 · 사용 일수 · 남은 일수 |
LV-24 · 반려된 휴가를 고쳐서 다시 올려요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"status":"rejected","year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves · 웹 API GET /api/leave/requests/me | 신청 번호 · 반려 사유 |
| 2-미리보기 | 먼저 묻기: 「어느 날로 바꿔서 다시 올릴까요?」 {"name":"run_destructive","arguments":{"tool":"approval_resubmit","args":{"type":"leave","start_date":"2026-10-28","reason":"일정 조정 후 다시 신청","end_date":"2026-10-28"}}}1.leaves.0.leave_id → from_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests | confirmation_id 후보가 여럿이면(needs_choice) 「어느 반려 건을 다시 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"approval_resubmit","args":{"type":"leave","start_date":"2026-10-28","reason":"일정 조정 후 다시 신청","end_date":"2026-10-28"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.leaves.0.leave_id → from_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests | 새 신청 번호 · 결재자 이름 |
LV-25 · 회사 전체의 휴가 사용 현황을 봐요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-ledger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_leave_summary","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_company_leave_summary | 부여 합계 · 사용 합계 · 남은 합계 · 사용률 |
LV-26 · 회사 전체에서 승인 기다리는 휴가를 봐요. AI 로 끝까지 돼요
/worker/requests?view=history&tab=need| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leaves_pending","args":{}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_leaves_pending | 신청자 · 부서 · 날짜 · 종류 · 신청 번호 |
LV-27 · 오늘이나 내일 누가 쉬는지 봐요. AI 로 끝까지 돼요
/worker/team?tab=leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leaves_on_date","args":{"date":"2026-10-22"}}} |
몸통 src/routes/mcp-tools/leave.ts:query_leaves_on_date | 이름 · 부서 · 휴가 종류 · 기간 |
LV-28 · 회사가 쉬는 날(공휴일)을 정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/hr/company-holidays호출 없음 — 화면에서 해요.
결재
APR-01 · 어제 퇴근 기록을 고쳐 달라고 결재를 올려요. AI 로 끝까지 돼요
/worker/attendance-correction| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"attendance_fix"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「어느 날 기록을 몇 시로 고칠까요?」 {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"18:30","reason":"퇴근 기록을 깜빡했어요"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/attendance-correction-submit-core.ts:attendanceCorrectionSubmitCore · 웹 API POST /api/workers/me/attendance-corrections {day, checkin_time, checkout_time, reason} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"18:30","reason":"퇴근 기록을 깜빡했어요","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/attendance-correction-submit-core.ts:attendanceCorrectionSubmitCore · 웹 API POST /api/workers/me/attendance-corrections {day, checkin_time, checkout_time, reason} |
결재 번호 · 결재자 · 참조인 |
APR-02 · 경비를 쓴 내역으로 결재를 올려요. AI 로 끝까지 돼요
/worker/expense| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"expense"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「경비 종류와 금액을 알려 주세요.」 {"name":"approval_request","arguments":{"type":"expense","category_id":3,"amount":50000,"expense_date":"2026-10-20","description":"영업부 회식비","payment_method":"card_corp"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/expense-submit-core.ts:expenseSubmitCore · 웹 API POST /api/worker/expense {category_id, amount, expense_date, description, payment_method} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"expense","category_id":3,"amount":50000,"expense_date":"2026-10-20","description":"영업부 회식비","payment_method":"card_corp","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/expense-submit-core.ts:expenseSubmitCore · 웹 API POST /api/worker/expense {category_id, amount, expense_date, description, payment_method} |
결재 번호 · 결재자 · 참조인 |
APR-03 · 올린 결재가 지금 누구 차례인지 자세히 봐요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/lib/worker-my-requests-reader.ts:readWorkerMyRequests · 웹 API GET /api/worker/my-requests | 결재 번호 · 결재 종류 |
| 2 | 먼저 묻기: 「어느 결재를 자세히 볼까요?」 {"name":"run_read","arguments":{"tool":"approval_get","args":{"id":101,"type":"leave"}}}1.items.0.id → id · 1.items.0.type → type |
몸통 src/routes/mcp-tools/approval-read.ts:approvalGet · 함수 src/lib/request-overview.ts:loadRequestOverview | 진행 상태 · 지금 결재자 · 참조인 · 댓글 |
APR-04 · 휴가 취소 결재를 처리해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests호출 없음 — 화면에서 해요.
APR-05 · 참조인을 넣어서 결재를 올려요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"trip"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | {"name":"approval_request","arguments":{"type":"trip","trip_type":"client_visit","destination":"수원","purpose":"고객사 방문","start_date":"2026-10-23","end_date":"2026-10-23","approver_name":"김가상","cc":["이가상"]}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/business-trip {trip_type, destination, purpose, start_date, end_date} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구로 할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"trip","trip_type":"client_visit","destination":"수원","purpose":"고객사 방문","start_date":"2026-10-23","end_date":"2026-10-23","approver_name":"김가상","cc":["이가상"],"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/business-trip {trip_type, destination, purpose, start_date, end_date} |
결재 번호 · 결재자 · 참조인 |
APR-06 · 내일 연차 결재를 올려요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-routing.ts:resolveApprovalRoute | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「며칠에 쉬실 건가요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-22","end_date":"2026-10-22","leave_type":"annual","reason":"개인 사정"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-22","end_date":"2026-10-22","leave_type":"annual","reason":"개인 사정","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
결재 번호 · 결재자 · 참조인 |
APR-07 · 출장 결재를 올려요. AI 로 끝까지 돼요
/worker/business-trip| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"trip"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「어디로 며칠에 가시나요?」 {"name":"approval_request","arguments":{"type":"trip","trip_type":"domestic_overnight","destination":"부산","purpose":"고객사 미팅","start_date":"2026-10-26","end_date":"2026-10-27"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/business-trip {trip_type, destination, purpose, start_date, end_date} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"trip","trip_type":"domestic_overnight","destination":"부산","purpose":"고객사 미팅","start_date":"2026-10-26","end_date":"2026-10-27","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/business-trip {trip_type, destination, purpose, start_date, end_date} |
결재 번호 · 결재자 · 참조인 |
APR-08 · 외근 결재를 올려요. AI 로 끝까지 돼요
/worker/remote| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"remote"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「어느 날 어디로 나가시나요?」 {"name":"approval_request","arguments":{"type":"remote","start_date":"2026-10-23","end_date":"2026-10-23","reason":"고객사 방문","location":"판교 고객사"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/remote-work-submit-core.ts:remoteWorkSubmitCore · 웹 API POST /api/worker/remote-work {start_date, end_date, reason, location} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"remote","start_date":"2026-10-23","end_date":"2026-10-23","reason":"고객사 방문","location":"판교 고객사","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/remote-work-submit-core.ts:remoteWorkSubmitCore · 웹 API POST /api/worker/remote-work {start_date, end_date, reason, location} |
결재 번호 · 결재자 · 참조인 |
APR-09 · 인감 사용 결재를 올려요. AI 로 끝까지 돼요
/worker/seal| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"seal"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「어떤 도장을 어느 문서에 쓰시나요?」 {"name":"approval_request","arguments":{"type":"seal","seal_type":"corporate","document_name":"용역 계약서","purpose":"계약 체결"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/seal/requests | confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"seal","seal_type":"corporate","document_name":"용역 계약서","purpose":"계약 체결","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/seal/requests | 결재 번호 · 결재자 · 참조인 |
APR-10 · 오늘 연장근무 결재를 올려요. AI 로 끝까지 돼요
/worker/overtime| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"overtime"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「몇 시부터 몇 시까지 하시나요?」 {"name":"approval_request","arguments":{"type":"overtime","request_date":"2026-10-21","start_time":"18:00","end_time":"20:00","reason":"마감 업무"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/overtime {request_date, start_time, end_time, reason} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"overtime","request_date":"2026-10-21","start_time":"18:00","end_time":"20:00","reason":"마감 업무","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 웹 API POST /api/worker/overtime {request_date, start_time, end_time, reason} |
결재 번호 · 결재자 · 참조인 |
APR-11 · 전자결재 문서를 올려요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"eapproval"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
| 2-미리보기 | 먼저 묻기: 「어느 양식으로 어떤 제목을 올릴까요?」 {"name":"approval_request","arguments":{"type":"eapproval","form_id":2,"title":"비품 구매 요청","data_json":"{\"품목\":\"모니터 2대\"}"}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/eapproval-submit-core.ts:eapprovalSubmitCore · 웹 API POST /api/workers/me/approval-requests {form_id, title, data_json} |
confirmation_id 후보가 여럿이면(needs_choice) 「결재자가 여럿이에요. 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"approval_request","arguments":{"type":"eapproval","form_id":2,"title":"비품 구매 요청","data_json":"{\"품목\":\"모니터 2대\"}","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_request · 함수 src/lib/eapproval-submit-core.ts:eapprovalSubmitCore · 웹 API POST /api/workers/me/approval-requests {form_id, title, data_json} |
결재 번호 · 결재자 · 참조인 |
APR-12 · 내가 결재할 차례인 것을 봐요. AI 로 끝까지 돼요
/worker/requests| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"inbox"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/routes/mcp-tools/approval-read.ts:readApprovalInboxItems · 웹 API GET /api/worker/my-approvals | 결재 번호 · 결재 종류 · 올린 사람 |
APR-13 · 참조로 걸린 결재 알림이 안 와요. 아직 AI 로 안 돼요 · 대신 화면
/worker/notif-settings호출 없음 — 화면에서 해요.
APR-14 · 내가 올린 결재가 어떻게 됐는지 봐요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/lib/worker-my-requests-reader.ts:readWorkerMyRequests · 웹 API GET /api/worker/my-requests | 결재 번호 · 결재 종류 · 진행 상태 · 결재선 |
APR-15 · 부서장 본인 휴가의 결재선을 확인해요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-routing.ts:resolveApprovalRoute | 결재선 · 결재자 없음 여부 |
APR-16 · 올라온 결재를 반려해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests호출 없음 — 화면에서 해요.
APR-17 · 회사만의 결재 양식을 만들어요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-forms호출 없음 — 화면에서 해요.
APR-18 · 근태 정정을 누가 승인할지 정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-rules호출 없음 — 화면에서 해요.
APR-19 · 결재를 올리면 누가 결재하는지 미리 봐요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어떤 결재를 올리실 건가요?」 {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"expense"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:approval_preview · 함수 src/lib/approval-line-picker.ts:resolveApprovalLineCandidatePage · 웹 API GET /api/workers/me/approval-requests/approvers | 결재자 후보 · 참조인 |
APR-20 · 올라온 결재를 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/requests| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"inbox"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/routes/mcp-tools/approval-read.ts:readApprovalInboxItems · 웹 API GET /api/worker/my-approvals | 결재 번호 · 결재 종류 |
APR-21 · 휴가를 누가 승인할지 회사 규칙을 바꿔요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-rules호출 없음 — 화면에서 해요.
APR-22 · 올린 결재를 거둬요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/lib/worker-my-requests-reader.ts:readWorkerMyRequests · 웹 API GET /api/worker/my-requests | 결재 번호 · 결재 종류 |
| 2-미리보기 | 먼저 묻기: 「어느 결재를 거둘까요?」 {"name":"run_destructive","arguments":{"tool":"approval_cancel","args":{"id":101,"type":"leave"}}}1.items.0.id → id · 1.items.0.type → type |
몸통 src/routes/mcp-tools/approval-read.ts:approvalCancel · 함수 src/lib/leave-cancel-service.ts:executeLeaveSelfCancel · 웹 API PATCH /api/leave/requests/:id/cancel | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"approval_cancel","args":{"id":101,"type":"leave"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 1.items.0.type → type · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-read.ts:approvalCancel · 함수 src/lib/leave-cancel-service.ts:executeLeaveSelfCancel · 웹 API PATCH /api/leave/requests/:id/cancel | 회수 결과 |
APR-23 · 결재권자를 더하거나 빼요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구를 어느 결재에 더할까요?」 {"name":"run_destructive","arguments":{"tool":"set_approval_line","args":{"action":"add","item_type":"leave","worker":"김가상"}}} |
몸통 src/routes/mcp-tools/approval-roster-tool.ts:set_approval_line · 함수 src/lib/approval-authority-write.ts:addApprovalAuthority · 웹 API POST /api/admin/enterprise/approval-authorities | 바뀐 명단 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구로 할까요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
APR-24 · 파일을 붙여서 결재를 올려요. 아직 AI 로 안 돼요 · 대신 화면
/worker/approvals호출 없음 — 화면에서 해요.
APR-25 · 경비 금액이 크면 결재자를 더 두어요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-rules호출 없음 — 화면에서 해요.
APR-26 · 반려된 결재를 고쳐서 다시 올려요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList · 함수 src/lib/worker-my-requests-reader.ts:readWorkerMyRequests · 웹 API GET /api/worker/my-requests | 반려된 결재 번호 · 결재 종류 |
| 2-미리보기 | 먼저 묻기: 「어느 반려 결재를 고칠까요?」 {"name":"run_destructive","arguments":{"tool":"approval_resubmit","args":{"from_id":101,"type":"leave","start_date":"2026-10-23","end_date":"2026-10-23"}}}1.items.1.id → from_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_resubmit · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"approval_resubmit","args":{"from_id":101,"type":"leave","start_date":"2026-10-23","end_date":"2026-10-23"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.1.id → from_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:approval_resubmit · 함수 src/routes/mcp-leave-request.ts:createMcpLeaveRequest · 웹 API POST /api/leave/requests {start_date, end_date, leave_type, reason} |
새 결재 번호 · 결재자 · 참조인 |
APR-27 · 출장·외근·인감·근태 정정 결재를 거둬요. 아직 AI 로 안 돼요 · 대신 화면
/worker/approvals호출 없음 — 화면에서 해요.
APR-28 · 모든 결재를 보는 필수 참고인을 정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-rules호출 없음 — 화면에서 해요.
APR-29 · 회사의 결재선 목록을 봐요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_approval_lines","args":{"limit":10}}} |
몸통 src/routes/mcp-tools/approvals.ts:query_approval_lines · 웹 API GET /api/admin/enterprise/approval-lines | 결재선 이름 · 결재 순서 |
APR-30 · 반려된 외근·근태 정정·경비·전자결재를 다시 올려요. 아직 AI 로 안 돼요 · 대신 화면
/worker/approvals호출 없음 — 화면에서 해요.
업무 요청
TSK-01 · 내가 받은 업무를 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 제목 · 마감 |
TSK-02 · 오늘 꼭 볼 업무를 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"today","arguments":{"kind":"tasks"}} |
몸통 src/routes/mcp-tools/today-core.ts:today | 항목 번호 · 마감 |
TSK-03 · 누구에게 업무를 요청해서 보내요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구에게 무엇을 언제까지 보낼까요?」 {"name":"task_create","arguments":{"title":"견적 정리","body":"견적서를 정리해 주세요.","to":["김가상"],"due":"2026-10-23"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskCreate · 함수 src/routes/api-features/team-calendar/tasks.ts:taskCreateCore · 웹 API POST /api/worker/calendar/tasks {title, memo, assigneeIds, refIds, dueDate, dueTime} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"task_create","arguments":{"title":"견적 정리","body":"견적서를 정리해 주세요.","to":["김가상"],"due":"2026-10-23","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskCreate · 함수 src/routes/api-features/team-calendar/tasks.ts:taskCreateCore · 웹 API POST /api/worker/calendar/tasks {title, memo, assigneeIds, refIds, dueDate, dueTime} |
업무 번호 |
TSK-04 · 받은 업무에 댓글을 달아요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무에 댓글을 달까요?」 {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2-미리보기 | {"name":"task_comment","arguments":{"body":"확인했어요. 금요일까지 드릴게요."}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskComment · 함수 src/routes/api-features/team-calendar/tasks.ts:taskCommentCore · 웹 API POST /api/worker/calendar/tasks/:uid/comments {body, mentions} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구를 부를까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_comment","arguments":{"body":"확인했어요. 금요일까지 드릴게요.","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskComment · 함수 src/routes/api-features/team-calendar/tasks.ts:taskCommentCore · 웹 API POST /api/worker/calendar/tasks/:uid/comments {body, mentions} |
댓글 번호 |
TSK-05 · 받은 업무를 확인했다고 알려요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무를 확인했나요?」 {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2-미리보기 | {"name":"task_state","arguments":{"to":"ack"}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_state","arguments":{"to":"ack","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
업무 상태 |
TSK-06 · 받은 업무를 끝냈다고 알려요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무를 끝냈나요?」 {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2-미리보기 | {"name":"task_state","arguments":{"to":"done"}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_state","arguments":{"to":"done","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
업무 상태 |
TSK-07 · 기한이 지난 업무를 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"task_list","arguments":{"view":"overdue"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 제목 · 마감 |
TSK-08 · 사람마다 다른 일을 한 번에 맡겨요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구에게 어떤 일을 맡길까요?」 {"name":"run_destructive","arguments":{"tool":"task_multi","args":{"title":"발표 준비","due":"2026-10-23","mode":"split","people":[{"who":"김가상","task":"발표 자료 만들기"},{"who":"이가상","task":"장소 잡기"}]}}} |
몸통 src/routes/mcp-tools/work-task-multi.ts:confirmSend · 함수 src/routes/task-request-tools.ts:sendTaskRequest · 웹 API POST /api/worker/calendar/tasks {title, dueDate, dueTime, split} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"task_multi","args":{"title":"발표 준비","due":"2026-10-23","mode":"split","people":[{"who":"김가상","task":"발표 자료 만들기"},{"who":"이가상","task":"장소 잡기"}]},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-task-multi.ts:confirmSend · 함수 src/routes/task-request-tools.ts:sendTaskRequest · 웹 API POST /api/worker/calendar/tasks {title, dueDate, dueTime, split} |
업무 묶음 번호 |
TSK-09 · 부서 사람 모두에게 같은 일을 맡겨요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「어느 부서에 무슨 일을 맡길까요?」 {"name":"run_destructive","arguments":{"tool":"task_multi","args":{"title":"안전 점검표 제출","due":"2026-10-23","mode":"same","dept":"영업부"}}} |
몸통 src/routes/mcp-tools/work-task-multi.ts:confirmSend · 함수 src/routes/task-request-tools.ts:sendTaskRequest · 웹 API POST /api/worker/calendar/tasks {title, assigneeIds, dueDate, dueTime} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"task_multi","args":{"title":"안전 점검표 제출","due":"2026-10-23","mode":"same","dept":"영업부"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-task-multi.ts:confirmSend · 함수 src/routes/task-request-tools.ts:sendTaskRequest · 웹 API POST /api/worker/calendar/tasks {title, assigneeIds, dueDate, dueTime} |
업무 번호 |
TSK-10 · 여러 사람에게 맡긴 업무의 진행을 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무의 진행을 볼까요?」 {"name":"run_read","arguments":{"tool":"task_status","args":{"title":"발표 준비"}}} |
몸통 src/routes/mcp-tools/work-task-multi.ts:taskStatus · 함수 src/routes/task-request-tools.ts:readTaskProgress | 묶음 진행률 · 사람별 상태 |
TSK-11 · 오늘 업무일지를 써요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「일지에 무엇을 적을까요?」 {"name":"run_write","arguments":{"tool":"journal_write","args":{"date":"2026-10-21","body":"견적서 정리를 마쳤고 내일 검토해요."}}} |
몸통 src/routes/mcp-tools/work-tasks.ts:journalWrite · 함수 src/lib/team-calendar-tasks-write.ts:buildJournalWrite · 웹 API PUT /api/worker/calendar/task-journals/:date {body, refs} |
일지 번호 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구를 참조로 할까요?」 → 고른 id 로 같은 줄을 다시 · 답의 undo_id 로 5분 안 되돌릴 수 있어요 |
TSK-12 · 내가 시킨 업무가 어디까지 됐는지 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"task_list","arguments":{"view":"sent","fields":["title","due","assignees","progress"]}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 받은 사람 · 진행 |
TSK-13 · 팀원들이 맡은 업무를 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"task_list","arguments":{"view":"people"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 받은 사람 |
TSK-14 · 업무 하나를 자세히 열어 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무를 열어 볼까요?」 {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2 | {"name":"task_get","arguments":{}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskGet · 함수 src/lib/team-calendar-tasks-read.ts:readTaskDetail · 웹 API GET /api/worker/calendar/tasks/:uid | 본문 · 댓글 · 기한 변경 이력 |
TSK-15 · 시킨 업무를 다시 해 달라고 해요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무를 다시 시킬까요?」 {"name":"task_list","arguments":{"view":"sent"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2-미리보기 | {"name":"task_state","arguments":{"to":"redo","reason":"자료를 다시 정리해 주세요."}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
confirmation_id 후보가 여럿이면(needs_choice) 「누구에게 다시 해 달라고 할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_state","arguments":{"to":"redo","reason":"자료를 다시 정리해 주세요.","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskState · 함수 src/routes/api-features/team-calendar/tasks.ts:taskStateCore · 웹 API POST /api/worker/calendar/tasks/:uid/state {to, w} |
업무 상태 |
TSK-16 · 받은 업무의 기한을 바꿔 달라고 해요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무의 기한을 바꿀까요?」 {"name":"task_list","arguments":{"view":"todo"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 |
| 2-미리보기 | 먼저 묻기: 「언제로 바꿔 달라고 할까요?」 {"name":"run_destructive","arguments":{"tool":"task_due_request","args":{"to":"2026-10-28","reason":"자료가 늦게 와서 시간이 더 필요해요."}}}1.items.0.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskDueRequest · 함수 src/routes/api-features/team-calendar/tasks.ts:taskDueCore · 웹 API POST /api/worker/calendar/tasks/:uid/due {action, to, time, reason} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"task_due_request","args":{"to":"2026-10-28","reason":"자료가 늦게 와서 시간이 더 필요해요."},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskDueRequest · 함수 src/routes/api-features/team-calendar/tasks.ts:taskDueCore · 웹 API POST /api/worker/calendar/tasks/:uid/due {action, to, time, reason} |
요청한 기한 |
TSK-17 · 아직 확인 안 한 사람에게 재촉해요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 업무를 재촉할까요?」 {"name":"task_list","arguments":{"view":"sent","fields":["title","assignees"]}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 받은 사람 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"task_nudge","args":{}}}1.items.1.id → id · 1.items.1.assignees.0.id → who |
몸통 src/routes/mcp-tools/work-tasks.ts:taskNudge · 함수 src/routes/api-features/team-calendar/tasks.ts:taskNudgeCore · 웹 API POST /api/worker/calendar/tasks/:uid/nudge {w} | confirmation_id 후보가 여럿이면(needs_choice) 「누구에게 재촉할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"task_nudge","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.1.id → id · 1.items.1.assignees.0.id → who · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:taskNudge · 함수 src/routes/api-features/team-calendar/tasks.ts:taskNudgeCore · 웹 API POST /api/worker/calendar/tasks/:uid/nudge {w} | 재촉 횟수 |
TSK-18 · 업무책을 켜거나 꺼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/settings/modules호출 없음 — 화면에서 해요.
TSK-20 · 업무에 결과물 파일을 올려요. 아직 AI 로 안 돼요 · 대신 화면
/worker/calendar호출 없음 — 화면에서 해요.
TSK-21 · 이미 보낸 업무에 참조인을 더해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/calendar호출 없음 — 화면에서 해요.
TSK-22 · 업무를 다른 사람에게 넘겨요. 아직 AI 로 안 돼요 · 대신 화면
/worker/calendar호출 없음 — 화면에서 해요.
TSK-23 · 시킨 업무를 취소해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/calendar호출 없음 — 화면에서 해요.
TSK-24 · 이번 주 안에 마감인 업무를 봐요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「언제까지 마감인 일을 볼까요?」 {"name":"task_list","arguments":{"view":"todo","due_to":"2026-10-23"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:taskList · 함수 src/lib/team-calendar-tasks-read.ts:readTaskView · 웹 API GET /api/worker/calendar/tasks {view} | 업무 번호 · 제목 · 마감 |
메일
MAIL-01 · 메일 한 통을 읽고 요약해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일을 읽을까요? 보낸 사람이나 제목을 알려 주세요.」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","q":"견적"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 · 보낸 사람 · 제목 |
| 2 | {"name":"run_read","arguments":{"tool":"mail_get","args":{}}}1.items.0.id → id |
몸통 src/routes/mcp-tools/mail-read.ts:mailGet · 함수 src/routes/mcp-tools/mail-read.ts:readMessage | 본문 · 받는 사람 · 첨부 목록 |
MAIL-02 · 안 읽은 메일이 있는지 봐요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","unread":true,"limit":10}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 안 읽은 메일 수 · 보낸 사람 · 제목 |
MAIL-03 · 가진 도메인을 회사 메일에 연결해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/storage?tab=mail-connect호출 없음 — 화면에서 해요.
MAIL-04 · 받은 메일을 보낸 사람이나 제목으로 찾아요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「무슨 말로 찾을까요?」 {"name":"search","arguments":{"query":"견적서","kind":"mail"}} |
몸통 src/routes/mcp-tools/base-search.ts:search · 함수 src/routes/mcp-tools/mail-sections.ts:mailSearchCell | 메일 번호 · 보낸 사람 · 제목 |
MAIL-05 · 오늘 읽을 회사 메일만 한눈에 봐요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"today","arguments":{"kind":"mail","limit":10}} |
몸통 src/routes/mcp-tools/today-core.ts:todayTools · 함수 src/routes/mcp-tools/mail-sections.ts:mailTodayCell | 메일 번호 · 앞 80자 |
MAIL-06 · 메일에 붙은 첨부 파일을 받아요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일의 첨부인가요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","filter":"attachment"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 · 제목 |
| 2 | {"name":"run_read","arguments":{"tool":"mail_get","args":{}}}1.items.0.id → id |
몸통 src/routes/mcp-tools/mail-read.ts:mailGet · 함수 src/routes/mcp-tools/mail-read.ts:attachmentsOf | 첨부 번호 · 첨부 이름 |
| 3 | {"name":"run_read","arguments":{"tool":"mail_attachment_link","args":{}}}1.items.0.id → id · 2.attachments.0.attachment_id → attachment_id |
몸통 src/routes/mcp-tools/mail-read.ts:mailAttachmentLink | 받기 주소 |
MAIL-07 · 받은 메일에 답장을 보내요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일에 답장할까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","q":"견적"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 |
| 2-미리보기 | 먼저 묻기: 「어떤 내용으로 답장할까요?」 {"name":"mail_send","arguments":{"text":"확인했어요. 내일 오전까지 보내 드릴게요."}}1.items.0.id → reply_to |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"mail_send","arguments":{"text":"확인했어요. 내일 오전까지 보내 드릴게요.","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → reply_to · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 |
MAIL-08 · 직원에게 회사 메일 계정을 만들어 줘요. AI 로 끝까지 돼요
/admin/enterprise/storage?tab=mail-staff| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 도메인에 만들까요?」 {"name":"run_destructive","arguments":{"tool":"mail_account_create","args":{"domain":"a-company.example","worker":"정신입"}}} |
몸통 src/routes/mcp-tools/m5-mail-accounts.ts:mailAccountCreate | 작업 번호 · 만들 주소 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구 메일을 만들까요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
| 2 | {"name":"run_read","arguments":{"tool":"job_status","args":{}}}1.job_id → job_id |
몸통 src/routes/mcp-tools/m5-mail-accounts.ts:jobStatus | 진행 상태 |
MAIL-09 · 보내지 않고 메일을 임시저장해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_write","arguments":{"tool":"mail_draft","args":{"to":["partner@example.com"],"subject":"견적 문의","text":"견적서를 보내 주세요."}}} |
몸통 src/routes/mcp-tools/mail-write.ts:mailDraft · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 임시저장 번호 답의 undo_id 로 5분 안 되돌릴 수 있어요 |
MAIL-10 · 받은 메일을 다른 사람에게 전달해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일을 전달할까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","q":"견적"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 |
| 2-미리보기 | 먼저 묻기: 「누구에게 전달할까요?」 {"name":"mail_send","arguments":{"person":"이가상","text":"참고하세요."}}1.items.0.id → forward_of |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"mail_send","arguments":{"person":"이가상","text":"참고하세요.","confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → forward_of · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 |
MAIL-11 · 새 메일을 써서 보내요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구에게 보낼까요?」 {"name":"mail_send","arguments":{"person":"이가상","subject":"회의 시간 안내","text":"내일 오전 10시에 회의해요."}} |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"mail_send","arguments":{"person":"이가상","subject":"회의 시간 안내","text":"내일 오전 10시에 회의해요.","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 |
MAIL-12 · 받은 메일에 전체 답장을 보내요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일에 전체 답장할까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","q":"회의"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 |
| 2-미리보기 | {"name":"mail_send","arguments":{"text":"모두 확인했어요. 감사합니다.","reply_all":true}}1.items.0.id → reply_to |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"mail_send","arguments":{"text":"모두 확인했어요. 감사합니다.","reply_all":true,"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.id → reply_to · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 |
MAIL-13 · 메일을 정한 시각에 보내도록 예약해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「언제 보낼까요?」 {"name":"mail_send","arguments":{"person":"이가상","subject":"회의 자료 안내","text":"내일 아침에 자료를 공유드릴게요.","send_at":"2026-10-22T09:00:00+09:00"}} |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"mail_send","arguments":{"person":"이가상","subject":"회의 자료 안내","text":"내일 아침에 자료를 공유드릴게요.","send_at":"2026-10-22T09:00:00+09:00","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 · 나갈 시각 |
MAIL-14 · 예약해 둔 메일 발송을 취소해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 예약 메일을 취소할까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"scheduled"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 발송 번호 · 제목 · 나갈 시각 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"mail_send_cancel","args":{}}}1.items.0.delivery.submission_id → submission_id |
몸통 src/routes/mcp-tools/mail-thread.ts:mailSendCancel | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"mail_send_cancel","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.items.0.delivery.submission_id → submission_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-thread.ts:mailSendCancel | 취소 결과 |
MAIL-15 · 보낸 메일이 잘 갔는지 확인해요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일이 잘 갔는지 알고 싶으세요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"sent","limit":5}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 발송 번호 · 제목 |
| 2 | {"name":"run_read","arguments":{"tool":"mail_send_status","args":{}}}1.items.0.delivery.submission_id → submission_id |
몸통 src/routes/mcp-tools/mail-thread.ts:mailSendStatus · 함수 src/routes/mcp-tools/mail-thread.ts:submissionView | 받는 사람별 전달 상태 |
MAIL-16 · 부서 전원에게 메일을 보내요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「어느 부서에 보낼까요?」 {"name":"mail_send","arguments":{"department":"영업부","subject":"월간 회의 안내","text":"금요일 오후 3시에 월간 회의가 있어요."}} |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"mail_send","arguments":{"department":"영업부","subject":"월간 회의 안내","text":"금요일 오후 3시에 월간 회의가 있어요.","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/mail-write.ts:mailSend · 함수 src/routes/mcp-tools/mail-send-plan.ts:planSend | 접수 번호 · 받는 사람 수 |
MAIL-17 · 메일 첨부 파일 속 글자를 읽어요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일의 첨부를 읽을까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","filter":"attachment"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 · 제목 |
| 2 | {"name":"run_read","arguments":{"tool":"mail_get","args":{}}}1.items.0.id → id |
몸통 src/routes/mcp-tools/mail-read.ts:mailGet · 함수 src/routes/mcp-tools/mail-read.ts:attachmentsOf | 첨부 번호 · 첨부 이름 |
| 3 | {"name":"run_read","arguments":{"tool":"mail_attachment_text","args":{}}}1.items.0.id → id · 2.attachments.0.attachment_id → attachment_id |
몸통 src/routes/mcp-tools/mail-read.ts:mailAttachmentText | 첨부 글자 |
MAIL-18 · 거래처와 오간 메일 대화를 한눈에 봐요. AI 로 끝까지 돼요
/worker/mail| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 메일의 대화를 볼까요?」 {"name":"run_read","arguments":{"tool":"mail_list","args":{"mailbox":"inbox","q":"견적"}}} |
몸통 src/routes/mcp-tools/mail-read.ts:mailList · 함수 src/routes/mcp-tools/mail-read.ts:mailListItemOf | 메일 번호 |
| 2 | {"name":"run_read","arguments":{"tool":"mail_thread","args":{}}}1.items.0.id → id |
몸통 src/routes/mcp-tools/mail-thread.ts:mailThread · 함수 src/routes/mcp-tools/mail-read.ts:threadIndexOf | 대화 흐름 |
MAIL-19 · 직원의 회사 메일 계정을 정지해요. AI 로 끝까지 돼요
/admin/enterprise/storage?tab=mail-staff| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「정지 사유가 무엇인가요?」 {"name":"run_destructive","arguments":{"tool":"mail_account_admin","args":{"action":"suspend","worker":"한신입","reason":"퇴사 처리"}}} |
몸통 src/routes/mcp-tools/m5-mail-accounts.ts:mailAccountAdmin | 정지 결과 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구 계정을 정지할까요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
MAIL-20 · 메일을 읽음 · 별표 · 휴지통으로 옮겨요. 아직 AI 로 안 돼요 · 대신 화면
/worker/mail호출 없음 — 화면에서 해요.
메신저
MSG-01 · 알림이 안 울릴 때 알림 설정을 봐요. 아직 AI 로 안 돼요 · 대신 화면
/worker/notif-settings호출 없음 — 화면에서 해요.
MSG-02 · 직원에게 메신저를 쓰게 해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/settings/modules호출 없음 — 화면에서 해요.
MSG-03 · 안 읽은 메신저 방을 봐요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"messenger_rooms","args":{"unread_only":true}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRooms · 함수 src/lib/chatpang-person-bridge.ts:personRoomList · 웹 API GET /api/worker/messenger/rooms | 방 번호 · 안 읽은 수 |
MSG-04 · 오늘 메신저 새 글을 한 번에 모아 봐요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"messenger_digest","args":{"since":"today","rooms":"unread"}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerDigest · 함수 src/lib/chatpang-person-bridge.ts:personDigest | 방 이름 · 새 글 |
MSG-05 · 메신저 방이나 사람에게 글을 보내요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구에게 무슨 말을 보낼까요?」 {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"김가상","text":"3시 회의 맞죠?"}}} |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 어느 방인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"김가상","text":"3시 회의 맞죠?"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | 보낸 글 번호 |
MSG-06 · 받은 메신저를 읽고 답장을 보내요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구의 메시지에 답할까요?」 {"name":"run_read","arguments":{"tool":"messenger_read","args":{"room":"김가상","limit":5}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRead · 함수 src/lib/chatpang-person-bridge.ts:personMessages | 최근 글 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 어느 방인가요?」 → 고른 id 로 같은 줄을 다시 |
| 2-미리보기 | 먼저 묻기: 「답장에 어떤 뜻을 담을까요?」 {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"김가상","text":"네, 확인했어요."}}} |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 어느 방인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"김가상","text":"네, 확인했어요."},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | 보낸 글 번호 |
MSG-07 · 주 52시간이 임박하면 알림을 받게 해요. AI 로 끝까지 돼요
/admin/enterprise/alert-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「어떤 일이 생기면 알릴까요?」 {"name":"run_destructive","arguments":{"tool":"register_alert_rule","args":{"rule_type":"weekly_52h_risk","scope":"company"}}} |
몸통 src/routes/mcp-tools/alerts.ts:register_alert_rule | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"register_alert_rule","args":{"rule_type":"weekly_52h_risk","scope":"company"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/alerts.ts:register_alert_rule | 규칙 번호 |
MSG-08 · 오늘 온 인사책 알림을 봐요. AI 로 끝까지 돼요
/worker/notif-settings| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"today","arguments":{"kind":"notices"}} |
몸통 src/routes/mcp-tools/today-core.ts:today | 알림 번호 · 알림 내용 |
MSG-09 · 메신저 방을 찾아 글을 읽어요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 방의 글을 읽을까요?」 {"name":"run_read","arguments":{"tool":"messenger_rooms","args":{"unread_only":false,"query":"영업"}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRooms · 함수 src/lib/chatpang-person-bridge.ts:personRoomList | 방 번호 |
| 2 | {"name":"run_read","arguments":{"tool":"messenger_read","args":{"since":"today","limit":30}}}1.items.0.id → room_id |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRead · 함수 src/lib/chatpang-person-bridge.ts:personMessages | 글 내용 |
MSG-10 · 회사 메신저를 켜거나 꺼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/settings/modules호출 없음 — 화면에서 해요.
MSG-11 · 새 공지를 보고 읽음으로 바꿔요. AI 로 끝까지 돼요
/worker/community| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 공지를 읽음으로 할까요?」 {"name":"run_read","arguments":{"tool":"query_announcements_unread","args":{"limit":10}}} |
몸통 src/routes/mcp-tools/ops.ts:query_announcements_unread · 웹 API GET /api/worker/announcements | 공지 번호 · 제목 |
| 2 | {"name":"run_write","arguments":{"tool":"mark_announcement_read","args":{}}}1.announcements.0.id → announcement_id |
몸통 src/routes/mcp-tools/ops.ts:mark_announcement_read · 웹 API POST /api/worker/announcements/:id/read | 읽음 처리 결과 답의 undo_id 로 5분 안 되돌릴 수 있어요 |
MSG-12 · 지금 나에게 온 메신저가 있는지 봐요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"today","arguments":{"kind":"messenger"}} |
몸통 src/routes/mcp-tools/today-core.ts:today | 방 번호 · 안 읽은 수 |
MSG-13 · 메신저 글에서 말을 찾아요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「무슨 말을 찾을까요?」 {"name":"search","arguments":{"query":"견적","kind":"messenger"}} |
몸통 src/routes/mcp-tools/base-search.ts:search · 함수 src/lib/chatpang-person-bridge.ts:personSearch | 글 · 방 이름 |
MSG-14 · 전 직원에게 보이는 공지를 올려요. AI 로 끝까지 돼요
/admin/enterprise/announcements| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「공지 제목과 내용을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"create_announcement","args":{"title":"전사 회의 안내","body":"내일 오후 2시에 전사 회의가 있어요.","pinned":false}}} |
몸통 src/routes/mcp-tool-handlers.ts:create_announcement · 웹 API POST /api/admin/enterprise/announcements {title, body, pinned} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"create_announcement","args":{"title":"전사 회의 안내","body":"내일 오후 2시에 전사 회의가 있어요.","pinned":false},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:create_announcement · 웹 API POST /api/admin/enterprise/announcements {title, body, pinned} |
공지 번호 |
MSG-15 · 회사 공지 목록을 봐요. AI 로 끝까지 돼요
/worker/community| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_announcements","args":{"limit":10}}} |
몸통 src/routes/mcp-tools/ops.ts:query_announcements · 웹 API GET /api/worker/announcements | 공지 번호 · 제목 |
MSG-16 · 파일을 붙여 메신저로 보내요. AI 로 끝까지 돼요
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「어느 방에 어떤 파일을 보낼까요?」 {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"영업팀","text":"견적서 보내요. 확인 부탁해요.","files":[{"name":"견적서.txt","mime":"text/plain","data_b64":"7Iuc7ZeY"}]}}} |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 어느 방인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"messenger_send","args":{"room":"영업팀","text":"견적서 보내요. 확인 부탁해요.","files":[{"name":"견적서.txt","mime":"text/plain","data_b64":"7Iuc7ZeY"}]},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/messenger-write.ts:messengerSend · 함수 src/lib/chatpang-person-bridge.ts:personSend | 보낸 글 번호 |
MSG-17 · 안 읽은 메신저를 한 번에 읽음으로 해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"messenger_rooms","args":{"unread_only":true}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRooms · 함수 src/lib/chatpang-person-bridge.ts:personRoomList · 웹 API GET /api/worker/messenger/rooms | 안 읽은 방 |
MSG-18 · 누가 메신저를 쓰고 있는지 봐요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/settings/modules호출 없음 — 화면에서 해요.
MSG-19 · 메신저에서 부탁받은 일을 업무로 보내요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 방의 어떤 부탁인가요?」 {"name":"run_read","arguments":{"tool":"messenger_read","args":{"room":"김가상","limit":5}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRead · 함수 src/lib/chatpang-person-bridge.ts:personMessages | 최근 글 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 어느 방인가요?」 → 고른 id 로 같은 줄을 다시 |
| 2-미리보기 | 먼저 묻기: 「누구에게 언제까지 보낼까요?」 {"name":"task_create","arguments":{"title":"견적서 정리","body":"메신저로 받은 부탁이에요. 견적서를 정리해 주세요.","to":["이가상"],"due":"2026-10-23"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_create","arguments":{"title":"견적서 정리","body":"메신저로 받은 부탁이에요. 견적서를 정리해 주세요.","to":["이가상"],"due":"2026-10-23","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | 업무 번호 |
MSG-20 · 메신저 글타래(답글)를 읽어요. 아직 AI 로 안 돼요 · 대신 화면
/worker/messenger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 방의 글인가요?」 {"name":"run_read","arguments":{"tool":"messenger_read","args":{"room":"영업팀","limit":10}}} |
몸통 src/routes/mcp-tools/messenger-read.ts:messengerRead · 함수 src/lib/chatpang-person-bridge.ts:personMessages | 최근 글 · 답글 수 |
사람·조직
ORG-01 · 내 이름과 회사, 역할을 확인해요. AI 로 끝까지 돼요
/worker/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"whoami","arguments":{}} |
몸통 src/routes/mcp-tools/base-whoami.ts:whoami · 웹 API GET /api/workers/me | 이름 · 회사 · 역할 · 쓸 수 있는 일 |
ORG-02 · 회사 사람을 이름이나 부서로 찾아요. AI 로 끝까지 돼요
/worker/my-company| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구를 찾을까요?」 {"name":"search","arguments":{"query":"김가상","kind":"people"}} |
몸통 src/routes/mcp-tools/base-search.ts:search | 이름 · 부서 · 직책 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 |
ORG-03 · 부서나 직책으로 직원 목록을 봐요. AI 로 끝까지 돼요
/worker/team/members| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_employees","args":{"department":"영업1팀"}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_employees | 이름 · 부서 · 직책 · 연락처 |
ORG-04 · 직원 한 명의 인사 정보를 봐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구 정보를 볼까요?」 {"name":"run_read","arguments":{"tool":"query_employee_profile","args":{"worker":"이가상"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_employee_profile · 웹 API GET /api/admin/employees/:id/hr-card | 부서 · 직책 · 입사일 · 계약 기간 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 |
ORG-05 · 회사 조직도를 부서 순서대로 봐요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_org_chart","args":{}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_org_chart · 웹 API GET /api/admin/enterprise/org-chart/data | 부서 이름 · 상위 부서 · 부서장 · 인원 |
ORG-06 · 부서별 인원수를 봐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_headcount_by_department","args":{}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_headcount_by_department | 전체 인원 · 부서별 인원 |
ORG-07 · 새 입사자를 직원으로 등록해요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「휴대폰 번호가 어떻게 되나요?」 {"name":"run_destructive","arguments":{"tool":"add_employee","args":{"name":"정신입","phone":"010-1234-5678","department":"영업2팀","position":"사원","joined_at":"2026-10-21"}}} |
몸통 src/routes/mcp-tools/membership.ts:add_employee · 함수 src/lib/mcp-person-lookup.ts:findAddEmployeeWorker · 웹 API POST /api/workers/invite {name, phone, email, department, position, joined_at} |
confirmation_id 후보가 여럿이면(needs_choice) 「근속을 이어받을까요, 새로 시작할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"add_employee","args":{"name":"정신입","phone":"010-1234-5678","department":"영업2팀","position":"사원","joined_at":"2026-10-21"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/membership.ts:add_employee · 함수 src/lib/mcp-person-lookup.ts:findAddEmployeeWorker · 웹 API POST /api/workers/invite {name, phone, email, department, position, joined_at} |
등록된 직원 이름 |
ORG-08 · 직원을 초대 링크로 불러요. 아직 AI 로 안 돼요 · 대신 화면
/invite/company호출 없음 — 화면에서 해요.
ORG-09 · 가입 신청한 사람을 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_join_requests","args":{}}} |
몸통 src/routes/mcp-tools/membership.ts:query_join_requests | 신청한 사람 · 신청 시각 |
ORG-10 · 새 부서를 만들어요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「부서 이름을 뭐라고 할까요?」 {"name":"run_destructive","arguments":{"tool":"create_department","args":{"name":"영업4팀","parent":"영업부","kind":"team"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:create_department · 웹 API POST /api/admin/departments {name, parent_id, kind, executive_worker_id} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"create_department","args":{"name":"영업4팀","parent":"영업부","kind":"team"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:create_department · 웹 API POST /api/admin/departments {name, parent_id, kind, executive_worker_id} |
새 부서 이름 |
ORG-11 · 부서 이름을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"rename_department","args":{"department":"개발부","new_name":"연구개발부"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:rename_department · 웹 API PATCH /api/admin/departments/:id {name} | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"rename_department","args":{"department":"개발부","new_name":"연구개발부"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:rename_department · 웹 API PATCH /api/admin/departments/:id {name} | 바뀐 부서 이름 |
ORG-12 · 부서를 다른 부서 밑으로 옮겨요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"move_department","args":{"department":"영업2팀","new_parent":"영업부"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:move_department · 웹 API PATCH /api/admin/departments/:id {parent_id} | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"move_department","args":{"department":"영업2팀","new_parent":"영업부"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:move_department · 웹 API PATCH /api/admin/departments/:id {parent_id} | 옮겨진 부서 · 새 상위 부서 |
ORG-13 · 쓰지 않는 부서를 없애요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"archive_department","args":{"department":"영업3팀"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:archive_department · 함수 src/lib/org-member-detach.ts:promoteRemainingAffiliation · 웹 API DELETE /api/admin/departments/:id | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"archive_department","args":{"department":"영업3팀"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:archive_department · 함수 src/lib/org-member-detach.ts:promoteRemainingAffiliation · 웹 API DELETE /api/admin/departments/:id | 없앤 부서 이름 |
ORG-14 · 부서장을 정해요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구를 부서장으로 할까요?」 {"name":"run_destructive","arguments":{"tool":"assign_department_head","args":{"department":"영업1팀","worker":"이가상","mode":"replace"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:assign_department_head · 함수 src/lib/department-head-membership.ts:assignHeadWithMembership | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"assign_department_head","args":{"department":"영업1팀","worker":"이가상","mode":"replace"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:assign_department_head · 함수 src/lib/department-head-membership.ts:assignHeadWithMembership | 부서 · 새 부서장 |
ORG-15 · 직원을 한 부서로 옮겨 넣어요. AI 로 끝까지 돼요
/admin/enterprise/departments| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"정신입","department":"영업2팀"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department · 함수 src/lib/affiliation-department.ts:resolveAffiliationDepartment | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"정신입","department":"영업2팀"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department · 함수 src/lib/affiliation-department.ts:resolveAffiliationDepartment | 옮겨진 직원 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"한신입","department":"영업2팀"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"한신입","department":"영업2팀"},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department | 옮겨진 직원 |
| 3-미리보기 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"오신입","department":"영업2팀"}}} |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 3-확정 | {"name":"run_destructive","arguments":{"tool":"assign_worker_to_department","args":{"worker":"오신입","department":"영업2팀"},"confirmation_id":"<3-미리보기.confirmation_id>"}}3-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-chart.ts:assign_worker_to_department | 옮겨진 직원 |
ORG-16 · 날짜를 정해 직원 인사발령을 내요. AI 로 끝까지 돼요
/admin/enterprise/org-manage| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"transfer_worker","args":{"worker":"이가상","to_department":"영업2팀","to_position":"대리","change_type":"dept_change","effective_date":"2026-11-01","reason":"조직 개편"}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:transfer_worker | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"transfer_worker","args":{"worker":"이가상","to_department":"영업2팀","to_position":"대리","change_type":"dept_change","effective_date":"2026-11-01","reason":"조직 개편"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/orgmodel.ts:transfer_worker | 발령 내용 · 효력일 |
ORG-17 · 직원의 직급을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/job-grades| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"assign_job_grade","args":{"worker":"김가상","grade":"부사장"}}} |
몸통 src/routes/mcp-tools/jobgrades.ts:assign_job_grade | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"assign_job_grade","args":{"worker":"김가상","grade":"부사장"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/jobgrades.ts:assign_job_grade | 바뀐 직급 |
ORG-18 · 직원의 직책이나 부서를 고쳐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_employee_position","args":{"worker":"박가상","position":"경영지원팀장"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:update_employee_position · 웹 API PATCH /api/workers/:id {position, department, role} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_employee_position","args":{"worker":"박가상","position":"경영지원팀장"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/org-payroll.ts:update_employee_position · 웹 API PATCH /api/workers/:id {position, department, role} |
바뀐 직책 |
ORG-19 · 직원에게 겸직 부서를 더해요. AI 로 끝까지 돼요
/admin/enterprise/org-manage| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"add_concurrent_assignment","args":{"worker":"이가상","department":"영업2팀","position":"대리","assignment_type":"concurrent"}}} |
몸통 src/routes/mcp-tools/states.ts:add_concurrent_assignment · 함수 src/lib/concurrent-affiliation.ts:createConcurrentAffiliation | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"add_concurrent_assignment","args":{"worker":"이가상","department":"영업2팀","position":"대리","assignment_type":"concurrent"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/states.ts:add_concurrent_assignment · 함수 src/lib/concurrent-affiliation.ts:createConcurrentAffiliation | 겸직 부서 |
ORG-20 · 직원의 겸직을 끝내요. AI 로 끝까지 돼요
/admin/enterprise/org-manage| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_worker_assignments","args":{"worker":"오신입"}}} |
몸통 src/routes/mcp-tools/states.ts:query_worker_assignments | 소속 번호 · 부서 · 종류 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 |
| 2-미리보기 | 먼저 묻기: 「어느 겸직을 끝낼까요?」 {"name":"run_destructive","arguments":{"tool":"end_concurrent_assignment","args":{}}}1.assignments.1.assignment_id → assignment_id |
몸통 src/routes/mcp-tools/states.ts:end_concurrent_assignment | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"end_concurrent_assignment","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.assignments.1.assignment_id → assignment_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/states.ts:end_concurrent_assignment | 끝난 겸직 |
ORG-21 · 직원을 휴직 처리해요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"put_worker_on_leave","args":{"worker":"한신입","state":"parental_leave","from_date":"2026-11-01","to_date":"2027-10-31","note":"육아휴직"}}} |
몸통 src/routes/mcp-tools/states.ts:put_worker_on_leave | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"put_worker_on_leave","args":{"worker":"한신입","state":"parental_leave","from_date":"2026-11-01","to_date":"2027-10-31","note":"육아휴직"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/states.ts:put_worker_on_leave | 휴직 종류 · 시작일 |
ORG-22 · 휴직한 직원을 복직 처리해요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"return_worker_from_leave","args":{"worker":"한신입","return_date":"2026-10-21"}}} |
몸통 src/routes/mcp-tools/states.ts:return_worker_from_leave | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"return_worker_from_leave","args":{"worker":"한신입","return_date":"2026-10-21"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/states.ts:return_worker_from_leave | 복직일 |
ORG-23 · 지금 휴직 중인 직원을 봐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_workers_on_leave","args":{"state":"parental_leave"}}} |
몸통 src/routes/mcp-tools/states.ts:query_workers_on_leave | 이름 · 휴직 종류 · 복직 예정일 |
ORG-24 · 직원을 퇴사 처리해요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「마지막 근무일이 언제예요?」 {"name":"run_destructive","arguments":{"tool":"resign_process","args":{"worker":"오신입","last_day":"2026-12-31","reason":"개인 사정"}}} |
몸통 src/routes/mcp-tools/m4-resign.ts:resign_process · 함수 src/lib/worker-offboard.ts:offboardWorkerFromEnterprise · 웹 API DELETE /api/workers/:id {left_at} | 퇴사일 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ORG-25 · 잘못 만든 직원이나 중복 직원을 비활성화해요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_destructive","arguments":{"tool":"employee_deactivate_grant","args":{"action":"deactivate","worker":"한신입","reason":"중복 등록"}}} |
몸통 src/routes/mcp-tools/m4-resign.ts:employee_deactivate_grant · 함수 src/lib/people-roster-deactivate.ts:deactivateEmployee | 비활성화된 직원 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ORG-26 · 내 퇴직 신청을 올려요. AI 로 끝까지 돼요
/worker/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「마지막 근무일이 언제예요?」 {"name":"run_destructive","arguments":{"tool":"resign_request","args":{"last_day":"2026-12-31","reason":"개인 사정"}}} |
몸통 src/routes/mcp-tools/m4-resign.ts:resign_request | 신청 번호 · 마지막 근무일 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ORG-27 · 올린 퇴직 신청을 거둬요. AI 로 끝까지 돼요
/worker/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"resign_withdraw","args":{}}} |
몸통 src/routes/mcp-tools/m4-resign.ts:resign_withdraw | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"resign_withdraw","args":{},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/m4-resign.ts:resign_withdraw | 철회된 신청 |
ORG-28 · 회사를 찾아 가입을 신청해요. AI 로 끝까지 돼요
/worker/search| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 회사를 찾을까요?」 {"name":"run_read","arguments":{"tool":"search_company","args":{"query":"가상컴퍼니"}}} |
몸통 src/routes/mcp-tools/membership.ts:search_company · 함수 src/lib/public-enterprise-search.ts:searchPublicEnterprises · 웹 API GET /api/enterprises/search | 회사 이름 후보가 여럿이면(needs_choice) 「어느 회사에 신청할까요?」 → 고른 id 로 같은 줄을 다시 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"request_join_company","args":{"company":"가상컴퍼니","department":"개발부","position":"사원"}}} |
몸통 src/routes/mcp-tools/membership.ts:request_join_company | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"request_join_company","args":{"company":"가상컴퍼니","department":"개발부","position":"사원"},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/membership.ts:request_join_company | 신청 상태 |
ORG-29 · 직원의 입사일을 바꿔요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/people-roster호출 없음 — 화면에서 해요.
ORG-30 · 직원의 이름이나 연락처 오타를 고쳐요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/people-roster호출 없음 — 화면에서 해요.
급여·비용
PAY-01 · 영수증을 보고 경비를 올려요. AI 로 끝까지 돼요
/worker/expense| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"submit_expense","args":{"title":"10월 영업 경비","items":[{"amount":80000,"date":"2026-10-20","vendor":"한가상식당","description":"팀 회식","category":"식대","payment_method":"card_personal"}]}}} |
몸통 src/routes/mcp-tools/expense.ts:submitMcpExpense · 함수 src/lib/approval-expense-route.ts:createExpenseClaimWithAtomicApproval · 웹 API POST /api/worker/expense {amount, expense_date, description, payment_method, vendor} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"submit_expense","args":{"title":"10월 영업 경비","items":[{"amount":80000,"date":"2026-10-20","vendor":"한가상식당","description":"팀 회식","category":"식대","payment_method":"card_personal"}]},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/expense.ts:submitMcpExpense · 함수 src/lib/approval-expense-route.ts:createExpenseClaimWithAtomicApproval · 웹 API POST /api/worker/expense {amount, expense_date, description, payment_method, vendor} |
경비 번호 · 결재 상태 |
PAY-02 · 야근 시작 시각과 저녁 휴게를 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「연장 시작 시각이나 휴게 분을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_wage_policy","args":{"overtime_start_clock":"17:40","dinner_break_minutes":30,"reason":"소정근로 시각에 맞춰 정리"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_wage_policy · 함수 src/lib/audit.ts:logWageAudit · 웹 API PATCH /api/leave/policies/:eid {overtime_start_clock, dinner_break_minutes} |
바뀐 칸 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
PAY-03 · 법인카드 사용 내역을 봐요. AI 로 끝까지 돼요
/admin/enterprise/cards/usages| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_card_usages","args":{"limit":20}}} |
몸통 src/routes/mcp-tools/assets.ts:query_card_usages | 사용 건수 · 합계 |
PAY-04 · 내 급여명세서를 봐요. AI 로 끝까지 돼요
/worker/payslips| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"payslip_my","args":{"pay_period":"latest"}}} |
몸통 src/routes/mcp-tools/m4-certs.ts:payslipMy · 함수 src/lib/payslip-worker-visibility.ts:isWorkerVisiblePayslipStatus · 웹 API GET /api/workers/me/payslips | 급여월 · 실수령액 |
PAY-05 · 급여 정책이 누구에게 걸렸는지 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_wage_policy_groups","args":{}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:queryGroups · 함수 src/lib/wage-policy-write.ts:wagePolicyRowsPage · 웹 API GET /api/admin/payroll/wage-policy-groups | 정책 이름 · 정책 키 · 배정 번호 |
PAY-06 · 새 급여 정책을 만들어 직원 여럿에게 붙여요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_destructive","arguments":{"tool":"create_wage_policy_group","args":{"scope_type":"affiliation","scope_ref":"9714","name":"교대 근무 정책","overtime_rate":2}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:createGroup · 함수 src/lib/wage-policy-write.ts:writeWagePolicyGroup · 웹 API POST /api/admin/payroll/wage-policy-groups {scope_type, scope_ref, name, overtime_rate} |
정책 키 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
| 2 | 먼저 묻기: 「나머지 직원은 누구예요?」 {"name":"run_destructive","arguments":{"tool":"assign_person_policies","args":{"affiliation_ids":[9715,9716]}}}1.policy_key → policy_key |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:assignPeople · 함수 src/lib/wage-policy-write.ts:wagePolicyGroupStatements · 웹 API POST /api/admin/payroll/settings/people/:affiliationId/assign {policy_key, effective_from} |
배정 인원 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
PAY-07 · 급여명세서를 만들고 확정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/payroll호출 없음 — 화면에서 해요.
PAY-08 · 내 경비가 어디까지 처리됐는지 봐요. AI 로 끝까지 돼요
/worker/expense| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_expenses","args":{"status":"all","month":"2026-10"}}} |
몸통 src/routes/mcp-tools/expense.ts:query_my_expenses · 웹 API GET /api/worker/expense | 상태 · 합계 |
PAY-09 · 회사 법인카드 목록을 봐요. AI 로 끝까지 돼요
/admin/enterprise/cards| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_corporate_cards","args":{}}} |
몸통 src/routes/mcp-tools/assets.ts:query_corporate_cards · 웹 API GET /api/worker/corporate-cards | 카드 번호 · 카드 별칭 |
PAY-10 · 법인카드로 쓴 돈을 기록해요. AI 로 끝까지 돼요
/admin/enterprise/cards| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_corporate_cards","args":{}}} |
몸통 src/routes/mcp-tools/assets.ts:query_corporate_cards · 웹 API GET /api/worker/corporate-cards | 카드 번호 |
| 2-미리보기 | 먼저 묻기: 「어느 카드로 쓰셨어요?」 {"name":"run_destructive","arguments":{"tool":"log_card_usage","args":{"amount":12000,"merchant_name":"한가상커피","used_at":"2026-10-20","category":"식대"}}}1.cards.0.card_id → card_id |
몸통 src/routes/mcp-tools/assets.ts:log_card_usage · 웹 API POST /api/worker/card-usage {card_id, amount, merchant_name, used_at, category, description} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"log_card_usage","args":{"amount":12000,"merchant_name":"한가상커피","used_at":"2026-10-20","category":"식대"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.cards.0.card_id → card_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/assets.ts:log_card_usage · 웹 API POST /api/worker/card-usage {card_id, amount, merchant_name, used_at, category, description} |
사용 기록 번호 |
PAY-11 · 회사 연장·야간 수당 총액을 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll-overtime| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_overtime_cost","args":{"start_date":"2026-10-01","end_date":"2026-10-21","hourly_rate":12000}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_company_overtime_cost | 연장 시간 · 추정 수당 |
PAY-12 · 올라온 경비를 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-inbox호출 없음 — 화면에서 해요.
PAY-13 · 법인카드를 새로 등록해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/cards호출 없음 — 화면에서 해요.
PAY-14 · 부서에 급여 정책을 새로 붙여요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 부서에 붙일까요?」 {"name":"run_destructive","arguments":{"tool":"create_wage_policy_group","args":{"scope_type":"department","scope_ref":"9613","name":"영업1팀 정책","overtime_rate":2}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:createGroup · 함수 src/lib/wage-policy-write.ts:writeWagePolicyGroup · 웹 API POST /api/admin/payroll/wage-policy-groups {scope_type, scope_ref, name, overtime_rate} |
정책 키 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
PAY-15 · 이번 달 급여명세서 현황을 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_payslips","args":{"pay_period":"2026-09","status":"all"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_payslips · 웹 API GET /api/admin/payslips | 명세서 건수 · 상태 |
PAY-16 · 한 직원의 월급을 미리 계산해 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구 급여를 볼까요?」 {"name":"run_read","arguments":{"tool":"estimate_pay","args":{"worker":"김가상","month":"2026-09"}}} |
몸통 src/routes/mcp-tools/payroll-calc.ts:estimate_pay · 함수 src/lib/payroll-estimate-canonical.ts:estimateWorkerPayFromLedger | 추정 실수령액 · 확인할 점 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 |
PAY-17 · 급여대장을 파일로 받아요. AI 로 끝까지 돼요
/admin/enterprise/payroll| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"export_payroll_csv","args":{"pay_period":"2026-09"}}} |
몸통 src/routes/mcp-tools/export.ts:export_payroll_csv · 웹 API GET /api/admin/payroll-export/:token | 내려받기 주소 · 만료 시각 |
PAY-18 · 임금대장을 뽑아요. AI 로 끝까지 돼요
/admin/enterprise/insurance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"generate_wage_ledger","args":{"month":"2026-09"}}} |
몸통 src/routes/mcp-tools/insurance.ts:generate_wage_ledger | 직원별 실수령액 |
PAY-19 · 회사 인건비 합계를 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_payroll_total","args":{"pay_period":"2026-09"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_company_payroll_total | 세전 총액 · 실지급 총액 |
PAY-20 · 급여 정책을 누가 바꿨는지 봐요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_wage_policy_history","args":{"limit":50}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:queryHistory · 함수 src/lib/wage-policy-write.ts:wagePolicyRowsPage · 웹 API GET /api/admin/payroll/wage-policy-groups/history | 바꾼 사람 · 바뀐 시각 |
PAY-21 · 근무 규칙과 안 맞는 급여 정책을 찾아요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_payroll_people_alignment","args":{"only_mismatch":true,"limit":50}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:queryAlignment · 함수 src/lib/payroll-person-settings.ts:loadPayrollPersonSettings · 웹 API GET /api/admin/payroll/settings/people | 안 맞는 직원 · 소속 번호 |
PAY-22 · 급여 정책의 값을 다음 달부터 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/payroll-terms| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_wage_policy_groups","args":{}}} |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:queryGroups · 함수 src/lib/wage-policy-write.ts:wagePolicyRowsPage · 웹 API GET /api/admin/payroll/wage-policy-groups | 정책 키 |
| 2 | 먼저 묻기: 「어느 정책을 바꿀까요?」 {"name":"run_destructive","arguments":{"tool":"new_wage_policy_version","args":{"overtime_rate":2.5,"effective_from":"2026-12-01"}}}1.policies.0.policy_key → policy_key |
몸통 src/routes/mcp-tools/m5b-wage-policy.ts:newVersion · 함수 src/lib/wage-policy-write.ts:writeWagePolicyVersion · 웹 API POST /api/admin/payroll/wage-policy-groups/policies/:policyKey/versions {overtime_rate, effective_from} |
적용일 · 영향 인원 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
PAY-23 · 이번 달 경비 합계를 항목별로 봐요. AI 로 끝까지 돼요
/admin/enterprise/expense/confirm| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_expense_summary","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_expense_summary | 월 합계 · 항목별 합계 |
PAY-24 · 기간 안에 올라온 경비 총액을 봐요. AI 로 끝까지 돼요
/admin/enterprise/expense/confirm| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_expense_total","args":{"start_date":"2026-10-01","end_date":"2026-10-21"}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_company_expense_total | 청구 건수 · 총액 |
PAY-25 · 4대보험 가입 현황을 봐요. AI 로 끝까지 돼요
/admin/enterprise/insurance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_insurance_status","args":{}}} |
몸통 src/routes/mcp-tools/insurance.ts:query_insurance_status | 미가입 직원 |
PAY-26 · 빈소나 예식장에 회사 화환을 보내요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/shop/new/wreath호출 없음 — 화면에서 해요.
PAY-27 · 직원 명함을 주문해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/shop/new/business-card호출 없음 — 화면에서 해요.
일정·근무표
SCH-01 · 돌아가며 근무하는 한 달 교대표를 한 번에 짜요. AI 로 끝까지 돼요
/worker/schedule/setup/shifts| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_templates","args":{}}} |
몸통 src/routes/mcp-tools/shift.ts:query_shift_templates · 함수 src/lib/shift-roster-palette.ts:templatePaletteFromRow | 근무조 이름 |
| 2-미리보기 | 먼저 묻기: 「누구에게 어떤 순서로 몇 일치를 짤까요?」 {"name":"run_destructive","arguments":{"tool":"generate_rotation","args":{"workers":["이가상","박가상"],"pattern":["주간","야간","휴무"],"from_date":"2026-11-02","days":28}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:generate_rotation · 함수 src/lib/shift-write-gate.ts:assertShiftWriteRules | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구를 넣을까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"generate_rotation","args":{"workers":["이가상","박가상"],"pattern":["주간","야간","휴무"],"from_date":"2026-11-02","days":28},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift-ops.ts:generate_rotation · 함수 src/lib/shift-write-gate.ts:assertShiftWriteRules | 만든 칸 수 |
SCH-02 · 우리 부서를 교대조 근무로 바꿔요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule/setup/work-mode호출 없음 — 화면에서 해요.
SCH-03 · 우리 팀 근무 일정을 기간별로 봐요. AI 로 끝까지 돼요
/worker/team/schedule| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_team_shifts","args":{"from_date":"2026-10-21","days":7}}} |
몸통 src/routes/mcp-tools/shift.ts:query_team_shifts · 함수 src/lib/mcp-team-scope.ts:resolveMcpTeamScope | 날짜 · 직원 · 근무조 · 시간 |
SCH-04 · 새 근무조(주간 · 야간 틀)를 만들어요. AI 로 끝까지 돼요
/worker/schedule/setup/shifts| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「조 이름과 시작 · 종료 시각을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"create_shift_template","args":{"name":"야간조","start_time":"22:00","end_time":"07:00","break_minutes":60,"end_day_offset":1}}} |
몸통 src/routes/mcp-tools/shift.ts:create_shift_template · 함수 src/lib/shift-roster.ts:legacyTemplateBreakColumns · 웹 API POST /api/admin/shift-templates {name, start_time, end_time, break_minutes} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"create_shift_template","args":{"name":"야간조","start_time":"22:00","end_time":"07:00","break_minutes":60,"end_day_offset":1},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift.ts:create_shift_template · 함수 src/lib/shift-roster.ts:legacyTemplateBreakColumns · 웹 API POST /api/admin/shift-templates {name, start_time, end_time, break_minutes} |
근무조 번호 |
SCH-05 · 다음 주 근무표 초안을 화면에서 짜요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule/setup/shifts호출 없음 — 화면에서 해요.
SCH-06 · 내 근무 일정을 봐요. AI 로 끝까지 돼요
/worker/schedule| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_schedule","args":{"from_date":"2026-10-21","days":7}}} |
몸통 src/routes/mcp-tools/ops.ts:query_my_schedule · 웹 API GET /api/workers/me/shifts | 날짜 · 시작 · 끝 · 상태 |
SCH-07 · 직원 한 명의 하루 근무를 배정해요. AI 로 끝까지 돼요
/worker/schedule/setup/shifts| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_templates","args":{}}} |
몸통 src/routes/mcp-tools/shift.ts:query_shift_templates · 함수 src/lib/shift-roster-palette.ts:templatePaletteFromRow | 근무조 번호 · 근무조 이름 |
| 2-미리보기 | 먼저 묻기: 「누구를 며칠에 어느 근무조로 넣을까요?」 {"name":"run_destructive","arguments":{"tool":"assign_shift","args":{"worker":"이가상","work_date":"2026-10-22"}}}1.templates.0.template_id → shift_template_id |
몸통 src/routes/mcp-tools/shift.ts:assign_shift · 함수 src/lib/shift-write-gate.ts:assertShiftWriteRules · 웹 API POST /api/admin/shift-assignments {worker_id, work_date, shift_template_id} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구를 배정할까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"assign_shift","args":{"worker":"이가상","work_date":"2026-10-22"},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.templates.0.template_id → shift_template_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift.ts:assign_shift · 함수 src/lib/shift-write-gate.ts:assertShiftWriteRules · 웹 API POST /api/admin/shift-assignments {worker_id, work_date, shift_template_id} |
배정 결과 |
SCH-08 · 다 짠 근무표를 확정해 직원에게 보여 줘요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule/setup/shifts호출 없음 — 화면에서 해요.
SCH-09 · 쉬고 싶은 날(희망 휴무)을 내요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule호출 없음 — 화면에서 해요.
SCH-10 · 근무표 가안에 동의하거나 안 되는 날을 알려요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule호출 없음 — 화면에서 해요.
SCH-11 · 시간대별 최소 근무 인원을 정해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule/setup/shifts호출 없음 — 화면에서 해요.
SCH-12 · 부서장이나 점장에게 근무표 짜기를 맡겨요. 아직 AI 로 안 돼요 · 대신 화면
/worker/schedule/setup/one-off호출 없음 — 화면에서 해요.
SCH-13 · 동료와 근무 날짜를 서로 바꾸자고 신청해요. AI 로 끝까지 돼요
/worker/shift-swap| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「내 근무일 · 상대 · 상대 근무일을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"request_shift_swap","args":{"my_date":"2026-10-28","target_worker":"한신입","target_date":"2026-10-30","reason":"병원 진료"}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:request_shift_swap · 함수 src/lib/shift-swap-roster.ts:createShiftSwapRequest · 웹 API POST /api/worker/shift-swap {my_date, target_worker_id, target_date, reason} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구와 바꿀까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"request_shift_swap","args":{"my_date":"2026-10-28","target_worker":"한신입","target_date":"2026-10-30","reason":"병원 진료"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift-ops.ts:request_shift_swap · 함수 src/lib/shift-swap-roster.ts:createShiftSwapRequest · 웹 API POST /api/worker/shift-swap {my_date, target_worker_id, target_date, reason} |
교환 신청 번호 |
SCH-14 · 내 근무 교환 신청이 어떻게 됐는지 봐요. AI 로 끝까지 돼요
/worker/shift-swap| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_swaps","args":{"status":"pending"}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:query_shift_swaps · 웹 API GET /api/worker/shift-swap | 신청자 · 상대 · 근무일 · 상태 |
SCH-15 · 팀원이 낸 근무 교환 신청을 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/team/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_swaps","args":{"status":"pending"}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:query_shift_swaps · 웹 API GET /api/worker/shift-swap | 신청자 · 상대 · 근무일 |
SCH-16 · 우리 회사 근무조와 시간대를 봐요. AI 로 끝까지 돼요
/worker/schedule| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_shift_templates","args":{}}} |
몸통 src/routes/mcp-tools/shift.ts:query_shift_templates · 함수 src/lib/shift-roster-palette.ts:templatePaletteFromRow | 근무조 이름 · 시간 · 휴게 |
SCH-17 · 회의실이나 차량을 예약해요. AI 로 끝까지 돼요
/worker/reservation| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_resources","args":{"resource_type":"room"}}} |
몸통 src/routes/mcp-tools/resource.ts:query_resources | 자원 이름 · 수용 인원 |
| 2-미리보기 | 먼저 묻기: 「어느 자원을 몇 시부터 몇 시까지 잡을까요?」 {"name":"run_destructive","arguments":{"tool":"create_resource_reservation","args":{"resource":"회의실 B","start_at":"2026-10-22T14:00","end_at":"2026-10-22T15:00","purpose":"주간 회의","participant_count":6}}} |
몸통 src/routes/mcp-tools/resource.ts:create_resource_reservation · 웹 API POST /api/reservations {resource_id, start_at, end_at, purpose, participant_count} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"create_resource_reservation","args":{"resource":"회의실 B","start_at":"2026-10-22T14:00","end_at":"2026-10-22T15:00","purpose":"주간 회의","participant_count":6},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/resource.ts:create_resource_reservation · 웹 API POST /api/reservations {resource_id, start_at, end_at, purpose, participant_count} |
예약 번호 · 상태 |
SCH-18 · 내가 잡은 예약을 봐요. AI 로 끝까지 돼요
/worker/reservation/my| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_reservations","args":{}}} |
몸통 src/routes/mcp-tools/resource.ts:query_my_reservations · 웹 API GET /api/reservations/my | 예약 번호 · 자원 이름 · 시간 · 상태 |
SCH-19 · 내가 잡은 예약을 취소해요. AI 로 끝까지 돼요
/worker/reservation/my| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「어느 예약을 취소할까요?」 {"name":"run_read","arguments":{"tool":"query_my_reservations","args":{}}} |
몸통 src/routes/mcp-tools/resource.ts:query_my_reservations · 웹 API GET /api/reservations/my | 예약 번호 · 자원 이름 · 시간 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"cancel_reservation","args":{}}}1.reservations.0.reservation_id → reservation_id |
몸통 src/routes/mcp-tools/resource.ts:cancel_reservation · 웹 API DELETE /api/reservations/:id | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"cancel_reservation","args":{},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.reservations.0.reservation_id → reservation_id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/resource.ts:cancel_reservation · 웹 API DELETE /api/reservations/:id | 취소 결과 |
SCH-20 · 캘린더에 일정을 만들고 한눈에 봐요. 아직 AI 로 안 돼요 · 대신 화면
/worker/calendar호출 없음 — 화면에서 해요.
회사 설정
SET-01 · 우리 회사 정보를 한눈에 봐요. AI 로 끝까지 돼요
/admin/enterprise/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_info","args":{}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:query_company_info | 회사 이름 · 대표자 · 근무 정책 · 휴가 정책 |
SET-02 · 회사 이름을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「바꿀 회사 이름이 뭐예요?」 {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"name":"가상상사"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"name":"가상상사"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | — |
SET-03 · 회사 전화번호와 주소를 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「새 전화번호와 주소를 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"phone":"02-0000-0000","address":"서울시 가상구 가상로 1"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"phone":"02-0000-0000","address":"서울시 가상구 가상로 1"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | — |
SET-04 · 회사 담당자 연락처를 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「담당자 이름과 연락처를 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"manager_name":"김가상","manager_contact":"010-0000-0000","manager_email":"manager@example.com"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"manager_name":"김가상","manager_contact":"010-0000-0000","manager_email":"manager@example.com"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | — |
SET-06 · 기본 연차 일수와 상한을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「기본 일수와 상한을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"base_annual_days":15,"extra_per_2years":1,"max_annual_days":25}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"base_annual_days":15,"extra_per_2years":1,"max_annual_days":25},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | — |
SET-07 · 반차와 무급 휴가를 쓰게 켜요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"half_day_supported":true,"allow_unpaid":true,"allow_sick_leave":true,"allow_family_event":true}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"half_day_supported":true,"allow_unpaid":true,"allow_sick_leave":true,"allow_family_event":true},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | — |
SET-08 · 쓰고 남은 연차를 넘기는 방법을 정해요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「소멸, 수당, 다음 해 중 어느 쪽이에요?」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"carryover_method":"next_year"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"carryover_method":"next_year"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | — |
SET-09 · 연차 계산 기준을 정해요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「회계연도와 입사일 중 어느 쪽이에요?」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"accrual_basis":"hire_date"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"accrual_basis":"hire_date"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | — |
SET-10 · GPS 위치 확인을 끄거나 낮춰요. AI 로 끝까지 돼요
/admin/enterprise/attendance-methods| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「엄격, 느슨, 끔 중 어느 쪽이에요?」 {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"gps_mode":"off"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"gps_mode":"off"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | — |
SET-11 · 출근 가능한 반경을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「반경을 몇 미터로 할까요?」 {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"office_radius_m":150}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"office_radius_m":150},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | — |
SET-12 · 사무실 와이파이 이름을 등록해요. AI 로 끝까지 돼요
/admin/enterprise/attendance-methods| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「사무실 와이파이 이름을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"wifi_ssids":["가상사무실-5G"]}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"wifi_ssids":["가상사무실-5G"]},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | — |
SET-13 · 바깥 근무 출퇴근을 쓰게 켜요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"field_work_enabled":true}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"update_attendance_policy","args":{"field_work_enabled":true},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_attendance_policy | — |
SET-14 · 우리 회사 일하는 곳 목록을 봐요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_worksites","args":{}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:query_worksites | 일하는 곳 이름 · 반경 |
SET-15 · 새 일하는 곳을 추가해요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「이름과 주소를 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"create_worksite","args":{"name":"가상 부산지점","site_type":"branch","address":"부산시 가상구 가상로 2","radius_m":100}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:create_worksite | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"create_worksite","args":{"name":"가상 부산지점","site_type":"branch","address":"부산시 가상구 가상로 2","radius_m":100},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/orgmodel.ts:create_worksite | — |
SET-16 · 일하는 곳의 반경을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_worksites","args":{}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:query_worksites | 일하는 곳 번호 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"radius_m":120}}}1.worksites.0.worksite_id → worksite |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | confirmation_id 후보가 여럿이면(needs_choice) 「어느 일하는 곳이에요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"radius_m":120},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.worksites.0.worksite_id → worksite · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | — |
SET-17 · 문 닫은 일하는 곳을 비활성으로 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_worksites","args":{}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:query_worksites | 일하는 곳 번호 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"active":false}}}1.worksites.0.worksite_id → worksite |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | confirmation_id 후보가 여럿이면(needs_choice) 「어느 일하는 곳을 닫을까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"active":false},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.worksites.0.worksite_id → worksite · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | — |
SET-18 · 연장근무 시작 시각과 저녁 휴게를 정해요. AI 로 끝까지 돼요
/admin/enterprise/attendance-policies| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「시작 시각과 저녁 휴게 분을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"update_wage_policy","args":{"overtime_start_clock":"18:00","dinner_break_minutes":30}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_wage_policy | — 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
SET-19 · 결재하는 사람 묶음을 봐요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_approval_lines","args":{}}} |
몸통 src/routes/mcp-tools/approvals.ts:query_approval_lines | 결재 종류 · 결재하는 사람 |
SET-20 · 결재하는 사람을 넣거나 빼요. AI 로 끝까지 돼요
/admin/enterprise/approval-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구를 어느 결재에 넣을까요?」 {"name":"run_destructive","arguments":{"tool":"set_approval_line","args":{"action":"add","item_type":"leave","worker":"김가상"}}} |
몸통 src/routes/mcp-tools/approval-roster-tool.ts:set_approval_line | — 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 · 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
SET-21 · 회사 기능을 켜거나 꺼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/settings/modules호출 없음 — 화면에서 해요.
SET-22 · 연차 신청서의 사유 칸을 빼요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/hr/leave-policy호출 없음 — 화면에서 해요.
SET-23 · 출퇴근을 NFC 로만 되게 정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/attendance-methods호출 없음 — 화면에서 해요.
SET-24 · 출근·퇴근 시각표를 바꿔요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/attendance-policies호출 없음 — 화면에서 해요.
SET-25 · 휴가 결재 방식을 정해요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-rules호출 없음 — 화면에서 해요.
관리자 확인
ADM-01 · 직원이 어떤 관리 권한을 가졌는지 봐요. AI 로 끝까지 돼요
/admin/enterprise/sub-admins| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구 권한을 볼까요?」 {"name":"run_read","arguments":{"tool":"query_hr_permissions","args":{"worker":"이가상"}}} |
몸통 src/routes/mcp-tools/policies.ts:query_hr_permissions · 웹 API GET /api/enterprises/:eid/hr-permissions | 켜진 권한 · 꺼진 권한 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 |
ADM-02 · 직원에게 관리 권한을 줘요. AI 로 끝까지 돼요
/admin/enterprise/sub-admins| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구에게 어떤 권한을 줄까요?」 {"name":"run_destructive","arguments":{"tool":"set_hr_permission","args":{"worker":"이가상","permission":"view_dept","enabled":true}}} |
몸통 src/routes/mcp-tools/hr-permissions.ts:set_hr_permission | 바뀐 권한 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ADM-03 · 우리 회사에 연결된 AI 앱을 봐요. AI 로 끝까지 돼요
/admin/enterprise/ai-integrations| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"audit_connected_ai","args":{"what":"connections"}}} |
몸통 src/routes/mcp-tools/audit-connected-ai.ts:auditConnectedAi · 함수 src/lib/mcp-oauth-connected-ai.ts:readConnectedAiPage | 연결한 사람 · 연결한 앱 · 마지막 사용 |
ADM-04 · AI 가 어떤 일을 했는지 기록을 봐요. AI 로 끝까지 돼요
/admin/enterprise/ai-integrations| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"audit_connected_ai","args":{"what":"runs"}}} |
몸통 src/routes/mcp-tools/audit-connected-ai.ts:auditConnectedAi · 함수 src/lib/mcp-oauth-connected-ai.ts:readConnectedAiPage | 한 일 · 시각 · 결과 |
ADM-05 · 한 직원의 AI 연결을 켜고 꺼요. AI 로 끝까지 돼요
/admin/enterprise/mcp-permissions| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구의 AI 연결을 바꿀까요?」 {"name":"run_destructive","arguments":{"tool":"toggle_mcp_enabled","args":{"worker":"한신입","enabled":false}}} |
몸통 src/routes/mcp-tools/hr-permissions.ts:toggle_mcp_enabled | 바뀐 상태 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ADM-06 · 직원의 AI 사용 등급을 정해요. AI 로 끝까지 돼요
/admin/enterprise/mcp-permissions| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「누구를 어느 등급으로 할까요?」 {"name":"run_destructive","arguments":{"tool":"grant_mcp_role","args":{"worker":"이가상","role":"hr_manager"}}} |
몸통 src/routes/mcp-tools/hr-permissions.ts:grant_mcp_role | 바뀐 등급 앱에서 사람이 승인한 뒤 같은 인자로 다시 불러요 |
ADM-07 · 근태가 이상한 직원을 찾아봐요. AI 로 끝까지 돼요
/admin/enterprise/attendance-policies| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_anomaly","args":{"limit":20}}} |
몸통 src/routes/mcp-tools/insights.ts:query_attendance_anomaly | 이상 징후 직원 · 이유 |
ADM-08 · 부서별 인원을 봐요. AI 로 끝까지 돼요
/admin/enterprise| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_headcount_by_department","args":{}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_headcount_by_department | 부서 · 인원 |
ADM-09 · 오늘 아침 브리핑을 받아요. AI 로 끝까지 돼요
/admin/enterprise| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"daily_briefing","args":{}}} |
몸통 src/routes/mcp-tools/insights.ts:daily_briefing | 오늘 출근 · 승인 대기 |
ADM-10 · 오늘 출근율을 봐요. AI 로 끝까지 돼요
/admin/enterprise| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_rate_today","args":{}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_attendance_rate_today | 출근율 · 출근 인원 |
ADM-11 · 켜 둔 알림 규칙을 봐요. AI 로 끝까지 돼요
/admin/enterprise/alert-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_alert_rules","args":{}}} |
몸통 src/routes/mcp-tools/alerts.ts:query_alert_rules | 규칙 종류 · 기준값 |
ADM-12 · 주 52시간 위험 알림 규칙을 만들어요. AI 로 끝까지 돼요
/admin/enterprise/alert-rules| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「몇 시간부터 알려 드릴까요?」 {"name":"run_destructive","arguments":{"tool":"register_alert_rule","args":{"rule_type":"weekly_52h_risk","threshold_value":48,"description":"주 48시간을 넘으면 알려 줘요."}}} |
몸통 src/routes/mcp-tools/alerts.ts:register_alert_rule | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"register_alert_rule","args":{"rule_type":"weekly_52h_risk","threshold_value":48,"description":"주 48시간을 넘으면 알려 줘요."},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/alerts.ts:register_alert_rule | 규칙 번호 |
ADM-13 · 외부 노무사에게 열어 둔 접근을 봐요. AI 로 끝까지 돼요
/admin/enterprise/advisors| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"list_advisor_access","args":{"include_revoked":false}}} |
몸통 src/routes/mcp-tools/advisor.ts:list_advisor_access | 접근 대상 · 열어 준 날 |
ADM-14 · 연결된 AI 앱을 끊어요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/ai-integrations호출 없음 — 화면에서 해요.
ADM-15 · AI 가 올린 승인 요청을 앱에서 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/mcp-approvals호출 없음 — 화면에서 해요.
ADM-16 · AI 연결 감사 기록을 파일로 받아요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/ai-integrations/audit.csv호출 없음 — 화면에서 해요.
ADM-17 · 결재 진행 현황을 한눈에 봐요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/approval-status호출 없음 — 화면에서 해요.
ADM-18 · 근무 규칙이 언제 바뀌었는지 봐요. 아직 AI 로 안 돼요 · 대신 화면
/admin/enterprise/attendance-policies호출 없음 — 화면에서 해요.
ADM-19 · 이번 달 새로 들어온 직원을 봐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「몇 월 입사자를 볼까요?」 {"name":"run_read","arguments":{"tool":"query_new_hires","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_new_hires | 이름 · 입사일 · 부서 |
ADM-20 · 이번 달 그만둔 직원을 봐요. AI 로 끝까지 돼요
/admin/enterprise/people-roster| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「몇 월 퇴사자를 볼까요?」 {"name":"run_read","arguments":{"tool":"query_recent_resignations","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/org-payroll.ts:query_recent_resignations | 이름 · 퇴사일 · 부서 |
ADM-21 · 곧 끝나는 근로계약을 봐요. AI 로 끝까지 돼요
/admin/enterprise/contracts| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | 먼저 묻기: 「며칠 안에 끝나는 계약을 볼까요?」 {"name":"run_read","arguments":{"tool":"query_expiring_contracts","args":{"within_days":30}}} |
몸통 src/routes/mcp-tools/recruit-contract.ts:query_expiring_contracts | 이름 · 계약 끝나는 날 |
ADM-22 · 발급을 기다리는 증명서를 봐요. AI 로 끝까지 돼요
/admin/enterprise/certificate| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_pending_certificates","args":{}}} |
몸통 src/routes/mcp-tools/ops.ts:query_pending_certificates | 신청 번호 · 증명서 종류 · 신청한 사람 |
여러 단계
MULTI-01 · 내가 누구인지 보고 오늘 할 일을 봐요. AI 로 끝까지 돼요
/worker| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"whoami","arguments":{}} |
몸통 src/routes/mcp-tools/base-whoami.ts:whoami | 이름 · 역할 |
| 2 | {"name":"today","arguments":{"kind":"all"}} |
몸통 src/routes/mcp-tools/today-core.ts:today | 오늘 볼 것 |
MULTI-02 · 필요한 도구를 찾고 남은 연차를 읽어요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"find_tools","arguments":{"query":"남은 연차","kind":"read","limit":3}} |
몸통 src/routes/mcp-base-run.ts:findTools | 도구 이름 |
| 2 | {"name":"run_read","arguments":{"tool":"query_my_leave_balance","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leave_balance | 남은 일수 |
MULTI-03 · 휴가 신청 기능을 찾고 반차를 올려요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"find_tools","arguments":{"query":"휴가 신청","kind":"write","limit":3}} |
몸통 src/routes/mcp-base-run.ts:findTools | 도구 이름 |
| 2-미리보기 | 먼저 묻기: 「며칠에 반차를 쓸까요?」 {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-10-27","leave_type":"half_morning","reason":"개인 일정"}}} |
몸통 src/routes/mcp-tool-handlers.ts:request_leave | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-10-27","leave_type":"half_morning","reason":"개인 일정"},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:request_leave | — |
MULTI-04 · 직원을 찾고 그 사람 정보를 봐요. AI 로 끝까지 돼요
/admin/enterprise/employees| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"search","arguments":{"query":"김가상","kind":"people"}} |
몸통 src/routes/mcp-tools/base-search.ts:search | 사람 번호 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 |
| 2 | {"name":"run_read","arguments":{"tool":"query_employee_profile","args":{}}}1.items.0.id → worker |
몸통 src/routes/mcp-tools/org-payroll.ts:query_employee_profile | — |
MULTI-05 · 직원을 찾고 그 사람의 남은 연차를 봐요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-ledger| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"search","arguments":{"query":"이가상","kind":"people"}} |
몸통 src/routes/mcp-tools/base-search.ts:search | 사람 번호 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 |
| 2 | {"name":"run_read","arguments":{"tool":"query_leave_balance","args":{"year":2026}}}1.items.0.id → worker |
몸통 src/routes/mcp-tools/leave.ts:query_leave_balance | 남은 일수 |
MULTI-06 · 남은 연차를 보고 확인한 뒤 휴가를 올려요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leave_balance","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leave_balance | 남은 일수 |
| 2 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"leave"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 |
| 3-미리보기 | 먼저 묻기: 「며칠에 쉴까요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-26","reason":"개인 사정"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | confirmation_id 후보가 여럿이면(needs_choice) 「결재를 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 3-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-26","reason":"개인 사정","confirmation_id":"<3-미리보기.confirmation_id>"}}3-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | 결재 번호 |
MULTI-07 · 업무를 보내고 댓글을 달아 확인해요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「누구에게 언제까지 시킬까요?」 {"name":"task_create","arguments":{"title":"10월 정산 자료 확인","to":["이가상"],"due":"2026-10-28"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구예요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"task_create","arguments":{"title":"10월 정산 자료 확인","to":["이가상"],"due":"2026-10-28","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | 업무 번호 |
| 2-미리보기 | {"name":"task_comment","arguments":{"body":"금요일까지 올려 주세요."}}1.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_comment | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_comment","arguments":{"body":"금요일까지 올려 주세요.","confirmation_id":"<2-미리보기.confirmation_id>"}}1.id → id · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_comment | — |
| 3 | {"name":"task_get","arguments":{}}1.id → id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_get | 기한 · 댓글 수 |
MULTI-08 · 올린 결재가 지금 어디까지 갔는지 봐요. AI 로 끝까지 돼요
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「며칠에 쉴까요?」 {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-29","reason":"병원 진료"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | confirmation_id 후보가 여럿이면(needs_choice) 「결재를 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"approval_request","arguments":{"type":"leave","start_date":"2026-10-29","reason":"병원 진료","confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | 결재 번호 |
| 2 | {"name":"approval_list","arguments":{"box":"mine"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList | 결재 번호 · 종류 |
| 3 | {"name":"run_read","arguments":{"tool":"approval_get","args":{}}}2.items.0.id → id · 2.items.0.type → type |
몸통 src/routes/mcp-tools/approval-read.ts:approvalGet | 진행 상태 · 결재선 |
MULTI-09 · 일하는 곳 번호를 찾아 반경을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/office-location| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_worksites","args":{}}} |
몸통 src/routes/mcp-tools/orgmodel.ts:query_worksites | 일하는 곳 번호 |
| 2-미리보기 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"radius_m":150}}}1.worksites.0.worksite_id → worksite |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | confirmation_id 후보가 여럿이면(needs_choice) 「어느 일하는 곳이에요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_worksite","args":{"radius_m":150},"confirmation_id":"<2-미리보기.confirmation_id>"}}1.worksites.0.worksite_id → worksite · 2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/orgmodel.ts:update_worksite | — |
MULTI-10 · 회사 정보를 보고 전화번호를 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/profile| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_company_info","args":{}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:query_company_info | 지금 전화번호 |
| 2-미리보기 | 먼저 묻기: 「새 전화번호가 뭐예요?」 {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"phone":"02-1111-0000"}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_company_info","args":{"phone":"02-1111-0000"},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_company_info | — |
MULTI-11 · 휴가 규칙을 보고 신청 기한을 바꿔요. AI 로 끝까지 돼요
/admin/enterprise/hr/leave-policy| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_leave_policy","args":{}}} |
몸통 src/routes/mcp-tools/policies.ts:query_leave_policy | 지금 규칙 |
| 2-미리보기 | 먼저 묻기: 「며칠 전까지 신청받을까요?」 {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"min_days_advance":2}}} |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"update_leave_policy","args":{"min_days_advance":2},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/enterprise-settings.ts:update_leave_policy | — |
MULTI-12 · 내 역할을 보고 맞는 안내서를 읽어요. AI 로 끝까지 돼요
/worker| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"whoami","arguments":{}} |
몸통 src/routes/mcp-tools/base-whoami.ts:whoami | 역할 · 쓸 수 있는 도구 수 |
| 2 | {"name":"guide","arguments":{"topic":"leave"}} |
몸통 src/routes/mcp-tools/base-guide.ts:guide | 휴가 안내 |
MULTI-13 · 오늘 할 일을 보고 이번 주 출퇴근을 봐요. AI 로 끝까지 돼요
/worker| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"today","arguments":{"kind":"all"}} |
몸통 src/routes/mcp-tools/today-core.ts:today | 오늘 볼 것 |
| 2 | {"name":"run_read","arguments":{"tool":"query_my_attendance","args":{"days":7}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_my_attendance | 출퇴근 기록 |
MULTI-14 · 휴가를 올리고 바로 취소해요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「며칠 휴가였나요?」 {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-11-02","leave_type":"annual","reason":"개인 일정"}}} |
몸통 src/routes/mcp-tool-handlers.ts:request_leave | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"request_leave","args":{"start_date":"2026-11-02","leave_type":"annual","reason":"개인 일정"},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tool-handlers.ts:request_leave | — |
| 2 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"status":"pending","year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves | 휴가 번호 |
| 3-미리보기 | {"name":"run_destructive","arguments":{"tool":"cancel_leave_request","args":{}}}2.leaves.0.leave_id → leave_id |
몸통 src/routes/mcp-tools/leave.ts:cancel_leave_request | confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 3-확정 | {"name":"run_destructive","arguments":{"tool":"cancel_leave_request","args":{},"confirmation_id":"<3-미리보기.confirmation_id>"}}2.leaves.0.leave_id → leave_id · 3-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/leave.ts:cancel_leave_request | — |
MULTI-15 · 출퇴근 기록을 보고 정정 결재를 올려요. AI 로 끝까지 돼요
/worker/attendance-correction| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_attendance","args":{"days":7}}} |
몸통 src/routes/mcp-tool-handlers.ts:query_my_attendance | 빠진 날 |
| 2 | {"name":"run_read","arguments":{"tool":"approval_preview","args":{"type":"attendance_fix"}}} |
몸통 src/routes/mcp-tools/approval-request.ts:engineLine | 결재자 이름 |
| 3-미리보기 | 먼저 묻기: 「며칠 몇 시로 고칠까요?」 {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"19:10","reason":"퇴근 시각이 잘못 찍힘"}} |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | confirmation_id 후보가 여럿이면(needs_choice) 「결재를 누구에게 올릴까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 3-확정 | {"name":"approval_request","arguments":{"type":"attendance_fix","day":"2026-10-20","checkout_time":"19:10","reason":"퇴근 시각이 잘못 찍힘","confirmation_id":"<3-미리보기.confirmation_id>"}}3-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/approval-request.ts:buildPlan | 결재 번호 |
MULTI-16 · 오늘 출근 현황과 휴가자를 함께 봐요. AI 로 끝까지 돼요
/admin/enterprise/attendance| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_today","args":{}}} |
몸통 src/routes/mcp-legacy-specs.ts:query_attendance_today | 출근한 사람 · 아직 안 온 사람 |
| 2 | {"name":"run_read","arguments":{"tool":"query_leaves_on_date","args":{"date":"2026-10-21"}}} |
몸통 src/routes/mcp-tools/leave.ts:query_leaves_on_date | 휴가 쓴 사람 |
MULTI-17 · 내가 결재할 건을 보고 화면에서 승인해요. 아직 AI 로 안 돼요 · 대신 화면
/worker/approvals| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"approval_list","arguments":{"box":"inbox"}} |
몸통 src/routes/mcp-tools/approval-read.ts:approvalList | 결재 번호 · 종류 · 올린 사람 |
MULTI-18 · 남은 연차와 쓴 내역을 같이 봐요. AI 로 끝까지 돼요
/worker/leave| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_leave_balance","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leave_balance | 남은 일수 |
| 2 | {"name":"run_read","arguments":{"tool":"query_my_leaves","args":{"year":2026}}} |
몸통 src/routes/mcp-tools/leave.ts:query_my_leaves | 쓴 날짜 · 상태 |
MULTI-21 · 경비를 올리고 처리 상태를 바로 봐요. AI 로 끝까지 돼요
/worker/expense| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1-미리보기 | 먼저 묻기: 「금액과 쓴 곳을 알려 주세요.」 {"name":"run_destructive","arguments":{"tool":"submit_expense","args":{"title":"10월 팀 점심","items":[{"amount":12000,"date":"2026-10-20","vendor":"가상식당","description":"팀 점심","category":"식대"}]}}} |
몸통 src/routes/mcp-tools/expense.ts:submitMcpExpense · 함수 src/lib/approval-expense-route.ts:createExpenseClaimWithAtomicApproval · 웹 API POST /api/worker/expense {amount, expense_date, description, payment_method, vendor} |
confirmation_id 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 1-확정 | {"name":"run_destructive","arguments":{"tool":"submit_expense","args":{"title":"10월 팀 점심","items":[{"amount":12000,"date":"2026-10-20","vendor":"가상식당","description":"팀 점심","category":"식대"}]},"confirmation_id":"<1-미리보기.confirmation_id>"}}1-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/expense.ts:submitMcpExpense · 함수 src/lib/approval-expense-route.ts:createExpenseClaimWithAtomicApproval · 웹 API POST /api/worker/expense {amount, expense_date, description, payment_method, vendor} |
경비 번호 |
| 2 | {"name":"run_read","arguments":{"tool":"query_my_expenses","args":{"month":"2026-10"}}} |
몸통 src/routes/mcp-tools/expense.ts:query_my_expenses · 웹 API GET /api/worker/expense | 경비 상태 |
MULTI-22 · 내 근무 일정을 보고 근무 교환을 신청해요. AI 로 끝까지 돼요
/worker/shift-swap| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_my_schedule","args":{"from_date":"2026-10-21","days":14}}} |
몸통 src/routes/mcp-tools/ops.ts:query_my_schedule · 웹 API GET /api/workers/me/shifts | 내 근무일 |
| 2-미리보기 | 먼저 묻기: 「어느 날을 누구와 바꿀까요?」 {"name":"run_destructive","arguments":{"tool":"request_shift_swap","args":{"my_date":"2026-10-28","target_worker":"한신입","target_date":"2026-10-30","reason":"개인 일정이 있어요."}}} |
몸통 src/routes/mcp-tools/shift-ops.ts:request_shift_swap · 함수 src/lib/shift-swap-roster.ts:createShiftSwapRequest · 웹 API POST /api/worker/shift-swap {my_date, target_worker_id, target_date, reason} |
confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구인가요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"run_destructive","arguments":{"tool":"request_shift_swap","args":{"my_date":"2026-10-28","target_worker":"한신입","target_date":"2026-10-30","reason":"개인 일정이 있어요."},"confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/shift-ops.ts:request_shift_swap · 함수 src/lib/shift-swap-roster.ts:createShiftSwapRequest · 웹 API POST /api/worker/shift-swap {my_date, target_worker_id, target_date, reason} |
교환 신청 번호 |
MULTI-23 · 근태가 이상한 직원을 찾고 확인 업무를 보내요. AI 로 끝까지 돼요
/worker/calendar| 차례 | tools/call (POST /api/mcp) | 서버 | 다음으로 넘길 값 |
|---|---|---|---|
| 1 | {"name":"run_read","arguments":{"tool":"query_attendance_anomaly","args":{"limit":10}}} |
몸통 src/routes/mcp-tools/insights.ts:query_attendance_anomaly | 직원 이름 · 이상한 기록 |
| 2-미리보기 | 먼저 묻기: 「누구에게 확인을 부탁할까요?」 {"name":"task_create","arguments":{"title":"출퇴근 기록 확인","body":"어제 출퇴근 기록이 이상해요. 확인해 주세요.","to":["김가상"],"due":"2026-10-23"}} |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | confirmation_id 후보가 여럿이면(needs_choice) 「같은 이름이 여럿이에요. 누구에게 보낼까요?」 → 고른 id 로 같은 줄을 다시 · 미리보기를 사용자에게 보여 주고 「네」를 받아요 |
| 2-확정 | {"name":"task_create","arguments":{"title":"출퇴근 기록 확인","body":"어제 출퇴근 기록이 이상해요. 확인해 주세요.","to":["김가상"],"due":"2026-10-23","confirmation_id":"<2-미리보기.confirmation_id>"}}2-미리보기.confirmation_id → confirmation_id |
몸통 src/routes/mcp-tools/work-tasks.ts:task_create | 업무 번호 |
Tool 목록
| Tool | Permission | Description |
|---|---|---|
| query_attendance_today | attendance.read | 오늘 우리 회사 직원들의 출퇴근 기록을 조회합니다. "오늘 누가 출근했어?", "오늘 출퇴근 현황" 같은 질문에 사용하세요. |
| query_who_is_in | company.read | 지금 회사에 있는 사람(출근 후 퇴근 안 한 사람) 목록을 조회합니다. "지금 누가 회사에 있어?", "현재 남아있는 사람" 같은 질문에 사용하세요. |
| query_overtime_summary | attendance.read | 지정한 기간의 연장근로(야근) 시간을 직원별로 집계합니다. "이번주 야근시간 누가 가장 많아?", "야간 근로자 누구" 같은 질문에 사용하세요. |
| query_leaves_pending | leave.read | 승인 대기 중인 휴가 신청 목록을 조회합니다. "내가 승인해야 할 휴가", "결재 대기 중인 휴가" 같은 질문에 사용하세요. |
| query_employees | employee.read | 회사 직원 목록을 조회합니다. 부서/직책으로 필터링 가능. "디자인팀에 누가 있어?", "전체 직원 명단" 같은 질문에 사용하세요. |
| query_expense_summary | expense.read | 경비 청구 요약을 조회합니다. 월별 / 카테고리별. "이번달 경비 합계", "광고비 얼마 썼지?" 같은 질문에 사용하세요. |
| create_announcement 확인 | admin.write | 회사 전체 공지를 작성합니다. "내일 오후 2시 전사 회의 공지 올려" 같은 명령에 사용하세요. |
| clock_in 확인 | attendance.write | 본인 출근을 기록합니다. "출근 찍어줘", "출근 처리" 같은 명령에 사용하세요. NFC 없이 MCP 만으로 출근 처리. |
| clock_out 확인 | attendance.write | 본인 퇴근을 기록합니다. "퇴근 찍어줘" 같은 명령에 사용하세요. |
| query_my_attendance | attendance.read | 본인의 이번 주 출퇴근 기록을 조회합니다. "내가 이번주 몇시간 일했어?", "내 출퇴근 보여줘" 같은 질문에 사용하세요. |
| request_leave | leave.request | 본인의 휴가를 신청합니다. "내일 연차 신청해줘", "다음주 월요일 반차" 같은 명령에 사용하세요. |
| query_team_attendance | attendance.read | 본인 팀의 오늘 출퇴근 현황을 조회합니다. "우리팀 오늘 누구 출근했어?" 같은 질문에 사용하세요. 부서장 이상. |
| query_team_pending_leaves | leave.read | 본인 팀의 승인 대기 휴가 신청 목록. "우리팀 휴가 신청 누가 했어?" 같은 질문에 사용하세요. 부서장 이상. |
| query_company_overtime_cost | attendance.read | 회사 전체의 연장근로/야간근로 시간 + 추정 야간수당 지급액. "이번주 야근수당 얼마야?", "이번달 야간근로 수당 얼마야?" 같은 질문에 사용하세요. 대표관리자 전용. |
| query_company_expense_total | expense.read | 회사 전체 경비 청구 총액 (기간/상태별). "이번달 경비 얼마 청구됐어?", "이번주 결재된 경비" 같은 질문에 사용하세요. 대표관리자 전용. |
| query_my_leave_balance | leave.read | 본인의 연차 잔여일수를 조회합니다. "내 휴가 며칠 남았어?", "연차 얼마 남음?" 같은 질문에 사용. |
| query_my_leaves | leave.read | 본인이 신청한 휴가 목록을 조회합니다. "내가 신청한 휴가 보여줘", "내 휴가 신청 상태" 같은 질문에 사용. |
| cancel_leave_request | leave.request | 본인이 신청한 대기중(pending) 휴가를 취소합니다. "어제 신청한 휴가 취소해줘" 같은 명령에 사용. |
| withdraw_approved_leave 확인 | leave.approve | 승인된 휴가의 철회를 시도합니다. ★2026-09-15 규칙 변경 이후 결재가 완료된 휴가는 시작 전이어도 결재를 받아야 취소되므로, 이 도구로는 처리되지 않고 앱·웹의 「취소 결재 요청」으로 안내합니다.★ 아직 결재가 끝나지 않은 신청의 취소는 앱·웹 휴가 화면에서 본인이 바로 할 수 있습니다. |
| query_leave_balance | leave.read | 특정 직원의 연차 잔여일수를 조회합니다. "이주영 휴가 며칠 남았어?" 같은 질문에 사용. 부서장 이상. |
| query_company_leave_summary | leave.read | 회사 전체의 휴가 사용 현황 요약 (부여/사용/잔여 총합 + 사용률). "전사 휴가 사용률", "올해 연차 얼마나 썼어?" 같은 질문에 사용. 인사 권한 필요. |
| query_leaves_on_date | leave.read | 특정 날짜에 휴가/휴무인 직원 목록. "내일 누가 쉬어?", "오늘 휴무자" 같은 질문에 사용. 부서장 이상. |
| submit_overtime_request 확인 | attendance.write | 연장(시간외) 근무를 사전 신청합니다. "오늘 저녁 2시간 야근 신청", "내일 18시부터 21시까지 연장근무 신청" 같은 명령에 사용. 주52시간 한도/임금 분쟁의 핵심 증거가 되는 사전 승인 기록입니다. 결재 대기(submitted)로 등록됩니다. |
| query_my_work_hours | company.read | 본인의 이번달(또는 지정월) 총 근무시간/연장/야간을 조회합니다. "이번달 내 근무시간?", "내가 몇시간 일했어?" 같은 질문에 사용. |
| query_my_overtime | attendance.read | 본인의 이번달 연장/야간 근로 시간을 조회합니다. "이번달 내 야근 얼마야?" 같은 질문에 사용. |
| query_employee_work_hours | employee.read | 특정 직원의 근무시간을 조회합니다. "이주영 이번달 몇시간 일했어?" 같은 질문에 사용. 부서장은 본인 팀원만, 인사 권한 필요은 전사. |
| query_team_work_hours | company.read | 본인 팀 전체의 이번달 근무시간을 직원별로 정리합니다. "우리팀 이번달 근로시간 정리해줘" 같은 질문에 사용. 부서장 이상. |
| query_team_overtime | attendance.read | 본인 팀의 야근 시간 순위 (기간 지정). "우리팀 이번주 야근 누가 많아?" 같은 질문에 사용. 부서장 이상. |
| query_team_overtime_today | attendance.read | 오늘 야근(8시간 초과 또는 22시 이후 퇴근 안함) 중인 본인 팀원. "금일 야근 중인 우리팀원 누구야?" 같은 질문에 사용. 부서장 이상. |
| query_overtime_threshold_breach | attendance.read | 지정 기간 야근(연장) 시간이 임계값 초과한 직원. "이번달 야근 30시간 넘은 사람?" 같은 질문에 사용. 인사 권한 필요. |
| check_52h_compliance | company.read | 주 52시간 근로제 준수 점검 — 이번주 총근로 52시간 초과(또는 임박) 직원. "주52시간 위반 위험자 누구?" 같은 질문에 사용. 인사 권한 필요. |
| create_employment_contract 확인 | admin.write | 근로계약서를 작성하여 직원에게 발송합니다. "이주영 근로계약서 작성해서 보내줘" 같은 명령에 사용. 인사 권한 필요. 직원이 앱에서 전자서명. 임금 조건은 근로조건 카드(급여 설정)에서 정한 값이 자동으로 실린다 — 이 도구는 그 값을 인자로 받지 않는다. |
| query_my_contracts | company.read | 본인의 근로계약서 목록을 조회합니다. "내 근로계약서 보여줘", "내 계약 만료일?" 같은 질문에 사용. |
| query_contract_expiry | company.read | 특정 직원의 근로계약 만료일을 조회합니다. "박민수 계약 언제 끝나?" 같은 질문에 사용. 부서장 이상. |
| query_expiring_contracts | company.read | 곧 만료되는 근로계약 목록. "이번달 만료되는 계약 누구?", "30일 내 갱신 필요한 직원" 같은 질문에 사용. 인사 권한 필요. |
| query_contracts | company.read | 회사 근로계약 목록을 상태별로 조회합니다. "서명 대기중 계약?", "발송한 계약서 현황" 같은 질문에 사용. 인사 권한 필요. |
| query_my_payslip | payroll.read | 본인의 급여명세서를 조회합니다. "이번달 내 급여 명세서", "5월 월급 얼마야?" 같은 질문에 사용. |
| query_company_payroll_total | company.read | 회사 전체 인건비(급여) 총합을 조회합니다. "이번달 인건비 총합?", "5월 급여 총액" 같은 질문에 사용. 대표관리자 전용. |
| query_payslips | payroll.read | 회사 급여명세서 목록을 조회합니다. "5월 급여명세서 현황", "확정 안된 명세서?" 같은 질문에 사용. 인사 권한 필요. |
| query_headcount_by_department | company.read | 부서별 인원수 현황. "부서별 인원 몇 명?", "조직 규모" 같은 질문에 사용. 대표관리자 또는 인사 권한. |
| query_new_hires | company.read | 신규 입사자 목록. "이번달 신규 입사자?", "최근 입사한 사람" 같은 질문에 사용. 대표관리자 또는 인사 권한. |
| query_recent_resignations | company.read | 최근 퇴사자 목록. "이번달 퇴사자 누구?", "퇴사한 사람" 같은 질문에 사용. 대표관리자 또는 인사 권한. |
| query_low_leave_users | leave.read | 연차를 거의 안 쓴 직원 (사용촉진 대상). "연차 안 쓴 사람 누구?", "휴가 촉진 대상" 같은 질문에 사용. 대표관리자 또는 인사 권한. |
| query_attendance_rate_today | attendance.read | 오늘 부서별 출근율. "오늘 출근율?", "부서별 출근 현황" 같은 질문에 사용. 대표관리자 또는 인사 권한. |
| query_employee_profile | employee.read | 직원 1명의 상세 프로필 (부서/직책/입사일/고용형태). "이주영 정보 알려줘", "박민수 입사일?" 같은 질문에 사용. 부서장 이상. |
| query_org_chart | company.read | 회사 조직도(부서 트리)를 조회합니다. "조직도 보여줘", "부서 구조" 같은 질문에 사용. 부서장 이상. |
| update_employee_position 확인 | employee.write | 직원의 직책/부서를 변경(승진/이동)합니다. "이주영 부서장으로 승진", "박민수 개발팀으로 이동" 같은 명령에 사용. 인사 권한 필요. |
| process_resignation 확인 | admin.write | 직원 퇴직 처리 (소속 상태를 resigned 로 변경 + 퇴사일 기록). "박민수 6월 15일자 퇴사 처리" 같은 명령에 사용. 인사 권한 필요. ⚠️ 신중히. |
| query_announcements_unread | company.read | 읽지 않은 회사 공지 목록. "새 공지 있어?", "안 읽은 공지" 같은 질문에 사용. |
| query_announcements | company.read | 회사 공지 목록 (최근순). "공지사항 보여줘" 같은 질문에 사용. |
| mark_announcement_read 확인 | admin.write | 공지를 읽음 처리합니다. "그 공지 읽음 처리해" 같은 명령에 사용. |
| query_my_expense_claims | expense.read | 본인 경비 청구 목록. "내 경비 정산 어떻게 됐어?", "이번달 경비 신청" 같은 질문에 사용. |
| create_expense_claim | expense.create | 이전 호환용 경비 청구 도구입니다. 새 제출은 결재 스냅샷을 안전하게 만드는 submit_expense 도구를 사용하세요. |
| query_seals | approval.read | 회사 등록 인감(도장) 목록. "우리 회사 인감 뭐있어?" 같은 질문에 사용. |
| request_seal_use | approval.create | 인감 사용을 신청합니다. "법인인감 계약서용으로 신청" 같은 명령에 사용. |
| submit_business_trip 확인 | admin.write | 출장/외근을 신청합니다. "다음주 부산 출장 신청", "내일 고객사 방문 외근" 같은 명령에 사용. |
| query_my_trips | company.read | 본인 출장 신청 목록. "내 출장 신청 현황" 같은 질문에 사용. |
| request_certificate 확인 | admin.write | 재직증명서 등 제증명을 신청합니다. "재직증명서 1부 신청", "경력증명서 발급해줘" 같은 명령에 사용. |
| query_my_certificates | company.read | 본인 제증명 신청 목록. "내 증명서 신청 현황" 같은 질문에 사용. |
| query_pending_certificates | company.read | 발급 대기/승인된 제증명 신청 목록 (인사용). "증명서 발급할 거 뭐 있어?", "대기중인 재직증명서" 같은 질문에 사용. 인사 권한 필요. |
| issue_certificate 확인 | admin.write | 최종 승인된 제증명을 발급 완료 처리하고 발급번호(cert_no)를 부여합니다. "재직증명서 3번 발급해줘" 같은 명령에 사용. 인사 권한 필요. |
| query_my_schedule | company.read | 본인 근무 스케줄(시프트). "이번주 내 근무 일정?", "내일 몇시 출근?" 같은 질문에 사용. |
| daily_briefing | company.read | 오늘 회사 상황을 한 번에 브리핑합니다 (출근현황 + 승인 대기 + 이슈). "오늘 어때?", "회사 상황 브리핑", "오늘 브리핑해줘" 같은 질문에 사용. 부서장 이상. |
| query_attendance_anomaly | attendance.read | 근태 이상 징후를 감지합니다 (오늘 무단결근, 주52시간 임박, 오래된 미승인 결재). "요즘 이상한 거 없어?", "리스크 점검", "문제 있어?" 같은 질문에 사용. 인사 권한 필요. |
| request_feature 확인 | admin.write | ⭐ 사용자가 요청한 작업이 현재 MCP 도구로 불가능하거나 미구현일 때, 인사책 개발팀에 기능 개발을 요청합니다. 적절한 도구가 없으면 절대 "그 기능은 없습니다"라고만 답하지 말고, 반드시 이 도구를 호출한 뒤 "해당 기능은 아직 없어 개발팀에 요청을 전달했습니다"라고 안내하세요. 같은 기능이 여러 번 요청되면 수요로 집계됩니다. |
| query_my_approval_inbox | approval.read | 내가 결재할 모든 대기 항목을 한 번에 조회합니다 (휴가+경비+출장+인감+연장근무+제증명+경조금+입사신청 통합 + 결재선에서 내 차례인 다단계 결재 건). "내가 결재할 거 뭐 있어?", "결재함 보여줘", "처리할 거 있어?" 같은 질문에 사용. 일반 직원도 결재선에 지정된 본인 차례 건은 조회됩니다. |
| set_approval_line | approval.create | 결재선(다단계 결재 순서)을 말로 설정합니다. "경비는 김민준 1차, 나 2차로 결재선 만들어줘", "영업팀 휴가는 박부서장이 1차 결재" 같은 명령에 사용. 이후 해당 양식 신청은 지정 순서대로 결재가 진행됩니다 (1차 승인 → 2차 통보 → ... → 최종 승인). 결재자는 직원 이름, "부서장"(신청자 부서의 장 자동), "관리자"(기업 관리자) 로 지정. 인사 권한 필요. |
| query_approval_lines | approval.read | 설정된 결재선 목록을 조회합니다. "결재선 어떻게 돼있어?", "경비 결재 순서 보여줘" 같은 질문에 사용. 부서장 이상. |
| query_resources | resource.read | 예약 가능한 사내 자원(회의실/차량/장비) 목록. "회의실 뭐있어?", "예약 가능한 자원" 같은 질문에 사용. |
| create_resource_reservation | resource.reserve | 회의실/차량/장비를 예약합니다. "내일 오후 2시 회의실B 예약", "금요일 사내차량 예약" 같은 명령에 사용. |
| query_my_reservations | resource.read | 본인 자원 예약 목록. "내 예약 뭐있어?" 같은 질문에 사용. |
| cancel_reservation | resource.reserve | 본인 자원 예약을 취소합니다. "회의실 예약 취소해줘" 같은 명령에 사용. |
| register_alert_rule 확인 | admin.write | 능동 알림 규칙을 등록합니다. "야근 50시간 넘으면 알려줘", "주52시간 임박하면 푸시", "계약 만료 30일 전 알림" 같은 명령에 사용. 등록된 규칙은 인사책이 주기적으로 체크해 푸시 알림. 인사 권한 필요. |
| query_alert_rules | company.read | 등록된 알림 규칙 목록. "알림 규칙 뭐있어?", "설정된 알림" 같은 질문에 사용. 인사 권한 필요. |
| deactivate_alert_rule 확인 | admin.write | 알림 규칙을 비활성화합니다. "그 알림 끄줘" 같은 명령에 사용. 인사 권한 필요. |
| search_company | company.read | 사업자등록번호 또는 상호명으로 회사를 검색합니다. 가입 신청 전에 회사를 찾을 때 사용. "ABC물산 찾아줘", "사업자번호 123-45-67890 회사" 같은 질문에 사용. (가입 신청은 request_join_company) 회사 미소속도 사용 가능. |
| request_join_company 확인 | admin.write | 특정 회사에 소속(입사) 가입을 신청합니다. "ABC물산에 가입 신청해줘", "사업자번호 123-45-67890 회사에 입사 신청" 같은 명령에 사용. 신청하면 그 회사 관리자가 승인해야 소속됩니다. 회사 미소속(신규 가입자)도 사용 가능. |
| query_join_requests | company.read | 우리 회사에 들어온 가입(입사) 신청 목록을 조회합니다. "가입 신청 누가 했어?", "입사 승인 대기자" 같은 질문에 사용. 인사 권한 필요. |
| submit_resignation 확인 | admin.write | 퇴직원(사직서)을 제출합니다. "퇴직원 제출해줘, 마지막 근무일은 6월 30일" 같은 명령에 사용. 관리자가 승인하면 퇴사 처리됩니다. |
| withdraw_resignation 확인 | admin.write | 제출한 퇴직원을 철회합니다. "퇴직원 취소해줘" 에 사용. 아직 승인되지 않은 퇴직원만 철회 가능. |
| query_resignation_requests | company.read | 우리 회사에 제출된 퇴직원 목록을 조회합니다. "퇴직원 들어온 거 있어?" 같은 질문에 사용. 인사 권한 필요. |
| add_employee 확인 | employee.write | 직원을 회사에 직접 등록합니다. "박영희 010-1234-5678 영업팀 대리로 등록해줘" 같은 명령에 사용. 이미 인사책 회원이면 즉시 소속 연결, 아니면 계정을 만들어 연결합니다 (직원이 나중에 카카오/네이버 로그인 시 같은 전화번호로 본인 계정 인증). 인사 권한 필요. |
| export_attendance_csv | attendance.read | 근태(출퇴근) 데이터를 CSV로 내보냅니다. "이번달 근태 다운로드", "출퇴근 기록 엑셀로 줘" 같은 명령에 사용. 결과 CSV를 파일로 저장하면 됩니다. 부서장 이상. |
| export_payroll_csv | payroll.read | 급여명세서 데이터를 CSV로 내보냅니다. "이번달 급여 다운로드", "급여대장 엑셀" 같은 명령에 사용. 인사 권한 필요. |
| export_employees_csv | employee.read | 직원 명단을 CSV로 내보냅니다. "직원 명단 다운로드", "직원 리스트 엑셀로" 같은 명령에 사용. 인사 권한 필요. |
| grant_advisor_access 확인 | admin.write | 외부 노무사/세무사에게 우리 회사 데이터 접근 권한을 부여합니다. 노무사가 알려준 토큰 prefix(ic_pat_xxxx)로 연결. "최노무사한테 우리 회사 권한 줘" 같은 명령에 사용. 인사 권한 필요. |
| list_advisor_access | company.read | 우리 회사 데이터에 접근 권한이 걸린 외부 노무사/세무사 링크 목록을 봅니다(회수할 링크 번호 확인용). "노무사 권한 누구한테 줬어?" 같은 질문에 사용. 인사 권한 필요. |
| revoke_advisor_access 확인 | admin.write | 외부 노무사/세무사의 우리 회사 접근 권한을 회수합니다. list_advisor_access 의 link_id 로 지정. "최노무사 권한 빼줘" 같은 명령에 사용. 인사 권한 필요. |
| query_advisor_companies | company.read | (노무사 전용) 내가 접근 가능한 고객사 목록을 조회합니다. "내 고객사 뭐있어?", "관리하는 회사 목록" 같은 질문에 사용. |
| advisor_company_briefing | company.read | (노무사 전용) 특정 고객사의 오늘 상황을 브리핑합니다. "A사 오늘 어때?", "ABC물산 52시간 위반 있어?" 같은 질문에 사용. query_advisor_companies 의 enterprise_id 로 호출. |
| create_department 확인 | admin.write | 새 부서/본부/팀을 조직도에 추가합니다. "사업본부 밑에 해외영업팀 만들어", "마케팅 본부 신설" 같은 명령에 사용. 인사 권한 필요. |
| rename_department 확인 | admin.write | 부서 이름을 변경합니다. "마케팅팀을 그로스팀으로 바꿔" 같은 명령에 사용. 인사 권한 필요. |
| move_department 확인 | admin.write | 부서를 다른 상위 부서 밑으로 이동합니다. "인사팀을 경영지원본부 밑으로 옮겨", "영업팀 최상위로" 같은 명령에 사용. 인사 권한 필요. |
| archive_department 확인 | admin.write | 부서를 폐지(보관)합니다. "영업팀 없애줘" 같은 명령에 사용. 하위 부서가 있으면 먼저 정리해야 합니다. 인사 권한 필요. |
| assign_department_head 확인 | admin.write | 부서장을 임명합니다. "이주영을 영업부서장으로", "박철수를 경영지원본부장으로" 같은 명령에 사용. 공동 부서장("김OO도 영업부서장으로", "두 명이 공동 부서장")은 mode:"add". 인사 권한 필요. |
| assign_worker_to_department 확인 | employee.write | 직원을 특정 부서에 배치(이동)합니다. "박철수 인사팀으로 배치", "김영희 영업팀으로 옮겨" 같은 명령에 사용. 인사 권한 필요. (한 직원은 한 부서 — 매트릭스 조직 미지원) |
| query_my_kpi_goals | company.read | 본인의 성과목표(KPI/OKR)와 진척률을 조회합니다. "내 목표 뭐 있어?", "이번 분기 KPI 진척률" 같은 질문에 사용. |
| update_kpi_progress 확인 | admin.write | 본인 성과목표의 진척률/현재지표/자기평가를 업데이트합니다. "신규고객 목표 70%로 갱신", "자기평가 4점" 같은 명령에 사용. |
| create_kpi_goal 확인 | admin.write | 팀원에게 성과목표(KPI/OKR)를 부여합니다. "이주영한테 2026-Q3 신규고객 50사 목표 줘" 같은 명령에 사용. 부서장은 웹 부서장 화면과 같은 부서 관리 권한으로 본인 부서원만(본인 제외) · 성과 관리 권한 관리자는 회사 전체. |
| review_kpi_goal 확인 | admin.write | 성과목표를 평가(리뷰)합니다 — 관리자 점수 + 코멘트. "이주영 Q2 목표 4점, 잘했음" 같은 명령에 사용. 웹 관리자 「성과관리」와 같은 성과 관리 권한이 필요하며 본인 목표·중단된 목표는 평가할 수 없습니다. |
| query_team_kpi_goals | company.read | 본인 팀(또는 특정 직원)의 성과목표 현황을 조회합니다. "우리팀 이번 분기 목표 현황", "팀 KPI 진척률" 같은 질문에 사용. 부서장 이상. |
| query_shift_templates | attendance.read | 회사 시프트(근무조) 템플릿 목록. "우리 회사 근무조 뭐 있어?", "교대 시간대 알려줘" 같은 질문에 사용. |
| create_shift_template 확인 | attendance.write | 시프트(근무조) 템플릿을 만듭니다. "주간조 09시~18시 만들어", "야간조 22시~06시 추가" 같은 명령에 사용. 인사 권한 필요. |
| assign_shift 확인 | attendance.write | 직원에게 특정 날짜 시프트를 배정합니다. "이주영 내일 야간조 배정", "8월 1일 김철수 휴무" 같은 명령에 사용. 워커당 하루 1개(재배정 시 덮어쓰기). 부서장은 본인 팀원만. |
| query_team_shifts | attendance.read | 본인 팀의 기간별 근무 스케줄. "이번주 우리팀 시프트", "8월 1일 누가 야간이야?" 같은 질문에 사용. 부서장 이상. |
| query_corporate_vehicles | resource.read | 법인 차량 목록. "우리 회사 법인차 뭐 있어?", "차량 목록" 같은 질문에 사용. |
| register_corporate_vehicle | resource.reserve | 법인 차량을 등록합니다. "법인차 12가1234 아반떼 등록" 같은 명령에 사용. 인사 권한 필요. |
| log_vehicle_trip | resource.reserve | 차량 운행일지를 기록합니다. "법인차 1번 본사→강남 거래처 30km 운행" 같은 명령에 사용. 누적 주행거리가 자동 합산됩니다. |
| query_vehicle_logs | resource.read | 차량 운행일지 조회 (차량 지정 또는 최근). "법인차 1번 운행기록", "이번달 운행일지" 같은 질문에 사용. 부서장 이상. |
| query_corporate_cards | expense.read | 법인 카드 목록. "법인카드 뭐 있어?" 같은 질문에 사용. 인사 권한 필요. |
| register_corporate_card | expense.create | 법인 카드를 등록합니다. "신한카드 끝자리 5678 영업팀카드 등록" 같은 명령에 사용. 인사 권한 필요. |
| log_card_usage | expense.create | 법인카드 사용내역을 기록합니다. "법인카드 2번 스타벅스 12000원", "어제 거래처 점심 5만원 카드" 같은 명령에 사용. 누적 사용액이 자동 합산됩니다. |
| query_card_usages | expense.read | 법인카드 사용내역 조회 (카드 지정 또는 최근). "법인카드 2번 사용내역", "이번달 법인카드 지출" 같은 질문에 사용. 인사 권한 필요. |
| query_leave_policy | leave.read | 회사 연차/휴가 정책 (기본 부여일수, 회계연도 시작, 반차/반반차 지원 등). "우리 회사 연차 정책 어떻게 돼?", "연차 며칠부터 시작?" 같은 질문에 사용. 인사 권한 필요. |
| query_hr_permissions | employee.read | 특정 직원의 인사 권한 설정 현황 (회사/부서 관리, 조회 권한, 카테고리 권한). "이주영 권한 뭐 있어?", "박철수 인사카드 볼 수 있어?" 같은 질문에 사용. 대표(owner) 전용. |
| query_worksites | company.read | 회사 사업장(본사/지점/공장/매장/물류/해외법인/대리점) 목록과 인원·GPS·지역을 조회합니다. "우리 회사 사업장 어디어디 있어?", "지점 목록", "사업장별 인원" 같은 질문에 사용. |
| create_worksite 확인 | admin.write | 사업장(본사/지점/공장/매장/해외법인/대리점 등)을 추가합니다. "강남지점 만들어", "부산공장 등록", "베트남법인 사업장 추가" 같은 명령에 사용. GPS 좌표·반경을 주면 그 사업장의 출퇴근 인증 범위가 됩니다. 인사 권한 필요. |
| update_worksite 확인 | admin.write | 사업장 정보(GPS/종류/지역/타임존/반경/활성)를 수정합니다. "강남지점 반경 200미터로", "부산공장 GPS 갱신", "제주점 폐쇄" 같은 명령에 사용. 인사 권한 필요. |
| assign_worker_to_worksite 확인 | employee.write | 직원을 특정 사업장(지점/공장/매장)에 배치합니다. "이주영 강남지점으로", "박철수 부산공장 배치" 같은 명령에 사용. 발령 이력이 남습니다. 인사 권한 필요. |
| transfer_worker 확인 | employee.write | 인사발령 — 부서/사업장/직책을 한 번에 변경하고 발령 이력을 남깁니다 (기존 이력 덮어쓰지 않음). "이주영 영업2팀 부서장으로 승진발령", "김철수 부산지점 발령", "한미녀 인사팀으로 전보" 같은 명령에 사용. 인사 권한 필요. |
| query_assignment_history | company.read | 직원의 인사발령 이력(입사/전보/승진/사업장이동/휴직/복직)을 시간순으로 조회합니다. "이주영 발령 이력", "박철수 인사 변동 내역" 같은 질문에 사용. 부서장 이상. |
| query_worksite_headcount | company.read | 사업장별 재직 인원 현황 + 미배치 인원. "지점별 인원 몇 명?", "사업장별 헤드카운트", "강남지점 몇 명?" 같은 질문에 사용. 부서장 이상. |
| put_worker_on_leave | leave.request | 직원을 휴직/산재/파견/정직 등 상태로 전환합니다. "이주영 육아휴직 처리 3개월", "박철수 산재 휴직", "김부장 베트남 파견" 같은 명령에 사용. 재직(퇴사 아님)을 유지하면서 상태만 표시 — 헤드카운트·평균임금 근거 보존. 인사 권한 필요. |
| return_worker_from_leave | leave.request | 휴직/파견 중인 직원을 복직 처리합니다. "이주영 복직", "박철수 산재 복귀" 같은 명령에 사용. 인사 권한 필요. |
| query_workers_on_leave | leave.read | 현재 휴직/산재/파견/정직 중인 직원 목록. "지금 휴직자 누구야?", "육아휴직 중인 사람", "파견 나간 직원" 같은 질문에 사용. 부서장 이상(부서장은 본인 부서). |
| add_concurrent_assignment 확인 | admin.write | 겸직/매트릭스 배정 — 직원에게 주소속 외 추가 소속(부서/사업장/프로젝트)을 부여합니다. "이주영을 신사업TF에도 겸직", "박철수 영업팀+마케팅팀 동시소속" 같은 명령에 사용. 주소속은 유지되고 부소속이 추가됩니다. 인사 권한 필요. |
| query_worker_assignments | employee.read | 한 직원의 모든 소속(주소속 + 겸직/매트릭스 부소속)을 조회합니다. "이주영 어디어디 소속이야?", "박철수 겸직 현황" 같은 질문에 사용. 부서장 이상. |
| end_concurrent_assignment 확인 | admin.write | 겸직/매트릭스 부소속을 종료합니다. "이주영 신사업TF 겸직 해제" 같은 명령에 사용. query_worker_assignments 의 assignment_id 로 호출(주소속은 해제 불가). 인사 권한 필요. |
| query_projects | company.read | 회사 프로젝트 목록(상태·기간·PM·예산). "진행중인 프로젝트 뭐 있어?", "프로젝트 현황" 같은 질문에 사용. |
| create_project 확인 | admin.write | 프로젝트를 생성합니다. "OO고객사 차세대시스템 프로젝트 만들어 PRJ-2026-007 코드로" 같은 명령에 사용. 웹 「경비 → 프로젝트」와 같은 경비 관리 권한이 필요합니다. |
| update_project 확인 | admin.write | 프로젝트 상태/기간/예산을 수정합니다. "차세대 프로젝트 종료처리", "OO프로젝트 예산 5천만원으로" 같은 명령에 사용. 웹 「경비 → 프로젝트」와 같은 경비 관리 권한이 필요합니다. |
| assign_project_member 확인 | admin.write | 직원을 프로젝트에 투입합니다(투입률 %). "이주영 차세대프로젝트 50% 투입 PL로", "박철수 OO프로젝트 전담" 같은 명령에 사용. 부서장 이상. |
| release_project_member 확인 | admin.write | 프로젝트 투입을 종료(철수)합니다. "이주영 차세대프로젝트에서 빼줘" 같은 명령에 사용. query_project_members 의 member_id 로 호출. 부서장 이상. |
| query_project_members | company.read | 프로젝트 투입 인력과 투입률. "차세대프로젝트 누가 투입됐어?", "OO프로젝트 인력" 같은 질문에 사용. 부서장 이상. |
| query_my_projects | company.read | 본인이 투입된 프로젝트 목록. "내가 어떤 프로젝트에 있어?", "내 투입 현황" 같은 질문에 사용. |
| query_worker_allocation | employee.read | 특정 직원의 프로젝트 투입률 합계(과투입 점검 — 합계 100% 초과 경고). "이주영 투입률 괜찮아?", "박철수 몇 프로젝트 뛰어?" 같은 질문에 사용. 부서장 이상. |
| register_external_party 확인 | admin.write | 비직원 협력관계(가맹점주/대리점/위탁/파견사/프리랜서/협력사)를 등록합니다. "강남가맹점 점주 김사장 등록", "OO파견사 등록" 같은 명령에 사용. 근로자(직원)가 아닌 외부 관계를 별도 관리 — 근로계약/4대보험 전제 없음. 인사 권한 필요. |
| query_external_parties | company.read | 비직원 협력관계 목록. "우리 가맹점 몇 개야?", "대리점 목록", "거래 파견사" 같은 질문에 사용. 부서장 이상. |
| update_external_party 확인 | admin.write | 비직원 관계 정보/상태를 수정합니다. "강남가맹점 계약종료 처리", "OO파견사 연락처 변경" 같은 명령에 사용. 인사 권한 필요. |
| link_party_to_worksite 확인 | admin.write | 비직원(가맹점주 등)을 특정 사업장에 연결합니다. "강남점주를 강남지점에 연결" 같은 명령에 사용. 인사 권한 필요. |
| record_insurance_event 확인 | admin.write | 4대보험 취득/상실/변경 신고를 기록합니다. "이주영 입사 4대보험 취득", "박철수 퇴사 자격상실 신고" 같은 명령에 사용. 일용직 반복 입퇴사·산재 가입 추적. 인사 권한 필요. |
| query_insurance_events | company.read | 4대보험 신고 이력 조회. "이번달 자격취득 신고 누구?", "이주영 4대보험 이력" 같은 질문에 사용. 인사 권한 필요. |
| query_insurance_status | company.read | 전 직원 4대보험 가입 현황(국민연금/건강/고용/산재). "4대보험 미가입자 있어?", "보험 가입 현황" 같은 질문에 사용. 인사 권한 필요. |
| generate_worker_roster | employee.read | 근로자명부(근기법 제41조 법정서식)를 생성합니다 — 성명·성별·생년월일·주소·종사업무·입사일·고용형태. 주민등록번호와 연락처는 명부 법정 기재사항이 아니라 포함하지 않습니다. "근로자명부 뽑아줘", "근로감독 대비 명부" 같은 명령에 사용. 인사 권한 필요. |
| generate_wage_ledger | company.read | 임금대장(근기법 제48조 법정서식)을 생성합니다 — 직원별 기본급·수당·공제·실수령. "지난달 임금대장", "2026-05 임금대장 뽑아줘" 같은 명령에 사용. 인사 권한 필요. |
| estimate_pay | company.read | 직원의 월 급여를 출퇴근 기록 기반으로 자동 추정합니다 — 기본급 + 연장/야간/휴일 가산수당(근기법 제56조) + 휴게 자동공제(제54조) + 4대보험 공제. "이주영 이번달 급여 얼마야?", "박철수 5월 야근수당 계산" 같은 질문에 사용. 읽기 전용(저장 안 함). 인사 권한 필요. |
| generate_payslip | payroll.write | 직원 급여명세서를 자동 계산해 생성/갱신합니다(상태 draft). "이주영 5월 급여명세 만들어" 같은 명령에 사용. 확정/지급된 명세는 보호됩니다. 인사 권한 필요. |
| finalize_payslip | payroll.write | 급여명세서를 확정 처리합니다(draft→finalized). "이주영 5월 명세 확정" 같은 명령에 사용. 인사 권한 필요. |
| bulk_generate_payslips | payroll.write | 전 직원 월 급여명세서를 일괄 자동 생성합니다(draft). "이번달 급여명세 전부 만들어", "5월 급여 일괄 계산" 같은 명령에 사용. 확정/지급된 건 건너뜀. 인사 권한 필요. |
| generate_rotation 확인 | admin.write | 순환 교대표를 자동 생성합니다. 직원들에게 패턴(예: ["주간","야간","휴무"])을 돌려가며 일괄 배정 — 한 달치 교대표를 한 번에. "간호1팀 5명 주간-야간-휴무 패턴으로 이번달 교대표 짜줘" 같은 명령에 사용. 부서장 이상. |
| request_shift_swap 확인 | attendance.write | 근무(시프트) 교환을 신청합니다. "나 8월 3일 야간인데 김철수랑 8월 5일이랑 바꾸고 싶어" 같은 명령에 사용. 상대/날짜 지정. 승인되면 두 근무가 교환됩니다. |
| query_shift_swaps | attendance.read | 교대 교환 신청 목록(대기/완료). "교환 신청 뭐 있어?", "내 교대 교환 상태" 같은 질문에 사용. |
| open_review_cycle 확인 | admin.write | 인사평가 사이클(시즌)을 엽니다. "2026 상반기 인사평가 시작 — 자기평가+매니저평가" 같은 명령에 사용. 인사 권한 필요. |
| query_review_cycles | company.read | 평가 사이클 목록/현황. "진행중인 평가 있어?", "이번 평가 시즌 현황" 같은 질문에 사용. |
| submit_self_review 확인 | admin.write | 본인 자기평가를 제출합니다. "자기평가 4점, 강점은 협업 약점은 일정관리" 같은 명령에 사용. |
| submit_review 확인 | admin.write | 나에게 배정된 팀원/동료 평가를 제출합니다(매니저 또는 피어). "이주영 매니저평가 4점", "박철수 피어리뷰" 같은 명령에 사용. 부서장 이상 · 평가 라운드에서 배정된 항목만 제출할 수 있습니다. |
| query_review_results | company.read | 특정 직원의 평가 결과(자기/매니저/피어 종합). "이주영 평가 결과 보여줘" 같은 질문에 사용. 부서장 이상. |
| query_review_progress | company.read | 평가 사이클 진행률(자기평가 제출 현황 등). "이번 평가 몇 명 제출했어?" 같은 질문에 사용. 인사 권한 필요. |
| close_review_cycle 확인 | admin.write | 평가 사이클을 종료합니다. "상반기 평가 마감" 같은 명령에 사용. 인사 권한 필요. |
| create_onboarding_template 확인 | admin.write | 온보딩 체크리스트 템플릿을 만듭니다. "신입 개발자 온보딩 템플릿 — 노트북지급/계정생성/보안교육/멘토배정" 같은 명령에 사용. 인사 권한 필요. |
| query_onboarding_templates | company.read | 온보딩 템플릿 목록. "온보딩 템플릿 뭐 있어?" 같은 질문에 사용. 부서장 이상. |
| start_onboarding 확인 | admin.write | 신규 입사자에게 온보딩 템플릿을 적용해 체크리스트를 생성합니다. "이주영 신입개발자 온보딩 시작" 같은 명령에 사용. 인사 권한 필요. |
| query_onboarding_tasks | company.read | 직원의 온보딩 진행 항목. "이주영 온보딩 어디까지 됐어?", "내 온보딩 체크리스트" 같은 질문에 사용. |
| complete_onboarding_task 확인 | admin.write | 온보딩 항목을 완료 처리합니다. "노트북 지급 완료" 같은 명령에 사용. query_onboarding_tasks 의 task_id 로 호출. |
| query_onboarding_status | company.read | 전사 온보딩 진행 현황(진행중인 신규입사자 + 완료율). "온보딩 진행중인 사람 누구야?" 같은 질문에 사용. 인사 권한 필요. |
| request_remote_work 확인 | admin.write | 외근을 신청합니다. "오늘 외근", "내일 고객사 외근 신청" 같은 명령에 사용. 사업장 밖에서 일하는 날을 승인받아 기록. |
| query_remote_work | company.read | 외근 현황. "오늘 외근 누구야?", "이번주 외근자", "외근 신청 대기" 같은 질문에 사용. 부서장은 본인 부서. 부서장 이상. |
| query_my_remote_work | company.read | 본인 외근 신청 내역. "내 외근 신청 어떻게 됐어?" 같은 질문에 사용. |
| create_job_grade 확인 | admin.write | 직급/직무등급을 정의합니다. "사원-대리-과장-차장-부장 직급 만들어", "G1~G5 레벨 체계" 같은 명령에 사용. level 은 서열(낮을수록 하위). 인사 권한 필요. |
| query_job_grades | company.read | 회사 직급/직무등급 체계 + 직급별 인원. "우리 직급 체계 어떻게 돼?", "직급별 몇 명?" 같은 질문에 사용. 담당자·권한 관리 권한 필요. |
| assign_job_grade 확인 | admin.write | 직원에게 직급을 부여/변경합니다. "이주영 과장으로", "박철수 G4 배정" 같은 명령에 사용. (승진 발령은 transfer_worker(promotion) 와 함께 쓰면 직책+직급 동시 반영). 인사 권한 필요. |
| query_grade_distribution | company.read | 직급별 인원 분포(피라미드 점검). "직급 분포 보여줘", "과장급 이상 몇 명?" 같은 질문에 사용. 담당자·권한 관리 권한 필요. |
| set_hr_permission 확인 | employee.write | 직원에게 인사 권한을 부여하거나 해제. "이주영 부서관리 권한 줘"(부서장 임명), "박철수 전사조회 권한 줘", "김영희 인사카드 조회 빼줘" 같은 명령. 부서관리 권한을 켜면 부서장 포털(자기 부서 출퇴근/연차 결재) 접근 가능. 대표(owner) 전용. |
| grant_mcp_role 확인 | admin.write | 직원의 AI비서(MCP) 권한 등급을 변경. "이주영을 인사 권한으로 올려줘", "박철수를 대표 권한으로", "김영희 일반 직원으로 내려줘". 등급: owner(대표)>hr_manager(인사 권한)>dept_manager(부서장)>employee(직원), auto=기본값. 대표(owner) 전용. |
| toggle_mcp_enabled 확인 | admin.write | 직원의 AI비서(MCP) 사용 자체를 허용/차단. "박철수 MCP 못 쓰게 꺼줘", "이주영 AI비서 다시 켜줘". 끄면 그 직원의 MCP 토큰 인증이 즉시 거부됨. 대표(owner) 전용. |
| submit_company_review 확인 | admin.write | 재직했거나 재직 중인 회사의 리뷰(별점+장단점)를 남깁니다. "전 회사 리뷰 남길래" 에 사용. 실제 소속 이력이 있는 회사만 가능하며 회사당 1개(재작성 시 갱신). 익명으로 공개됩니다. |
| query_company_reviews | company.read | 특정 회사의 리뷰(별점 평균 + 익명 장단점)를 조회합니다. "그 회사 평판 어때?", "리뷰 보여줘" 에 사용. 회사 미소속도 사용 가능. |
| submit_expense | expense.create | 경비(지출결의)를 제출합니다. 사용자가 영수증 사진을 보여주면 사진에서 금액·날짜·사용처·품목을 직접 읽어 items 배열로 정리해 이 도구로 제출하세요 (영수증 여러 장이면 items 여러 개). 이미지는 저장되지 않고 텍스트만 기록됩니다. "이 영수증 경비 처리해줘", "어제 회식비 8만원 올려줘" 같은 명령에 사용. |
| query_my_expenses | expense.read | 내가 제출한 경비(지출결의) 내역과 승인 상태를 조회합니다. "내 경비 처리됐어?", "이번달 경비 얼마 올렸지?" 같은 질문에 사용. |
| query_company_info | company.read | 우리 회사 기본정보와 근태/정책 설정 현황을 조회합니다. 수정 전에 현재 값을 확인할 때 사용. "우리 회사 정보 보여줘", "지금 연차 정책 어떻게 돼 있어?" 같은 질문에. 대표(owner) 전용. |
| update_company_info 확인 | admin.write | 회사 기본정보를 수정합니다. "우리 회사 상호를 인사책으로 바꿔", "대표자 이름 김보람으로", "회사 주소/업종/대표전화 수정" 같은 명령에. 바꿀 항목만 넘기면 나머지는 그대로 유지. 대표(owner) 전용. |
| update_attendance_policy 확인 | admin.write | 출퇴근(근태) 정책을 수정합니다. "GPS 반경 100미터로", "출퇴근 GPS 검증을 soft로 완화", "외근 자동전환 꺼줘", "회사 Wi-Fi 이름 설정" 같은 명령에. 대표(owner) 전용. 대상을 골라 거는 기능이 없습니다 — GPS 판정·외근 자동전환은 회사 전체에, Wi-Fi 이름·반경은 첫 번째 active 사업장에 적용됩니다. 사업장·부서·개인별로 다른 근무정책을 거는 것은 관리자 화면(회사 근무 방침)에서 합니다. |
| update_leave_policy 확인 | admin.write | 연차/휴가 정책을 수정합니다. "연차 기본 15일로", "3년차부터 2년마다 +1일, 상한 25일", "반차 허용", "무급휴가 켜줘", "주 4일 근무로" 같은 명령에. 바꿀 항목만 넘기면 나머지 유지. 대표(owner) 전용. |
| update_wage_policy 확인 | admin.write | 임금(수당 가산율)·야근 정책을 수정합니다. "연장근로 1.5배, 야간 0.5 가산", "휴일근로 2배로", "야근 시작 시각 19시로", "외근은 승인된 것만 야근 합산" 같은 명령에. 가산율은 한국 노동법 최저 미만이면 거부되고, 변경은 임금감사로그에 5년 보존 기록됩니다. 대표(owner) 전용. |
| list_my_capabilities | company.read | 현재 내 권한으로 쓸 수 있는 MCP 기능을 안내합니다. "뭐 할 수 있어?", "무슨 기능 있어?", "도움말", "사용법" 같은 질문에 사용. 처음 연결한 사용자가 가장 먼저 물어보는 질문. |