korean-law-mcp 설치가이드 (Windows 10/11)

작성일 기준: 2026-08-01. 명령·주소는 작성일에 공식 저장소(github.com/chrisryugj/korean-law-mcp)와 법제처 국가법령정보 공동활용 사이트(open.law.go.kr)에서 확인한 내용입니다. 화면 문구는 시점에 따라 조금 다를 수 있습니다.

빠른 설치 (아는 사람용 · 약 15분)

순서를 지켜야 합니다. ①번 인증키가 없으면 뒤 단계가 전부 실패합니다.

① 법제처 인증키(OC) 발급 — 약 5분, 무료. 아래 주소를 브라우저에 붙여넣고, 로그인 → 좌측 OPEN API 신청 → 좌측 API인증키관리 에서 키를 복사합니다.

https://open.law.go.kr/LSO/openApi/guideList.do

② 설치 마법사 실행 (PowerShell에 붙여넣기 → 키 입력 → 연결할 앱 선택)

npx korean-law-mcp setup

③ 연결한 AI 프로그램을 완전히 종료했다가 다시 실행합니다. (필수 — 설정 반영)

④ 동작 확인 — AI 채팅 칸에 그대로 입력

근로기준법 제74조 원문을 법제처에서 찾아서 그대로 보여 줘.

소요 시간: 키 발급 5분 + 설치 3분 + 테스트 5분. Codex CLI·claude.ai 웹에 붙이려면 9절을 보세요. 처음이라면 이 박스는 넘기고 2절부터 읽으세요.

1. 이 도구는 무엇인가

korean-law-mcp는 법제처 국가법령정보센터의 공식 데이터(법령·판례·헌재결정·조례·해석례 등 42개 API)를 AI 도구 안에서 바로 불러 쓸 수 있게 연결해 주는 MCP 서버입니다. MCP(Model Context Protocol)는 AI에게 "이런 자료를 조회할 수 있는 창구"를 붙여 주는 표준 규격입니다. 한 번 연결해 두면 안티그래비티나 Codex CLI 안에서 "근로기준법 제74조 알려줘"라고만 해도 법제처 원문을 그대로 가져옵니다.

법률 업무 예시 — AI가 써 준 서면 초안에 민법 제9999조처럼 존재하지 않는 조문이 섞여 있을 때, verify_citations 기능이 인용 조문을 법제처 원문과 하나씩 대조해 "이 조문은 없습니다"라고 잡아 줍니다. 4차시(리서치 검증)의 핵심 도구입니다.

중요 — 이 도구는 조회 결과를 가공·요약할 수 있습니다. 법적 효력이 필요한 판단에는 반드시 국가법령정보센터 원문을 직접 확인하세요. 공식 저장소도 같은 취지를 명시합니다.

보안 규칙 (문서 끝까지 적용)

• 발급받은 인증키(OC)는 본인만 쓸 수 있습니다. 남에게 알려 주거나 공용 문서·단톡방에 붙여넣지 않습니다.
• 이 문서나 메모장에 키를 적지 마세요. 발급 화면에서 복사해 설치 화면에 바로 붙여넣고, "법제처 사이트 → API인증키관리에서 언제든 다시 볼 수 있다"는 사실만 기억하면 됩니다.
• https://mcp.gomdori.app/law?oc=본인키 형태의 주소는 그 자체가 비밀번호와 같습니다 (주소 끝에 키가 들어 있음). 화면 공유·스크린샷 때 가려 주세요.
• 회사 보안 프로그램이 설치를 막으면 임의로 끄지 말고 전산 담당자나 교육 진행자에게 문의합니다.

2. 설치 전 확인

• Windows 10 또는 11이고, 인터넷에 연결되어 있다.
• 법제처 Open API 인증키(OC) — 아직 없어도 됩니다. 3-1에서 제일 먼저 발급받습니다.
• 연결할 AI 도구가 이미 설치되어 있다. → 안티그래비티 설치가이드 / Codex CLI 설치가이드
• Node.js LTS가 설치되어 있다. → 공통 준비 가이드 확인 명령:

node -v

공식 README는 "Node.js 18 이상"으로 안내하지만, 작성일 기준 최신 버전(korean-law-mcp 4.9.2)의 패키지 정보는 Node.js 20.19.0 이상을 요구합니다. 공통 준비 가이드대로 LTS 최신판을 깔면 두 조건을 모두 만족합니다. (설치가 전혀 필요 없는 웹 커넥터 방법은 9절 B에 있습니다.)

3. 설치 절차

3-1. [필수 선행] 법제처 인증키(OC) 발급 — 약 5분, 무료

이 단계를 건너뛰면 뒤 단계가 전부 실패합니다.

① 아래 주소를 브라우저 주소창에 붙여넣고 Enter

https://open.law.go.kr/LSO/openApi/guideList.do

② 오른쪽 위 "로그인" 을 누릅니다. 계정이 없으면 "사용자 가입" 으로 먼저 회원가입합니다(이메일 인증 필요, 실습용 계정 사용).

③ 왼쪽 메뉴에서 "OPEN API 신청" 을 누릅니다.

④ 목적란에 아래를 붙여넣고 저장합니다.

AI 도구에서 법령·판례 원문 확인 및 인용 검증 (개인 업무용 PC)

⑤ 왼쪽 메뉴에서 "API인증키관리" 를 엽니다.

⑥ 이 값을 드래그해 복사합니다(Ctrl+C). 이 창은 닫지 말고 열어 두세요. 다음 단계에서 붙여넣습니다.

3-2. PowerShell 열기

시작 버튼을 누르고 아래를 입력한 뒤 Enter를 누릅니다.

PowerShell

3-3. 설치 마법사 실행

아래를 붙여넣고(Ctrl+V 또는 마우스 오른쪽 버튼) Enter를 누릅니다.

npx korean-law-mcp setup

3-4. 마법사 질문에 답하기

① 법제처 인증키(OC)를 입력하라는 줄 → 3-1에서 복사한 값을 붙여넣고 Enter.

② 연결할 AI 프로그램 목록 → 방향키로 Antigravity(또는 본인이 쓰는 앱)에 커서를 옮기고 스페이스바로 선택한 뒤 Enter.

마법사가 지원하는 앱: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Zed, Antigravity.

3-5. AI 프로그램 재시작

연결한 AI 프로그램을 X로 완전히 닫고 다시 실행합니다.

4. 설치 확인

연결한 AI 프로그램의 채팅 칸에 아래를 그대로 입력합니다.

근로기준법 제74조 원문을 법제처에서 찾아서 그대로 보여 줘.

5. 초기 설정·연동

5-1. 도구 승인 화면에서 무엇을 위임하는가

처음 쓸 때 "이 도구를 사용해도 될까요?"라는 승인 창이 뜹니다. 이 도구가 하는 일은 법제처 공개 API에 조회 요청을 보내고 결과를 받아오는 것뿐입니다. 내 컴퓨터의 파일을 읽거나 고치지 않습니다. 문구를 읽고 승인하세요.

5-2. 인증키를 환경변수로 두기 (선택 — 터미널에서 직접 쓸 때만)

3-3 마법사를 썼다면 이 단계는 필요 없습니다.

지금 연 PowerShell 창에서만 쓰려면 (본인키를 발급받은 값으로 바꿉니다):

$env:LAW_OC="본인키"

컴퓨터에 계속 남겨 두려면 (다음에 연 창부터 적용):

setx LAW_OC 본인키

setx로 저장하면 인증키가 Windows 사용자 환경변수에 평문으로 남습니다. 공용 PC에서는 쓰지 마세요.

6. 첫 동작 테스트 (5분)

세 테스트 모두 가상의 실습 상황입니다. 진행 중인 실제 사건의 사건번호·의뢰인 이름·사실관계는 입력하지 않습니다.

① 조문 원문 가져오기 — 채팅 칸에 붙여넣기

민법 제750조 조문 전문을 법제처 원문으로 보여 줘.

② AI 환각 인용 잡아내기 (4차시 핵심) — 아래 문단에는 일부러 넣은 가짜 조문이 섞여 있습니다. 통째로 붙여넣으세요.

아래 문단에 인용된 조문이 실제로 존재하는지 법제처 원문으로 검증해 줘.

"임차인의 보증금반환채권은 민법 제618조에 근거하며, 임대인의 방해행위는 민법 제9999조의 신의칙 위반에 해당한다."

③ 판례가 아직 살아 있는지 확인

대법원 2007다27670 판결이 지금도 유효한지, 이후에 변경되거나 폐기됐는지 확인해 줘.

7. 문제 해결

① 플러그인 설치 중 Permission denied (publickey)

증상

Failed to install: Failed to clone repository: Cloning into
  '/Users/<user>/.claude/plugins/cache/temp_github_<id>'...
  git@github.com: Permission denied (publickey).
  fatal: Could not read from remote repository.

원인 — 설치기가 GitHub에 SSH로 접속하려 했는데 SSH 키가 등록돼 있지 않습니다. Git을 처음 쓰는 분에게 자주 생깁니다.

해결 — 아래 한 줄을 실행한 뒤 설치를 다시 합니다. 앞으로 GitHub 접속을 HTTPS로 바꾸라는 설정이며, 그대로 둬도 문제없습니다.

git config --global url."https://github.com/".insteadOf "git@github.com:"

② 사용자 정보 검증에 실패하였습니다 또는 [EXTERNAL_API_ERROR] fetch failed

증상 — 조회할 때마다 위 문구나 fetch failed가 나옴.

원인 — ⓐ 인증키가 틀렸거나, ⓑ 키 앞뒤에 공백·줄바꿈이 섞여 붙여넣어졌거나, ⓒ 법제처 신청이 아직 처리되지 않았습니다.

해결 — ① 법제처 사이트 API인증키관리에서 현재 값을 다시 확인합니다. ② 붙여넣은 뒤 Backspace로 뒤쪽 빈칸이 없는지 확인합니다. ③ 아래로 마법사를 다시 실행해 키를 새로 입력하고 AI 프로그램을 재시작합니다.

npx korean-law-mcp setup

③ AI가 법제처 도구를 쓰지 않고 그냥 아는 대로 답함

증상 — 조문을 물었는데 도구 호출 표시 없이 답만 나오고, 그 답이 실제 조문과 다름.

원인 — 설정 후 프로그램을 재시작하지 않았거나, 도구 사용 승인이 꺼져 있습니다.

해결 — ① AI 프로그램을 완전히 종료했다가 다시 실행합니다. ② claude.ai 웹이라면 설정 → 커넥터 → korean-law → 구성에서 도구를 "항상 사용" 으로 바꿉니다. ③ Codex CLI라면 codex mcp list로 목록에 있는지 확인합니다. ④ 그래도 안 되면 프롬프트에 명시합니다.

korean-law 도구를 써서 법제처 원문으로 확인해 줘.

④ 사내망·보안 프로그램 때문에 조회가 실패함

증상 — 브라우저로는 법제처 사이트가 열리는데, AI 도구에서만 fetch failed가 남.

원인 — 회사 방화벽이나 SSL 검사(SSL inspection) 장비를 거치는 환경에서는 브라우저와 Node.js가 서로 다른 인증서·프록시 설정을 쓰기 때문에 프로그램만 실패할 수 있습니다.

해결 — 보안 프로그램을 끄지 마세요. 전산 담당자에게 사내 프록시 주소를 확인해 아래를 관리자 권한 PowerShell에서 실행하고 재시작합니다 (프록시주소를 받은 값으로 바꿉니다).

setx LAW_EXTERNAL_HTTPS_PROXY http://프록시주소:8080 /M

검색하면 LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED 0으로 인증서 검사를 끄라는 안내가 나오지만, 이는 원인 진단용 임시 조치입니다. 상시 설정으로 쓰지 말고, 교육 중이라면 진행자에게 먼저 알리세요.

⑤ 조문은 잘 나오는데 판례 본문이 비어 있음

증상 — 판례 목록은 뜨는데 본문이 없거나 짧게 잘림.

원인 — 법제처 API가 일부 판례(특히 국세청 출처) 본문을 내려 주지 않아, 도구가 국세청 서버에서 보완 조회를 시도하는데 그 연결이 막힌 경우입니다.

해결 — 다시 한 번 요청해 봅니다(일시적 실패가 잦습니다). 계속 비어 있으면 아래 주소에서 사건번호로 직접 검색합니다. 어차피 법적 판단에는 원문 확인이 필수입니다.

https://www.law.go.kr

8. 제거·연동 해제

① 마법사(3-3)로 연결했다면 — AI 프로그램의 MCP 설정 파일을 메모장으로 열어 "korean-law": { ... } 부분만 지우고 저장한 뒤 프로그램을 재시작합니다. (다른 항목은 건드리지 마세요.)

② Codex CLI(9절 A)로 연결했다면

codex mcp remove korean-law

③ claude.ai 웹(9절 B)으로 연결했다면 — 설정 → 커넥터 → korean-law → 삭제.

④ Claude Code 플러그인(9절 C)으로 연결했다면 — Claude Code에서 아래를 입력해 관리 화면을 열고 korean-law를 제거합니다.

/plugin

⑤ 프로그램 제거 — npm install -g korean-law-mcp로 직접 설치한 경우에만 필요합니다.

npm uninstall -g korean-law-mcp

⑥ 저장된 인증키 지우기 — 5-2에서 setx로 저장했다면 실행합니다.

[Environment]::SetEnvironmentVariable("LAW_OC", $null, "User")

⑦ 인증키 폐기·재발급 — 키가 노출됐다고 판단되면 아래 주소에서 상태를 확인하고 재발급·문의합니다. 키는 발급받은 본인만 사용할 수 있으며, 노출된 채로 두면 내 명의로 조회가 이루어집니다.

https://open.law.go.kr/LSO/usr/usrOcInfoMod.do

문의: 02-2109-6446

9. 다른 연결 방법 (필요할 때만)

여러 개를 동시에 해도 서로 방해하지 않습니다. 아래 모든 블록의 본인키는 3-1에서 복사한 인증키로 바꿔야 합니다.

A. Codex CLI 에 연결

Codex CLI가 먼저 설치돼 있어야 합니다. → Codex CLI 설치가이드

① 등록 (본인키를 바꾼 뒤 붙여넣기)

codex mcp add korean-law --url "https://mcp.gomdori.app/law?oc=본인키"

② 확인

codex mcp list

이 명령을 실행하면 인증키가 PowerShell 명령 기록과 Codex 설정 파일(C:\Users\<내이름>\.codex\config.toml)에 남습니다. 공용 PC에서는 실행하지 마세요.

B. claude.ai 웹 커넥터 (설치 없음)

Claude Pro/Max/Team/Enterprise 요금제가 필요합니다(Free는 커넥터 1개만 가능).

① 아래 주소로 접속해 로그인

https://claude.ai

② 왼쪽 사이드바 맨 아래 본인 이름 클릭 → 설정(Settings) → 커넥터(Connectors).

③ "커스텀 커넥터 추가" 버튼을 누릅니다.

④ 이름 칸에 붙여넣기

korean-law

⑤ URL 칸에 아래를 붙여넣고 본인키를 바꿉니다.

https://mcp.gomdori.app/law?oc=본인키

⑥ 추가 버튼을 누릅니다.

⑦ 추가된 커넥터의 "구성"(Configure)을 눌러 도구들을 "항상 사용"(Always allow)으로 바꿉니다. 이렇게 해야 매번 승인 창이 뜨지 않습니다.

URL을 잘못 넣으면 수정이 안 됩니다. 삭제한 뒤 다시 추가하세요.

C. Claude Code 플러그인

Claude Code 창 안에서 아래 두 블록을 차례로 입력합니다.

/plugin marketplace add chrisryugj/korean-law-mcp

/plugin install korean-law@korean-law-marketplace

나중에 최신 버전으로 올리려면:

/plugin marketplace update korean-law-marketplace

확인한 출처

확인 불가로 남긴 항목

• 3-1의 신청서 항목 이름과 승인 소요 시간은 로그인이 필요한 화면이라 직접 확인하지 못했습니다. 화면이 문서와 다르면 좌측 메뉴 이름(OPEN API 신청, API인증키관리)을 기준으로 찾으세요.
• claude.ai 설정 메뉴 명칭(9절 B)은 요금제·시점에 따라 달라질 수 있습니다. README 기준으로 적었습니다.