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

# 시작·공통 (start)

내 정보 · 오늘 요약 · guide · find_tools · run_read · run_write · undo.

## 할 수 있는 일

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

## 도구

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

| 이름 | 조회/쓰기 | 등급 | 필요 역할 | 범위 | 설명 | 부르는 길 |
|---|---|---|---|---|---|---|
| `whoami` | 조회 | 0 바로 조회 | employee (직원) | view | 나 · 회사 · 역할 · 허락 범위 · 쓸 수 있는 기능 요약. 처음 연결했거나 "나 누구야?", "뭐 할 수 있어?" 할 때. | 이름 그대로 |
| `today` | 조회 | 0 바로 조회 | employee (직원) | view | 오늘 꼭 볼 것 한 번에. 순서: 안 읽은 메신저 DM·나를 부른 방(따로 messenger 칸 · 안 읽은 채널 방은 수만) → 업무 댓글에서 나를 부른 것(질문 포함) → 받은 업무 중 오늘 기한·기한 지남 → 내가 결재할 것 → 안 읽은 회사 메일(같은 회사·답장, 따로 mail 칸) → 인사책 알림. 항목마다 앞 80자와 id. 알림·메신저 글은 읽음 처리하지 않아요. kind 로 한 칸만 볼 수 있어요(mentions 는 나를 부른 것만 · messenger 면 방 목록을 next_cursor 로 이어 봐요). 회사가 메신저·메일을 안 쓰면 그 칸만 state off. 기본 10개, 더 있으면 next_cursor. | 이름 그대로 |
| `today_hide` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | 봤으니 오늘 목록에서 뺍니다(today 가 준 항목 id). 인사책 알림은 그대로 두고 MCP 쪽 「봄」 표시만 남겨요. 5분 안에 되돌릴 수 있어요. | run_write |
| `search` | 조회 | 0 바로 조회 | employee (직원) | view | 찾기. kind=people 은 이름 · 부서 · 직책으로 우리 회사 사람 찾기. kind=mail 은 내 회사 메일을 받은편지함 · 보낸편지함 둘 다에서 보낸 사람 · 제목 · 본문으로 찾기(mailbox 로 inbox 또는 sent 만 좁힐 수 있고 결과마다 어느 함인지 나와요 · 내 메일함만 · 한 번에 몇 통인지는 메일이 정해요). kind=messenger 는 내가 든 사내 메신저 방의 글에서 찾기(최신 순 · 회사가 메신저를 안 쓰면 거절). kind=file 은 책Drive 에서 내가 열 수 있는 파일을 이름 · 올린 사람으로 찾기(결과의 file_id 로 file_access · file_link · file_share). kind=file_content 는 책Drive 에서 내가 열 수 있는 파일의 내용으로 찾기(드라이브가 아직 못 하면 state:blank). kind=task 는 업무 제목 · 본문으로 찾기(내가 볼 수 있는 업무만 · 결과의 id 로 task_get). kind=comment 는 업무 댓글 글로 찾기(그 업무를 볼 수 있을 때만 · 답에 업무 id). kind=approval 은 결재 제목 · 요약으로 찾기(내가 올렸거나 내 결재선에 든 것만 · 결과의 type 과 id 로 approval_get). task · comment 는 회사가 업무책을 안 쓰면 거절. 기본 10개, 더 있으면 has_more 와 next_cursor. 같은 이름이 여럿이면 되물어요. | 이름 그대로 |
| `guide` | 조회 | 0 바로 조회 | employee (직원) | view | 인사책 안내. q 에 사용자 말을 넣으면 앱 사용법(어디서 누르나 · 어떻게 하나 · 안 돼요) 안내를 앱 안 안내 그대로 찾아 줘요 — 사용법 질문은 이것부터. q 없이 topic 이면 내 역할용 안내 한 장: start · changes · tasks · approval · leave · attendance · today · search · mail · messenger · drive · team · company · join · personal · undo · errors · flows · flows-attendance · flows-leave · flows-approval · flows-tasks · flows-mail · flows-messenger · flows-people · flows-pay · flows-schedule · flows-company · flows-admin · flows-multi(기본 start). 바뀐 것은 changes. | 이름 그대로 |
| `list_my_capabilities` | 조회 | 0 바로 조회 | employee (직원) | view | 현재 내 권한으로 쓸 수 있는 MCP 기능을 안내합니다. "뭐 할 수 있어?", "무슨 기능 있어?", "도움말", "사용법" 같은 질문에 사용. 처음 연결한 사용자가 가장 먼저 물어보는 질문. | run_read |
| `daily_briefing` | 조회 | 0 바로 조회 | dept_manager (팀장 이상) | view | 오늘 회사 상황을 한 번에 브리핑합니다 (출근현황 + 승인 대기 + 이슈). "오늘 어때?", "회사 상황 브리핑", "오늘 브리핑해줘" 같은 질문에 사용. 부서장 이상. | run_read |
| `request_feature` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | ⭐ 사용자가 요청한 작업이 현재 MCP 도구로 불가능하거나 미구현일 때, 인사책 개발팀에 기능 개발을 요청합니다. 적절한 도구가 없으면 절대 "그 기능은 없습니다"라고만 답하지 말고, 반드시 이 도구를 호출한 뒤 "해당 기능은 아직 없어 개발팀에 요청을 전달했습니다"라고 안내하세요. 같은 기능이 여러 번 요청되면 수요로 집계됩니다. | run_write |
| `find_tools` | 조회 | 0 바로 조회 | employee (직원) | view | 기본 도구에 없는 일은 여기서 찾으세요. 하고 싶은 일을 말로 적으면 맞는 도구 이름·설명·인자 모양을 최대 5개 알려줘요. 조회는 run_read, 쓰기는 run_write 로 부릅니다. | 이름 그대로 |
| `run_read` | 조회 | 0 바로 조회 | employee (직원) | view | find_tools 로 찾은 조회 도구를 실행해요. 쓰기 도구는 run_write 로 부르세요. | 이름 그대로 |
| `run_write` | 조회 | 0 바로 조회 | employee (직원) | view | find_tools 로 찾은 쓰기 도구를 실행해요. 남에게 알림이 가는 일은 미리보기를 먼저 주니, 사람이 확인하면 같은 인자에 confirmation_id 를 넣어 다시 부르세요. | 이름 그대로 |
| `undo` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | 방금 한 1등급 일(내 것만 바뀌는 일)을 5분 안에 되돌립니다. 그 일의 결과에 있던 undo_id 로 부릅니다. | run_write |
| `notification_settings_get` | 조회 | 0 바로 조회 | employee (직원) | view | 내 알림 설정을 봅니다. "내 알림 뭐 켜져 있어?", "조용한 시간 몇 시야?" 같은 질문에 사용. 전체 푸시·알림함 켬/끔, 조용한 시간, 알림 종류(칸)마다 푸시·알림함이 켜져 있는지 알려 줘요. 보기만 해요. 바꾸려면 notification_settings_set. | run_read |
| `notification_settings_set` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | 내 알림 설정을 바꿉니다(내 것만). "휴가 알림 푸시 꺼줘", "밤 10시부터 아침 7시까지 조용히" 같은 명령에 사용. 알림 종류 하나는 category(notification_settings_get 결과의 key) + push/inapp(true=켬 · false=끔)로, 전체 푸시·알림함은 push_enabled/inapp_enabled 로, 조용한 시간은 quiet_hours_* 로 바꿔요. 바로 바뀌고 5분 안에 되돌릴 수 있어요. 출퇴근 리마인더 · PC 자동 출근은 앱에서 바꿔요. | run_write |

도구마다 따로 읽는 문서: [whoami](https://insacheck.com/docs/mcp/tools/whoami.md) · [today](https://insacheck.com/docs/mcp/tools/today.md) · [today_hide](https://insacheck.com/docs/mcp/tools/today_hide.md) · [search](https://insacheck.com/docs/mcp/tools/search.md) · [guide](https://insacheck.com/docs/mcp/tools/guide.md) · [list_my_capabilities](https://insacheck.com/docs/mcp/tools/list_my_capabilities.md) · [daily_briefing](https://insacheck.com/docs/mcp/tools/daily_briefing.md) · [request_feature](https://insacheck.com/docs/mcp/tools/request_feature.md) · [find_tools](https://insacheck.com/docs/mcp/tools/find_tools.md) · [run_read](https://insacheck.com/docs/mcp/tools/run_read.md) · [run_write](https://insacheck.com/docs/mcp/tools/run_write.md) · [undo](https://insacheck.com/docs/mcp/tools/undo.md) · [notification_settings_get](https://insacheck.com/docs/mcp/tools/notification_settings_get.md) · [notification_settings_set](https://insacheck.com/docs/mcp/tools/notification_settings_set.md)

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

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

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

- ATT-05 출퇴근을 어떻게 하는지 안내를 받아요. → https://insacheck.com/docs/mcp/attendance.md
- TSK-02 오늘 꼭 볼 업무를 봐요. → https://insacheck.com/docs/mcp/tasks.md
- MAIL-04 받은 메일을 보낸 사람이나 제목으로 찾아요. → https://insacheck.com/docs/mcp/mail.md
- MAIL-05 오늘 읽을 회사 메일만 한눈에 봐요. → https://insacheck.com/docs/mcp/mail.md
- MSG-08 오늘 온 인사책 알림을 봐요. → https://insacheck.com/docs/mcp/messenger.md
- MSG-12 지금 나에게 온 메신저가 있는지 봐요. → https://insacheck.com/docs/mcp/messenger.md
- MSG-13 메신저 글에서 말을 찾아요. → https://insacheck.com/docs/mcp/messenger.md
- ORG-01 내 이름과 회사, 역할을 확인해요. → https://insacheck.com/docs/mcp/people.md
- ORG-02 회사 사람을 이름이나 부서로 찾아요. → https://insacheck.com/docs/mcp/people.md
- ADM-09 오늘 아침 브리핑을 받아요. → https://insacheck.com/docs/mcp/admin.md
- MULTI-01 내가 누구인지 보고 오늘 할 일을 봐요. → https://insacheck.com/docs/mcp/multi.md
- MULTI-02 필요한 도구를 찾고 남은 연차를 읽어요. → https://insacheck.com/docs/mcp/multi.md
- 그 밖의 흐름은 영역별 문서에 있어요: https://insacheck.com/docs/mcp.md

## 안 되는 것 · 대안

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