내 PC에 설치
npx -y k-labor mcp- 쓰는 곳
- Claude Code · Claude Desktop · Cursor · Windsurf
- 도구
- 9개 묶음 45개 전부
- 필요한 것
- Node.js 20 이상
- 여기서만
- 계약서·신고서 파일 만들기, 팩스·문자, 취업규칙 파일 읽기, 법제처 실시간 조회
AI에 연결해 쓰는 도구 묶음입니다. 퇴직금·주휴수당·연차를 계산하고, 근로계약서와 건강보험 신고서를 만들고, 취업규칙에 개정 법령이 반영됐는지 짚습니다. 일의 무늬 사이트 계산기와 같은 엔진이라 같은 입력이면 같은 값이 나옵니다.
입력값을 저장하지 않습니다 · 신고를 접수하지 않습니다 · 주민등록번호는 내 PC 안에서만 다룹니다
설치하면 전 묶음을 씁니다. 원격 주소는 설치가 필요 없지만 계산·점검 도구만 붙고, 파일·팩스·법제처 조회처럼 내 PC나 내 계정이 필요한 도구는 빠집니다.
아무것도 고르지 않으면 전 묶음이 켜집니다. 켠 도구가 많을수록 AI가 고를 것이 많아지니, 자주 쓰는 묶음만 켜는 편이 낫습니다.
주소나 사업자등록번호로 건강보험 관할 지사와 자격 담당 전화·팩스를 찾습니다. 자격취득·상실 신고서와 늦어진 사유를 적은 사업주확인서를 공식 서식 PDF 한 파일로 만듭니다.
내 팝빌 계정과 내 번호로 팩스·문자를 보내고 결과를 조회합니다. 잔액과 등록된 발신번호도 확인합니다. 실제 전송은 AI가 보내기 표시(confirm: true)를 넣어 부른 호출에서만 합니다. AI 앱의 도구 승인 창을 켜 두고 미리보기를 읽은 뒤 승인하세요.
월 총액이나 시급과 근무형태로 임금 항목을 나눠 설계하고, 이미 쓴 계약서를 항목별로 점검합니다. 엑셀·한글·PDF 파일 저장은 내 PC에서만 됩니다.
최저임금 비교, 주휴수당, 상시 근로자 수, 실수령액, 해고예고수당, 연차수당, 퇴직금, 공휴일 근로 수당, 일할계산, 휴업수당, 통상임금 점검, 지연이자, 3.3% 계약의 근로자성, 월급 대조.
입사일 기준 연차 발생일수, 퇴직할 때 입사일 기준과 회계연도 기준 중 유리한 쪽으로 남은 연차 정산, 연차 요건이 되는 출근율(1년 80%)을 셉니다.
퇴직소득세·지방소득세(국세청 계산 프로그램과 같은 칸 순서), 중도퇴사자 연말정산 예상, 일용근로소득 원천징수를 계산합니다.
상시 근로자 수에 맞는 사업주 의무, 법정 의무교육, 위반 시 제재를 목록으로 냅니다. 다음 규모가 되면 더 생기는 의무도 알려 줍니다.
노동법 개정·시행 예정 목록, 그날 시행 중인 조문 원문, 두 시점 판의 조문 비교를 법제처에서 가져옵니다. 취업규칙에 그 뒤 개정이 반영됐는지 표준취업규칙 조문에 짝지어 대조하고 신고 서류를 만듭니다.
설치의무와 근로자위원 선출방식·정족수·기한을 계산하고, 회의 하나의 통보 기한·의결을 확인합니다. 선거·회의 서류와 회의록 기록은 내 PC에서 파일로 만듭니다. 협의회규정 점검(읽기만 하고 파일은 만들지 않음)과 신·구조문대비표는 다음 판(0.2.1)에 들어갑니다.
설치 파일을 따로 받지 않습니다. AI가 도구를 부를 때 npm에서 k-labor를 받아 내 PC에서 실행합니다.
명령 창에서 아래를 실행해 v20 이상이 나오면 됩니다. 없으면 nodejs.org에서 LTS 판을 설치합니다.
node -vClaude Code는 명령 한 줄입니다. 묶음을 고르려면 맨 위 묶음 고르기에서 만든 명령을 씁니다.
claude mcp add --scope user k-labor "--" npx -y k-labor mcpClaude Desktop은 설정 파일 claude_desktop_config.json에 넣습니다.
{
"mcpServers": {
"k-labor": { "command": "npx", "args": ["-y", "k-labor", "mcp"] }
}
}Cursor·Windsurf 등도 같은 command·args를 그 프로그램의 MCP 설정에 넣습니다.
Claude Desktop은 껐다 켜고, Claude Code는 새 대화를 엽니다. 「k-labor 도구 목록 보여 줘」라고 하면 켜진 도구가 나옵니다.
claude.ai에서 설정 → 커넥터 → 커스텀 커넥터 추가를 누르고 아래 주소를 넣습니다. 도구 25개가 붙습니다.
https://yellowenvelope.kr/api/mcp/mcpcmd /c로 감쌉니다.
{
"mcpServers": {
"k-labor": { "command": "cmd", "args": ["/c", "npx", "-y", "k-labor", "mcp"] }
}
}도구 이름을 몰라도 됩니다. 숫자·날짜·주소처럼 계산에 필요한 값을 함께 말하면 한 번에 끝납니다.
시급 10,320원, 주 22.5시간이면 주휴수당 얼마야?
주4 월화수목 10:00~22:00, 휴게 155분, 월 260만원으로 근로계약서 임금 구성 짜 줘.
2014년 1월 2일 입사, 2026년 7월 15일 퇴사, 퇴직금 6,000만원이면 퇴직소득세 얼마야?
상시 근로자 7명 사업장이 지켜야 할 의무 알려 줘.
충북 청주시 상당구 상당로 155 사업장의 건강보험 관할 지사 팩스 번호 찾아줘.
우리 취업규칙(C:/규정/취업규칙.hwpx) 2024-03-01 개정본인데, 그 뒤 개정 법령이 반영됐는지 봐 줘.
이 패키지에는 기본 계정도 기본 발신번호도 없습니다. 값이 빠지면 무엇이 빠졌는지 알려 주고 아무것도 보내지 않습니다.
| 이름 | 뜻 |
|---|---|
POPBILL_LINK_ID | 팝빌 연동 링크아이디 |
POPBILL_SECRET_KEY | 팝빌 연동 비밀키 |
POPBILL_CORP_NUM | 팝빌에 가입한 사업자등록번호(숫자 10자리) |
POPBILL_FAX_SENDER | 팝빌에 등록한 팩스 발신번호 |
POPBILL_SMS_SENDER | 팝빌에 등록한 문자 발신번호 |
POPBILL_IS_TEST | 기본은 테스트환경. 실제로 보내려면 false |
LAW_OC | 법제처 국가법령정보 Open API 이용자 ID. 없으면 묶어 둔 자료로만 답합니다 |
Claude Desktop은 설정 파일의 "env" 칸에, Claude Code는 등록할 때 -e 이름=값으로 넣습니다.
claude mcp add --scope user k-labor -e LAW_OC=내OC "--" npx -y k-labor mcp --groups work-rules내OC를 법제처에서 받은 ID로 바꿉니다. "--"의 따옴표는 PowerShell에서 --가 빠지지 않게 하려는 것으로, 다른 명령 창에서도 그대로 써도 됩니다.
법제처는 OC를 신청할 때 등록한 IP·도메인이 아니면 「사용자 정보 검증에 실패하였습니다」로 거절합니다. 해외 IP도 막습니다.
계산·계약 도구는 주민등록번호를 받지 않습니다. 신고서처럼 꼭 필요한 곳은 명단을 파일 경로로만 받아 도구가 직접 읽습니다.
도구에 넣는 값이 일의 무늬 서버로 전송돼 계산됩니다. 주민등록번호를 받는 도구는 원격 주소에 없습니다.
✕ 일의 무늬는 입력값을 저장하거나 모으지 않습니다
도구 응답에 주민등록번호 모양이 섞이면 나가기 전에 가립니다. 근로계약서 점검은 입력에 주민등록번호 모양이 있으면 점검하지 않습니다.
팩스·문자는 AI가 보내기 표시(confirm: true)를 넣어 부른 호출에서만 실제로 나가고, 그 전에는 미리보기만 돌려줍니다. 이 표시는 AI가 넣는 값이니 AI 앱의 도구 승인 창을 켜 두고 미리보기를 읽은 뒤 승인하세요. 문자 본문에 주민등록번호 모양이 있으면 보내지 않습니다.
설정 파일을 고친 뒤 Claude Desktop을 완전히 껐다 켜야 합니다. Windows에서 npx를 못 찾는 경우가 많으니 위의 cmd /c 설정으로 바꿔 보세요.
없는 묶음 이름을 넣은 경우입니다. 묶음 이름은 nhis·popbill·contract·calc·leave·tax·duties·work-rules·nosa입니다. fax·sms는 popbill로 받습니다.
npx -y k-labor --helpnode -v가 v20보다 낮으면 nodejs.org에서 LTS 판으로 올립니다.
정상입니다. 원격 주소에는 계산·점검 도구 25개만 있습니다. 건강보험 신고(관할 지사 찾기 포함)·팩스·문자·취업규칙·법령 묶음 전체, 근로계약서 파일 저장, 노사협의회 서류·기록은 내 PC 설치판에만 있습니다. 이것들이 필요하면 내 PC에 설치하세요.
응답에 빠진 값이 적혀 있습니다. 발신번호가 팝빌에 등록돼 있는지, POPBILL_IS_TEST가 기본값(테스트환경)으로 남아 있지 않은지 확인하세요.
도구는 무료이고 소스 코드도 MIT 라이선스로 공개돼 있습니다. 팩스·문자는 본인 팝빌 요금이 듭니다.
같은 엔진을 묶었습니다. 같은 입력이면 사이트 화면과 같은 값이 나옵니다.
MCP를 지원하는 도구에서 됩니다. Claude Code, Claude Desktop, claude.ai 커스텀 커넥터, Cursor, Windsurf 등입니다.
계산과 대조의 1차 결과입니다. 취업규칙 대조는 낱말을 맞춰 본 것이고, 바꿀 문안은 법이 정한 최저 기준이라 회사 사정에 맞게 확인한 뒤 씁니다.