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

# 회사 사이트 (site)

회사 홈페이지 고치기 · 발행 · 도메인.

## 할 수 있는 일

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

## 도구

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

| 이름 | 조회/쓰기 | 등급 | 필요 역할 | 범위 | 설명 | 부르는 길 |
|---|---|---|---|---|---|---|
| `site_files` | 조회 | 0 바로 조회 | employee (직원) | view | 회사 홈페이지(정적 사이트)의 한 판에 있는 파일 목록과 미리보기 주소를 보여 줍니다. "홈페이지 파일 보여줘", "첫 화면 HTML 열어줘" 같은 말에 사용. version 을 안 주면 가장 최근 판이고, "published" 는 지금 공개 중인 판이에요. path 를 주면 그 글자 파일(html · css · svg · xml · txt)의 본문을 줘요(너무 길면 앞부분만 주고 잘림을 알려요). 파일이 많으면 limit(기본 100 · 최대 300)과 cursor 로 이어 봐요 — 답의 has_more · next_cursor · total 을 보세요. 사이트 편집 권한이 있는 사람만 쓸 수 있어요. | run_read |
| `site_change` | 쓰기 | 1 바로 하고 5분 안에 되돌리기 | employee (직원) | mine | 회사 홈페이지를 고쳐 새 초안 판을 만듭니다. "홈페이지 첫 화면 문구 바꿔줘", "about.html 새로 만들어줘", "옛 이벤트 페이지 지워줘" 같은 말에 사용. 아직 공개되지 않아요 — 미리보기 주소로 먼저 확인하고, 공개는 배포 권한자가 site_publish 로 해요. changes 는 파일 하나당 한 칸이고 path 와 함께 content(글자) · content_base64(이미지 등) · delete(true) 중 하나만 넣어요(한 번에 20개까지). 받는 파일은 html · css · svg · xml · txt · 이미지 · 글꼴 · pdf 뿐이고 자바스크립트 파일은 저장되지 않아요. 외부 스크립트 · 추적 코드 · 다른 주소로 보내는 폼 같은 것은 초안으로 저장되지만 배포가 막혀요 — 결과의 blockers 에 이유가 줘요. 5분 안에 undo 로 이 초안을 버릴 수 있어요. 사이트 편집 권한이 필요해요. | run_write |
| `site_versions` | 조회 | 0 바로 조회 | employee (직원) | view | 회사 홈페이지의 판 목록(번호 · 상태 · 만든 때 · 메모 · 파일 수)과 사이트 상태(공개 판 · 공개 주소 · 연결한 도메인과 상태), 내 권한(편집 · 배포)을 보여 줍니다. "홈페이지 지금 어떤 판이 공개돼 있어?", "이전 판 뭐 있었지?", "도메인 연결 어떻게 됐어?" 같은 말에 사용. 도메인 연결을 기다리는 중이면 한 번 다시 확인해요. 사이트 편집 권한이 있는 사람만 쓸 수 있어요. | run_read |
| `site_publish` | 쓰기 | 3 앱 승인 | employee (직원) | money | 초안 판을 회사 홈페이지로 공개합니다. "이대로 배포해줘" 같은 말에 사용. 공개하면 방문자가 바로 보게 되어 인사책 앱에서 배포 권한자가 직접 승인해야 반영돼요 — 첫 호출은 승인 요청만 보내고(바뀌는 것 없음), 승인된 뒤 같은 인자로 다시 부르면 한 번 반영돼요. 공개 전에 서버가 스크립트 규칙을 다시 검사해요. 사이트 배포 권한 필요. | run_write |
| `site_rollback` | 쓰기 | 3 앱 승인 | employee (직원) | money | 홈페이지를 예전에 공개했던 판으로 되돌립니다. "어제 판으로 되돌려줘" 같은 말에 사용. 방문자가 보는 화면이 바뀌어 인사책 앱에서 배포 권한자가 직접 승인해야 반영돼요 — 첫 호출은 승인 요청만 보내고(바뀌는 것 없음), 승인된 뒤 같은 인자로 다시 부르면 한 번 반영돼요. 예전에 공개했던 판만 되돌릴 수 있어요(site_versions 의 상태 past). 사이트 배포 권한 필요. | run_write |
| `site_domain_connect` | 쓰기 | 3 앱 승인 | owner (대표) | money | 회사 도메인(예: www.example.com)을 홈페이지에 연결합니다. "우리 도메인으로 홈페이지 열리게 해줘" 같은 말에 사용. 방문 주소가 바뀌는 일이라 인사책 앱에서 대표가 직접 승인해야 반영돼요 — 첫 호출은 승인 요청만 보내고(바뀌는 것 없음), 승인된 뒤 같은 인자로 다시 부르면 한 번 반영돼요. 먼저 공개한 판이 있어야 해요. 대표만 쓸 수 있어요. | run_write |
| `site_perm_grant` | 쓰기 | 3 앱 승인 | hr_manager (관리자 이상) | admin | 직원에게 홈페이지 권한(사이트 편집 · 사이트 배포)을 주거나 거둡니다. "김하나에게 홈페이지 수정 권한 줘", "이영희 배포 권한 빼줘" 같은 말에 사용. 이 권한은 대표만 주고 거둘 수 있고, 권한이 바뀌는 일이라 인사책 앱에서 대표가 직접 승인해야 반영돼요 — 첫 호출은 승인 요청만 보내고(바뀌는 것 없음), 승인된 뒤 같은 인자로 다시 부르면 한 번 반영돼요. role 은 edit(초안 만들기) 또는 publish(공개 · 되돌리기 · 도메인 연결, 편집 포함), on 은 true(주기) 또는 false(거두기)예요. 같은 이름이 여러 명이면 후보를 돌려주니 고른 사람의 id 를 person_id 로 넣어 다시 부르세요. | run_write |
| `homepage_order` | 쓰기 | 3 앱 승인 | owner (대표) | money | 회사 홈페이지 제작을 주문합니다(우리 팀이 만들어 드리는 주문형). "홈페이지 만들어 줘", "고급형으로 주문해" 같은 말에 사용. plan 은 BASIC=기본형 190,000원 · PRO=고급형 690,000원 · PREMIUM=프리미엄형 1,490,000원. 돈이 걸린 일이라 인사책 앱에서 대표가 [승인]을 눌러야 주문이 접수돼요 — 승인 뒤 같은 인자로 다시 부르면 주문이 접수되고 결제 화면 주소가 와요. 접수만으로 돈이 나가지 않고, 결제는 대표가 인사책 결제 화면에서 직접 해요. 맞춤형은 주문이 아니라 상담이라 인사책 업무 지원에서 신청해요. 대표 전용. | run_write |
| `domain_search` | 조회 | 0 바로 조회 | hr_manager (관리자 이상) | view | 회사 메일에 쓸 새 도메인을 찾아봅니다. "mycompany 도메인 살 수 있어?" 같은 말에 사용. 이름 하나를 넣으면 Cloudflare 가 파는 확장자(com · net · io …, 인기순)마다 살 수 있는지와 값, 지금 포인트 잔액을 알려 줘요. 보기만 하고 아무것도 사지 않아요. 인사 권한 필요. | run_read |
| `domain_status` | 조회 | 0 바로 조회 | hr_manager (관리자 이상) | view | 우리 회사가 산 도메인의 진행 상태를 봅니다. "mycompany.com 어디까지 됐어?" 같은 말에 사용. 주문 진행(결제 · 등록 · 메일 연결), DNS 연결 상태, 만료일을 알려 줘요. 보기만 해요. 인사 권한 필요. | run_read |
| `domain_buy` | 쓰기 | 3 앱 승인 | owner (대표) | money | 회사 메일에 쓸 새 도메인을 삽니다. "mycompany.com 으로 사줘" 같은 명령에 사용. 포인트가 바로 나가는 돈 일이라 인사책 앱에서 대표가 직접 승인해야 접수돼요 — 승인 전에는 아무것도 바뀌지 않아요. 승인한 뒤 같은 인자로 다시 부르면 한 번만 실행돼요. 먼저 domain_search 로 살 수 있는지 보세요. 대표 권한 필요. | run_write |
| `domain_renew_dns` | 쓰기 | 3 앱 승인 | owner (대표) | money | 우리 회사 도메인을 연장하거나 자동 연장을 끄거나 DNS 상태를 봅니다. action 으로 고르세요: renew = 포인트로 1년 연장 · cancel = 자동 연장 끄기 · dns_status = DNS 연결 상태 보기. 돈 · 설정이 바뀌는 일이라 인사책 앱에서 대표가 직접 승인해야 반영돼요 — 승인 전에는 아무것도 바뀌지 않아요. 승인한 뒤 같은 인자로 다시 부르면 한 번만 실행돼요. 대표 권한 필요. | run_write |

도구마다 따로 읽는 문서: [site_files](https://insacheck.com/docs/mcp/tools/site_files.md) · [site_change](https://insacheck.com/docs/mcp/tools/site_change.md) · [site_versions](https://insacheck.com/docs/mcp/tools/site_versions.md) · [site_publish](https://insacheck.com/docs/mcp/tools/site_publish.md) · [site_rollback](https://insacheck.com/docs/mcp/tools/site_rollback.md) · [site_domain_connect](https://insacheck.com/docs/mcp/tools/site_domain_connect.md) · [site_perm_grant](https://insacheck.com/docs/mcp/tools/site_perm_grant.md) · [homepage_order](https://insacheck.com/docs/mcp/tools/homepage_order.md) · [domain_search](https://insacheck.com/docs/mcp/tools/domain_search.md) · [domain_status](https://insacheck.com/docs/mcp/tools/domain_status.md) · [domain_buy](https://insacheck.com/docs/mcp/tools/domain_buy.md) · [domain_renew_dns](https://insacheck.com/docs/mcp/tools/domain_renew_dns.md)

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

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

## 안 되는 것 · 대안

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