한국 계약서 자동생성 MCP 설치·사용법 — 한국 사업자용 9종 계약서를 Claude Code에서

Q: korean-contracts MCP는 API 키가 필요한가요?

아닙니다. korean-contracts MCP는 외부 API를 사용하지 않아 별도 API 키 발급이 필요하지 않습니다. 저장소를 클론하고 npm install만 하면 바로 사용할 수 있습니다.

Q: Claude Desktop에서도 사용할 수 있나요?

네. Claude Desktop의 경우 사용자 홈 디렉터리에 위치한 claude_desktop_config.json 파일에 mcpServers 항목을 추가하면 됩니다. 설정 방식은 이 가이드의 '클라이언트별 설정' 섹션을 참고하세요.

Q: 개인정보가 외부 서버로 전송되나요?

아닙니다. korean-contracts MCP는 개인정보 보호 서버로 설명되며, 외부 API 호출 없이 로컬에서 동작합니다. 계약 당사자 정보 등 민감한 데이터가 외부로 전송되지 않습니다.

Q: npm install 후 MCP 서버가 실행되지 않으면 어떻게 하나요?

Node.js 버전이 18 미만이면 호환성 문제가 발생할 수 있습니다. node --version으로 버전을 확인하고, 필요하면 최신 LTS 버전으로 업그레이드하세요. .mcp.json의 command 경로가 실제 빌드 결과물과 일치하는지도 확인해 주세요.

한국 사업자라면 계약서를 작성할 때마다 양식을 찾고, 조항을 수정하고, 검토하는 데 많은 시간을 씁니다. Korean-contracts MCP를 Claude Code에 연결하면, 채팅 한 줄로 한국 사업자용 9종 계약서 초안을 즉시 생성할 수 있습니다. 외부 API 키가 필요 없고, 계약 당사자 정보가 외부 서버로 전송되지 않아 개인정보 보호 측면에서도 안전합니다. 이 가이드는 저장소 클론부터 Claude Code 연동, 실제 계약서 생성까지 전 과정을 단계별로 설명합니다.

왜 계약서 작성에 MCP가 필요한가

한국 사업 현장에서 계약서는 거의 모든 거래에 등장합니다. 근로계약, 용역 발주, 비밀유지, 임대차, 공급 계약 — 각 유형마다 법적으로 반드시 포함해야 할 조항이 다르고, 누락하면 분쟁 발생 시 불리해질 수 있습니다.

기존 방식의 한계는 다음과 같습니다.

방식	문제점
기존 양식 재사용	업데이트 안 된 조항, 맞춤 수정 누락
법무법인 의뢰	초안 작성에도 비용·시간 소요
일반 AI(웹 ChatGPT 등)	한국법 맥락 약함, 입력 정보 서버 저장 우려
Korean-contracts MCP	한국 사업자 맞춤 템플릿, 로컬 실행, 즉시 생성

MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구를 표준화된 방식으로 호출하는 프로토콜입니다. Korean-contracts MCP를 연결하면 아래와 같은 흐름으로 계약서가 생성됩니다.

사용자 요청 (Claude Code 채팅)
        │
        ▼
  Claude (AI 추론 + 도구 선택)
        │  MCP 도구 호출
        ▼
  korean-contracts MCP 서버 (로컬)
        │  계약서 템플릿 처리
        ▼
  계약서 초안 (마크다운/텍스트)
        │
        ▼
  Claude → 검토·수정 후 최종본

외부 API 호출 단계가 없기 때문에 계약 당사자 이름, 금액, 기간 등 민감 정보가 외부 서버로 나가지 않습니다.

지원 계약서 9종 개요

공식 GitHub 저장소 기준으로 한국 사업자가 자주 사용하는 계약서 유형을 지원합니다. 정확한 최신 목록은 저장소 README를 확인하세요. 일반적으로 다음과 같은 유형이 포함됩니다.

계약서 유형	주요 사용 상황
근로계약서	직원 채용 시
용역(도급)계약서	외주·프리랜서 계약
비밀유지계약서(NDA)	기술·사업 정보 공유 전
업무위탁계약서	대행사·파트너 업무 위탁
물품공급계약서	제품 납품 계약
임대차계약서	사무실·공간 임대
컨설팅계약서	전문가 자문 계약
투자계약서	초기 투자 유치
합의서	분쟁 합의·정산

사전 준비물 확인

설치를 시작하기 전에 다음 항목을 확인하세요.

Node.js 18 이상 — node --version으로 확인. 없으면 nodejs.org에서 LTS 버전 설치
Git — git --version으로 확인
Claude Code (권장) 또는 Claude Desktop — MCP를 지원하는 클라이언트
인터넷 연결 — 저장소 클론 및 npm 패키지 설치 시 필요 (이후 실행은 오프라인 가능)

단계별 설치 방법

1단계: 저장소 클론

터미널을 열고 원하는 디렉터리로 이동한 뒤 다음 명령을 실행합니다.

git clone https://github.com/kimlawtech/korean-contracts
cd korean-contracts

2단계: 의존성 설치

npm install

설치가 완료되면 node_modules 디렉터리가 생성됩니다. 오류가 없으면 다음 단계로 넘어갑니다.

3단계: 빌드 (필요한 경우)

저장소에 빌드 스크립트가 포함된 경우 다음 명령을 실행합니다.

npm run build

package.json에 build 스크립트가 없으면 이 단계를 건너뜁니다. 저장소 README에서 최신 빌드 방법을 확인하세요.

4단계: Claude Code에 MCP 서버 등록

Claude Code를 사용하는 경우, 프로젝트 루트에 .mcp.json 파일을 만들거나 기존 파일에 아래 항목을 추가합니다. <절대경로> 부분은 실제 클론한 디렉터리의 절대 경로로 교체하세요.

{
  "mcpServers": {
    "korean-contracts": {
      "type": "stdio",
      "command": "node",
      "args": ["<절대경로>/korean-contracts/dist/index.js"]
    }
  }
}

빌드 결과물의 정확한 경로(dist/index.js 또는 다른 경로)는 저장소 README 또는 package.json의 main 필드를 확인하세요.

5단계: Claude Desktop에 등록 (선택)

Claude Desktop을 사용한다면 설정 파일 위치는 다음과 같습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

해당 파일을 열고 아래와 같이 mcpServers 항목을 추가합니다.

{
  "mcpServers": {
    "korean-contracts": {
      "type": "stdio",
      "command": "node",
      "args": ["<절대경로>/korean-contracts/dist/index.js"]
    }
  }
}

6단계: Claude 재시작 및 도구 확인

설정 파일을 저장한 뒤 Claude Code 또는 Claude Desktop을 완전히 종료하고 다시 시작합니다. 도구 목록(슬래시 명령 또는 도구 패널)에서 korean-contracts 관련 도구가 나타나는지 확인합니다.

7단계: 계약서 생성 테스트

Claude Code 채팅창에서 다음과 같이 요청해 봅니다.

근로계약서 초안을 작성해줘.
고용인: (회사명), 피고용인: (성명), 계약 기간: 2026년 10월 1일부터 1년, 급여: 월 300만원

MCP 서버가 정상 연결되면 Claude가 계약서 도구를 호출해 한국 법령에 맞는 초안을 반환합니다.

클라이언트별 설정 비교

항목	Claude Code	Claude Desktop
설정 파일	`.mcp.json` (프로젝트 루트)	`claude_desktop_config.json` (홈)
적용 범위	프로젝트 단위	전역 (모든 대화)
권장 용도	개발자·팀 공유	개인 사용자
재시작 필요	예	예

흔한 오류와 해결 방법

”서버를 찾을 수 없습니다” 오류

.mcp.json의 args 경로가 실제 파일 위치와 다를 때 발생합니다.

# 빌드 결과물 위치 확인
ls <절대경로>/korean-contracts/
ls <절대경로>/korean-contracts/dist/

index.js가 dist/ 아래 없다면 src/ 또는 루트를 확인하고 경로를 수정합니다.

”node: command not found” 오류

Node.js가 설치되어 있지 않거나 PATH에 등록되지 않은 경우입니다.

node --version
# 출력이 없으면 nodejs.org에서 LTS 설치

Claude가 도구를 인식하지 못하는 경우

JSON 파일 문법 오류(쉼표 누락, 따옴표 불일치)를 확인합니다.
Claude를 완전히 종료(트레이 아이콘 포함)하고 재시작합니다.
저장소 공식 README에서 최신 설치 방법 변경 사항을 확인합니다.

사용 시 주의사항

AI가 생성한 계약서는 초안 참고 자료입니다. 실제 계약에 사용하기 전에 반드시 법률 전문가(변호사)의 검토를 받아야 합니다. 특히 다음 항목은 전문가 확인이 필요합니다.

근로계약서: 근로기준법상 필수 기재 사항(임금, 근로시간, 휴일, 연차 등)
NDA: 비밀 정보의 범위, 유효 기간, 위반 시 손해배상 조항
투자계약서: 주식 수, 투자 조건, 경영권 보호 조항

MCP 서버는 초안 작성 시간을 단축해 주지만, 법적 효력은 내용의 정확성과 적법성에 달려 있습니다.

다음 단계

Korean-contracts MCP를 설치했다면, 다음과 같은 작업으로 활용도를 높일 수 있습니다.

법령 MCP 함께 설치 — 한국 법령 MCP를 추가하면 계약서 조항의 법적 근거를 실시간으로 확인할 수 있습니다.
프로젝트 .mcp.json에 팀 공유 — .mcp.json을 Git에 커밋하면 팀원 모두 동일한 MCP 환경을 사용할 수 있습니다.
다른 한국 특화 MCP 탐색 — 가이드 목록에서 한국 API·서비스를 연결하는 다양한 MCP 튜토리얼을 확인해 보세요.

한국에서 유용한 MCP 서버를 직접 만들었다면 MCP모아에 등록하면 더 많은 사용자와 공유할 수 있습니다.

자주 묻는 질문

Korean-contracts MCP는 API 키가 필요한가요?

아닙니다. Korean-contracts MCP는 외부 API를 사용하지 않아 별도 API 키 발급이 필요하지 않습니다. 저장소를 클론하고 npm install만 하면 바로 사용할 수 있습니다.

지원하는 계약서 종류는 무엇인가요?

한국 사업자용 9종 계약서를 지원합니다. 정확한 목록은 GitHub 저장소(https://github.com/kimlawtech/korean-contracts)의 README를 참고해 주세요. 근로계약서, 용역계약서, 비밀유지계약서(NDA) 등 사업자가 빈번하게 사용하는 유형이 포함됩니다.

Claude Desktop에서도 사용할 수 있나요?

네. Claude Desktop의 경우 사용자 홈 디렉터리의 claude_desktop_config.json 파일에 mcpServers 항목을 추가하면 됩니다. 설정 방식은 이 가이드의 ‘클라이언트별 설정’ 섹션을 참고하세요.

생성된 계약서는 법적 효력이 있나요?

AI가 생성하는 계약서 초안은 참고 자료로만 활용하세요. 실제 계약에 사용하기 전에 반드시 변호사 등 법률 전문가의 검토를 받는 것을 권장합니다. 이 서버는 초안 작성 속도와 편의성을 높이는 도구입니다.

개인정보가 외부 서버로 전송되나요?

아닙니다. Korean-contracts MCP는 개인정보 보호 서버로, 외부 API 호출 없이 로컬에서 동작합니다. 계약 당사자 정보 등 민감한 데이터가 외부로 전송되지 않습니다.

npm install 후 MCP 서버가 실행되지 않으면 어떻게 하나요?

Node.js 버전이 18 미만이면 호환성 문제가 발생할 수 있습니다. node --version으로 버전을 확인하고, 필요하면 최신 LTS 버전으로 업그레이드하세요. .mcp.json의 command 경로가 실제 빌드 결과물과 일치하는지도 확인해 주세요.