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

# 파일 (files)

내 드라이브 파일 찾기 · 올리기 · 링크 · 공유.

## 할 수 있는 일

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

## 도구

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

| 이름 | 조회/쓰기 | 등급 | 필요 역할 | 범위 | 설명 | 부르는 길 |
|---|---|---|---|---|---|---|
| `file_access` | 조회 | 0 바로 조회 | employee (직원) | view | 파일 하나에 누가 어떤 권한으로 들어올 수 있는지 보여 줍니다. "이 파일 누가 볼 수 있어?" 같은 말에 사용. file_id 는 search(kind=file)로 찾아요. 읽기만 하고 아무것도 바꾸지 않아요. | run_read |
| `file_link` | 조회 | 0 바로 조회 | employee (직원) | view | 파일을 내려받는 주소를 줍니다(10분 안에 열어야 해요). "그 파일 링크 줘" 같은 말에 사용. file_id 는 search(kind=file)로 찾아요. 주소를 열 때 책Drive 가 권한을 다시 확인해요. | run_read |
| `file_put` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | 회사 공유함(책Drive 드라이브)에 파일을 올립니다 — 올린 파일은 회사 모든 직원이 볼 수 있고, 개인 저장은 없어요. content_base64(해독 뒤 1MB 이하)를 주면 바로 올리고, 5분 안에 undo 로 휴지통에 보낼 수 있어요. 내용을 안 주거나 size_bytes 가 1MB 를 넘으면 올리기 주소(PUT)를 돌려줘요. 같은 이름이 있으면 이름 뒤에 (2) 를 붙여요. 메일 첨부(from_mail)를 올릴 때는 mail_get 이 준 메일 id 와 첨부 attachment_id 를 { id, attachment_id } 로 주세요(내 메일함의 첨부만 · 8MB 까지 · name 을 안 주면 첨부 이름으로 올려요 · content_base64 와 같이 못 써요). | run_write |
| `file_share` | 쓰기 | 2 미리보기 → 확정 | employee (직원) | send | 내 책Drive 파일을 같은 회사 직원에게 공유합니다. "이 파일 김대리한테 공유해줘", "개발팀에 공유해줘" 같은 말에 사용. 사람(person 또는 person_id) 하나나 부서(dept 또는 dept_id) 하나를 주세요 — 부서면 그 부서 재직자 전원(나 제외)에게 가요. 먼저 받는 사람 이름 전부를 보여 주는 확인이 나오고, 사용자가 승인하면 confirmation_id 를 붙여 다시 부르세요. 같은 이름이 여럿이면 후보를 돌려주니 고른 id 를 person_id(부서는 dept_id)로 넣어 다시 부르세요. 권한(role)은 view(보기) · comment(댓글) · edit(편집), 기본 view. | run_write |
| `file_list` | 조회 | 0 바로 조회 | employee (직원) | view | 회사 공유함(책Drive 드라이브)의 파일·폴더 목록을 보여 줍니다. "공유함에 뭐 있어?", "방금 올린 파일 찾아줘", "그 폴더 안 파일 보여줘", "나한테 공유된 파일" 같은 말에 사용. where=shared(기본)는 회사 공유함 · received 는 나에게 공유받은 파일. folder_id 는 이 도구 답의 폴더 id. 이름·크기·종류·올린 사람·날짜만 보여 주고 읽기만 해요 — 받기 주소는 file_link 로 받아요. | run_read |

도구마다 따로 읽는 문서: [file_access](https://insacheck.com/docs/mcp/tools/file_access.md) · [file_link](https://insacheck.com/docs/mcp/tools/file_link.md) · [file_put](https://insacheck.com/docs/mcp/tools/file_put.md) · [file_share](https://insacheck.com/docs/mcp/tools/file_share.md) · [file_list](https://insacheck.com/docs/mcp/tools/file_list.md)

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

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

## 안 되는 것 · 대안

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