설치 명령
Claude·Cursor 등 MCP 지원 AI · 무료 · 소스 공개(MIT)

대화창에서
노동 계산과 서류를
바로 처리합니다

AI에 연결해 쓰는 도구 묶음입니다. 퇴직금·주휴수당·연차를 계산하고, 근로계약서와 건강보험 신고서를 만들고, 취업규칙에 개정 법령이 반영됐는지 짚습니다. 일의 무늬 사이트 계산기와 같은 엔진이라 같은 입력이면 같은 값이 나옵니다.

입력값을 저장하지 않습니다 · 신고를 접수하지 않습니다 · 주민등록번호는 내 PC 안에서만 다룹니다

 묶음 고르기 · 키를 눌러 켜고 끕니다
claude mcp add --scope user k-labor "--" npx -y k-labor mcp --groups "contract,calc"
켠 도구 17개이 중 원격 주소에도 있는 것 16개
45개9개 묶음, 필요한 것만 켭니다
25개설치 없이 원격 주소로
같은 값사이트 계산기와 같은 엔진
대화에 싣지 않음주민등록번호는 PC 안에서만
01 · 연결 방법

내 PC에 설치하거나, 주소만 넣거나

설치하면 전 묶음을 씁니다. 원격 주소는 설치가 필요 없지만 계산·점검 도구만 붙고, 파일·팩스·법제처 조회처럼 내 PC나 내 계정이 필요한 도구는 빠집니다.

PC

내 PC에 설치

npx -y k-labor mcp
쓰는 곳
Claude Code · Claude Desktop · Cursor · Windsurf
도구
9개 묶음 45개 전부
필요한 것
Node.js 20 이상
여기서만
계약서·신고서 파일 만들기, 팩스·문자, 취업규칙 파일 읽기, 법제처 실시간 조회
URL

원격 주소로 연결

https://yellowenvelope.kr/api/mcp/mcp
쓰는 곳
claude.ai · Claude 앱의 커스텀 커넥터
도구
25개 — 근로계약서 설계·점검, 임금·수당, 연차, 세금, 사업주 의무, 노사협의회 계산
필요한 것
없음. 주소만 넣습니다
빠지는 것
건강보험 신고·팩스·문자·취업규칙·법령 묶음 전체, 근로계약서 파일 저장, 노사협의회 서류·기록
입력값
도구에 넣은 값이 일의 무늬 서버로 전송됩니다. 저장하지 않습니다
02 · 묶음

아홉 개 묶음 가운데 필요한 것만 켭니다

아무것도 고르지 않으면 전 묶음이 켜집니다. 켠 도구가 많을수록 AI가 고를 것이 많아지니, 자주 쓰는 묶음만 켜는 편이 낫습니다.

건보

건강보험 신고

--groups nhis · 도구 2개

주소나 사업자등록번호로 건강보험 관할 지사와 자격 담당 전화·팩스를 찾습니다. 자격취득·상실 신고서와 늦어진 사유를 적은 사업주확인서를 공식 서식 PDF 한 파일로 만듭니다.

내 PC에서만
팩스

팩스·문자

--groups popbill · 도구 5개

내 팝빌 계정과 내 번호로 팩스·문자를 보내고 결과를 조회합니다. 잔액과 등록된 발신번호도 확인합니다. 실제 전송은 AI가 보내기 표시(confirm: true)를 넣어 부른 호출에서만 합니다. AI 앱의 도구 승인 창을 켜 두고 미리보기를 읽은 뒤 승인하세요.

내 PC에서만 팝빌 계정 필요
계약

근로계약서

--groups contract · 도구 3개

월 총액이나 시급과 근무형태로 임금 항목을 나눠 설계하고, 이미 쓴 계약서를 항목별로 점검합니다. 엑셀·한글·PDF 파일 저장은 내 PC에서만 됩니다.

원격 2개 파일 저장은 내 PC
계산

임금·수당 계산

--groups calc · 도구 14개

최저임금 비교, 주휴수당, 상시 근로자 수, 실수령액, 해고예고수당, 연차수당, 퇴직금, 공휴일 근로 수당, 일할계산, 휴업수당, 통상임금 점검, 지연이자, 3.3% 계약의 근로자성, 월급 대조.

원격 14개 전부
연차

연차

--groups leave · 도구 3개

입사일 기준 연차 발생일수, 퇴직할 때 입사일 기준과 회계연도 기준 중 유리한 쪽으로 남은 연차 정산, 연차 요건이 되는 출근율(1년 80%)을 셉니다.

원격 3개 전부
세금

세금

--groups tax · 도구 3개

퇴직소득세·지방소득세(국세청 계산 프로그램과 같은 칸 순서), 중도퇴사자 연말정산 예상, 일용근로소득 원천징수를 계산합니다.

원격 3개 전부
의무

사업주 의무

--groups duties · 도구 1개

상시 근로자 수에 맞는 사업주 의무, 법정 의무교육, 위반 시 제재를 목록으로 냅니다. 다음 규모가 되면 더 생기는 의무도 알려 줍니다.

원격 1개
규칙

취업규칙·법령

--groups work-rules · 도구 6개

노동법 개정·시행 예정 목록, 그날 시행 중인 조문 원문, 두 시점 판의 조문 비교를 법제처에서 가져옵니다. 취업규칙에 그 뒤 개정이 반영됐는지 표준취업규칙 조문에 짝지어 대조하고 신고 서류를 만듭니다.

내 PC에서만 법제처 OC 필요
노사

노사협의회

--groups nosa · 도구 8개

설치의무와 근로자위원 선출방식·정족수·기한을 계산하고, 회의 하나의 통보 기한·의결을 확인합니다. 선거·회의 서류와 회의록 기록은 내 PC에서 파일로 만듭니다. 협의회규정 점검(읽기만 하고 파일은 만들지 않음)과 신·구조문대비표는 다음 판(0.2.1)에 들어갑니다.

원격 2개 서류·기록은 내 PC
03 · 설치

명령 한 줄이면 등록됩니다

설치 파일을 따로 받지 않습니다. AI가 도구를 부를 때 npm에서 k-labor를 받아 내 PC에서 실행합니다.

  1. Node.js 20 이상 확인

    명령 창에서 아래를 실행해 v20 이상이 나오면 됩니다. 없으면 nodejs.org에서 LTS 판을 설치합니다.

    node -v
  2. AI에 등록

    Claude Code는 명령 한 줄입니다. 묶음을 고르려면 맨 위 묶음 고르기에서 만든 명령을 씁니다.

    claude mcp add --scope user k-labor "--" npx -y k-labor mcp

    Claude Desktop은 설정 파일 claude_desktop_config.json에 넣습니다.

    {
      "mcpServers": {
        "k-labor": { "command": "npx", "args": ["-y", "k-labor", "mcp"] }
      }
    }

    Cursor·Windsurf 등도 같은 command·args를 그 프로그램의 MCP 설정에 넣습니다.

  3. 다시 열고 말 걸기

    Claude Desktop은 껐다 켜고, Claude Code는 새 대화를 엽니다. 「k-labor 도구 목록 보여 줘」라고 하면 켜진 도구가 나옵니다.

설치 없이 — 원격 주소

claude.ai에서 설정 → 커넥터 → 커스텀 커넥터 추가를 누르고 아래 주소를 넣습니다. 도구 25개가 붙습니다.

https://yellowenvelope.kr/api/mcp/mcp

Windows에서 Claude Desktop이 npx를 못 찾으면

cmd /c로 감쌉니다.

{
  "mcpServers": {
    "k-labor": { "command": "cmd", "args": ["/c", "npx", "-y", "k-labor", "mcp"] }
  }
}
04 · 말 거는 법

평소 말로 부탁하면 AI가 도구를 고릅니다

도구 이름을 몰라도 됩니다. 숫자·날짜·주소처럼 계산에 필요한 값을 함께 말하면 한 번에 끝납니다.

시급 10,320원, 주 22.5시간이면 주휴수당 얼마야?

임금·수당주휴수당 계산

주4 월화수목 10:00~22:00, 휴게 155분, 월 260만원으로 근로계약서 임금 구성 짜 줘.

근로계약서항목별 시간·금액

2014년 1월 2일 입사, 2026년 7월 15일 퇴사, 퇴직금 6,000만원이면 퇴직소득세 얼마야?

세금퇴직소득세·지방소득세

상시 근로자 7명 사업장이 지켜야 할 의무 알려 줘.

사업주 의무의무·교육·제재 목록

충북 청주시 상당구 상당로 155 사업장의 건강보험 관할 지사 팩스 번호 찾아줘.

건강보험 신고관할 지사·담당 번호 내 PC

우리 취업규칙(C:/규정/취업규칙.hwpx) 2024-03-01 개정본인데, 그 뒤 개정 법령이 반영됐는지 봐 줘.

취업규칙·법령조문별 대조 내 PC
05 · 팩스·문자와 법제처

보내는 도구는 내 계정 값을 넣어야 켜집니다

이 패키지에는 기본 계정도 기본 발신번호도 없습니다. 값이 빠지면 무엇이 빠졌는지 알려 주고 아무것도 보내지 않습니다.

이름뜻
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도 막습니다.

06 · 개인정보

주민등록번호는 AI 대화에 실리지 않습니다

계산·계약 도구는 주민등록번호를 받지 않습니다. 신고서처럼 꼭 필요한 곳은 명단을 파일 경로로만 받아 도구가 직접 읽습니다.

내 PC에 설치했을 때

명단·서류

신고서 명단 파일(peopleFile)신고서 PDF취업규칙 본문·파일계약서 파일

설치판에서 밖으로 나가는 것은 세 가지뿐

  1. 사업자등록번호로 관할 지사를 찾을 때 그 번호만 일의 무늬로 보냅니다. 주소로 찾으면 아무것도 나가지 않습니다.
  2. 팩스·문자는 본인 팝빌 계정으로 보냅니다.
  3. 법제처에는 법령명·날짜·판 번호만 묻습니다.

원격 주소로 쓸 때

도구에 넣는 값이 일의 무늬 서버로 전송돼 계산됩니다. 주민등록번호를 받는 도구는 원격 주소에 없습니다.

✕ 일의 무늬는 입력값을 저장하거나 모으지 않습니다

응답에서도 가립니다

도구 응답에 주민등록번호 모양이 섞이면 나가기 전에 가립니다. 근로계약서 점검은 입력에 주민등록번호 모양이 있으면 점검하지 않습니다.

보내기 전에 미리보기

팩스·문자는 AI가 보내기 표시(confirm: true)를 넣어 부른 호출에서만 실제로 나가고, 그 전에는 미리보기만 돌려줍니다. 이 표시는 AI가 넣는 값이니 AI 앱의 도구 승인 창을 켜 두고 미리보기를 읽은 뒤 승인하세요. 문자 본문에 주민등록번호 모양이 있으면 보내지 않습니다.

07 · 문제 해결

안 될 때 먼저 볼 것

Claude Desktop에 도구가 안 보여요

설정 파일을 고친 뒤 Claude Desktop을 완전히 껐다 켜야 합니다. Windows에서 npx를 못 찾는 경우가 많으니 위의 cmd /c 설정으로 바꿔 보세요.

서버가 뜨지 않고 묶음 목록만 나와요

없는 묶음 이름을 넣은 경우입니다. 묶음 이름은 nhis·popbill·contract·calc·leave·tax·duties·work-rules·nosa입니다. fax·sms는 popbill로 받습니다.

npx -y k-labor --help
Node 버전 오류가 나요

node -v가 v20보다 낮으면 nodejs.org에서 LTS 판으로 올립니다.

원격 주소에 없는 도구가 있어요

정상입니다. 원격 주소에는 계산·점검 도구 25개만 있습니다. 건강보험 신고(관할 지사 찾기 포함)·팩스·문자·취업규칙·법령 묶음 전체, 근로계약서 파일 저장, 노사협의회 서류·기록은 내 PC 설치판에만 있습니다. 이것들이 필요하면 내 PC에 설치하세요.

팩스가 안 나가요

응답에 빠진 값이 적혀 있습니다. 발신번호가 팝빌에 등록돼 있는지, POPBILL_IS_TEST가 기본값(테스트환경)으로 남아 있지 않은지 확인하세요.

08 · 자주 묻는 질문

묻는 질문

돈이 드나요?

도구는 무료이고 소스 코드도 MIT 라이선스로 공개돼 있습니다. 팩스·문자는 본인 팝빌 요금이 듭니다.

사이트 계산기와 결과가 같나요?

같은 엔진을 묶었습니다. 같은 입력이면 사이트 화면과 같은 값이 나옵니다.

어떤 AI에서 되나요?

MCP를 지원하는 도구에서 됩니다. Claude Code, Claude Desktop, claude.ai 커스텀 커넥터, Cursor, Windsurf 등입니다.

결과를 그대로 써도 되나요?

계산과 대조의 1차 결과입니다. 취업규칙 대조는 낱말을 맞춰 본 것이고, 바꿀 문안은 법이 정한 최저 기준이라 회사 사정에 맞게 확인한 뒤 씁니다.

09 · 하지 않는 일

이 도구가 하지 않는 일

  • 4대보험·취업규칙 신고를 접수하지 않습니다. 서류를 만들고 날인이 필요한 곳을 알려 주는 데까지입니다
  • 받을 팩스 번호를 정해 두지 않습니다. 관할 지사 찾기로 나온 번호를 사람이 확인해 넣도록 안내합니다
  • 일의 무늬는 입력값을 저장하거나 모으지 않습니다
  • 기본 팝빌 계정·기본 발신번호를 넣어 두지 않습니다
  • 서명·날인 칸을 채우지 않습니다

자주 쓰는 묶음만 골라 연결하세요

명령 한 줄을 붙여 넣거나, claude.ai에 주소 하나를 넣으면 됩니다.