M MCP모아
튜토리얼

법제처 Open API 인증키 발급 방법 — MCP 연동 전 필수 준비 단계

법제처 국가법령정보 Open API OC 인증키를 발급받아 MCP 서버에 적용하는 절차를 단계별로 정리했습니다. 법령 API 키 신청부터 Claude 연동까지 완전 가이드.

법제처 국가법령정보 Open API 포털에서 OC 인증키를 발급받아 MCP 서버에 적용하는 과정 흐름도

법제처 국가법령정보 Open API의 OC 인증키는 법령 관련 MCP 서버를 Claude에 연동하기 전에 반드시 준비해야 하는 필수 자격증명입니다. 발급 절차는 open.law.go.kr에서 회원가입 후 API 활용 신청 → 즉시 발급의 3단계로 이루어지며, 인증키를 MCP 설정 파일에 환경변수로 입력하면 Claude에서 법령 실시간 검색이 가능해집니다. 이 가이드에서는 OC 인증키 발급부터 MCP 설정 적용까지 전 과정을 빠짐없이 안내합니다.

왜 법제처 Open API 인증키가 필요한가

법령 카테고리의 MCP 서버들은 법제처 국가법령정보 Open API를 통해 현행 법령, 시행령, 판례, 행정규칙 등 방대한 법률 데이터를 실시간으로 가져옵니다. 이 API는 공공데이터 포털이지만 무분별한 트래픽을 방지하고 이용자를 식별하기 위해 OC 인증키(Open API Certification Key) 를 요구합니다.

인증키 없이 MCP 서버를 설치해도 API 호출 시 인증 오류가 발생하여 법령 검색이 전혀 작동하지 않습니다. MCP 서버 설치 전에 인증키를 먼저 준비해두는 것이 가장 효율적인 순서입니다.

사용자(Claude) → MCP 서버 → 법제처 Open API (OC 인증키 필요) → 법령 데이터 반환
                   ↑
         OC 인증키가 없으면 401 오류 발생

법제처 Open API란 무엇인가

국가법령정보 Open API는 법제처(Ministry of Government Legislation)가 운영하는 공공 API 서비스로, 대한민국의 모든 현행 법령을 프로그래밍 방식으로 조회할 수 있습니다.

항목내용
운영 기관법제처 (국가법령정보센터)
포털 주소open.law.go.kr
제공 데이터법령, 시행령, 시행규칙, 판례, 행정규칙, 자치법규 등
API 수42개 이상의 세부 API 제공
비용무료 (공공데이터)
인증 방식OC 인증키 (쿼리 파라미터로 전달)
응답 형식XML (일부 JSON 지원)

이 API를 래핑한 MCP 서버(한국 법령 MCP)를 사용하면 Claude에서 자연어로 “근로기준법 52조 내용 알려줘”라고 물어봤을 때 실제 법령 원문을 즉시 확인할 수 있습니다.

사전 준비물

  • 이메일 주소 (회원가입용)
  • 휴대폰 번호 (본인인증, 선택적)
  • 사용 목적 간단 기재 (신청 양식에 입력)

법인·기관 사용자도 동일한 절차로 신청하며, 별도의 서류 제출은 필요하지 않습니다.

OC 인증키 발급 단계별 방법

1단계: 법제처 Open API 포털 접속 및 회원가입

법제처 국가법령정보 Open API 포털(open.law.go.kr)에 접속합니다. 우측 상단의 회원가입 버튼을 클릭해 이메일 또는 소셜 계정으로 가입을 완료합니다.

이미 국가법령정보센터(law.go.kr) 계정이 있는 경우 동일한 계정으로 로그인이 가능할 수 있으니 먼저 시도해 보세요.

2단계: Open API 활용 신청

로그인 후 상단 메뉴에서 마이페이지 또는 Open API 활용 신청 메뉴로 이동합니다.

신청 페이지에서 다음 항목을 입력합니다.

항목입력 예시
활용 목적AI 법령 검색 서비스 개발 / 개인 학습
사용 API법령 조회, 판례 조회 등 필요한 항목 선택
예상 호출 건수일 1,000건 이내 (개인 사용 기준)

모든 API를 한 번에 선택해두면 이후 추가 신청 없이 다양한 MCP 도구를 사용할 수 있으므로 필요 API를 넉넉하게 선택하는 것을 권장합니다.

신청 완료 버튼을 누르면 즉시 또는 수 분 내에 자동 승인됩니다.

3단계: OC 인증키 확인 및 복사

신청 완료 후 마이페이지 > 나의 Open API 메뉴로 이동합니다. 승인된 API 목록과 함께 OC 인증키(일반키) 가 표시됩니다.

인증키는 영문 대소문자와 숫자로 구성된 긴 문자열입니다. 복사해서 안전한 곳에 보관해두세요.

예시 형식: abcdef1234567890abcdef1234567890 (실제 키는 이와 다릅니다)

4단계: MCP 설정 파일에 인증키 적용

발급받은 OC 인증키를 MCP 클라이언트 설정 파일에 입력합니다. Claude Desktop을 사용하는 경우 설정 파일 위치는 운영체제별로 다릅니다.

운영체제설정 파일 경로
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

한국 법령 MCP (chrisryugj/korean-law-mcp) 적용 예시:

{
  "mcpServers": {
    "korean-law-mcp": {
      "command": "npx",
      "args": ["korean-law-mcp"],
      "env": {
        "LAW_API_KEY": "여기에_발급받은_OC_인증키_입력"
      }
    }
  }
}

한국 법령 MCP 서버 (SeoNaRu/korean-law-mcp) 적용 예시:

이 서버는 stdio 방식으로 동작하며, 저장소(github.com/SeoNaRu/korean-law-mcp)의 README에 명시된 설정 방법을 따르세요. 환경변수 키 이름은 저장소에서 확인 후 입력하세요.

5단계: MCP 서버 초기화 및 동작 확인

korean-law-mcp(chrisryugj)의 경우 다음 명령으로 초기 설정을 진행합니다.

npx korean-law-mcp setup

이후 Claude Desktop을 재시작하고, Claude 채팅창에서 아래와 같이 테스트해 보세요.

근로기준법 제50조의 내용을 알려줘.

정상 작동 시 법제처 API에서 조회된 실제 법령 원문이 반환됩니다.

흔한 오류와 해결 방법

401 Unauthorized 오류

OC 인증키가 잘못 입력되었거나 API 신청이 승인되지 않은 상태입니다.

  • 마이페이지에서 인증키를 다시 복사해 공백 없이 입력했는지 확인하세요.
  • API 활용 신청 상태가 ‘승인’인지 확인하세요.

API는 호출되는데 데이터가 없음

신청한 API 목록에 해당 데이터 유형이 포함되어 있지 않을 수 있습니다. 마이페이지에서 추가 API를 신청하세요.

JSON 파싱 오류

법제처 API는 기본적으로 XML 응답을 반환합니다. MCP 서버가 내부적으로 XML을 파싱하므로 사용자가 직접 처리할 필요는 없습니다. 오류 발생 시 MCP 서버 버전을 최신으로 업데이트하세요.

npx korean-law-mcp@latest setup

Claude Desktop 재시작 후에도 MCP가 인식 안 됨

설정 파일(claude_desktop_config.json)의 JSON 형식이 올바른지 확인하세요. 쉼표 누락, 따옴표 오류 등 JSON 문법 오류가 흔한 원인입니다.

# macOS에서 설정 파일 문법 검증
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool

오류 없이 출력되면 JSON은 유효합니다. Claude Desktop을 완전히 종료 후 다시 시작하세요.

데이터 흐름 요약

Claude Desktop
    │
    ▼
MCP 클라이언트 (설정: LAW_API_KEY=OC인증키)
    │
    ▼
korean-law-mcp 서버 (로컬 프로세스)
    │
    ▼  HTTP GET + OC 인증키 파라미터
open.law.go.kr (법제처 Open API)
    │
    ▼  XML 응답
MCP 서버 (파싱 후 텍스트로 변환)
    │
    ▼
Claude (법령 원문 답변 생성)

자주 묻는 질문

법제처 Open API 인증키는 무료로 발급받을 수 있나요?

네, 법제처 국가법령정보 Open API는 공공데이터로 누구나 무료로 신청·발급받을 수 있습니다. 상업적 활용도 가능하나 이용약관을 반드시 확인하세요.

OC 인증키와 일반 API 키는 다른 건가요?

법제처 포털에서는 발급되는 키를 ‘OC 인증키’ 또는 ‘일반키’라고 부릅니다. 동일한 키이며, MCP 서버 설정 시 LAW_API_KEY 등의 환경변수에 이 값을 그대로 입력하면 됩니다.

API 신청 후 인증키 발급까지 얼마나 걸리나요?

대부분의 경우 신청 즉시 또는 수 분 내에 자동 발급됩니다. 단, 시스템 점검 시간대에는 다소 지연될 수 있습니다. ‘마이페이지 > 나의 Open API’에서 상태를 확인하세요.

인증키 발급 후 어느 MCP 서버에서 사용할 수 있나요?

법제처 Open API를 사용하는 MCP 서버라면 동일한 OC 인증키를 사용할 수 있습니다. 대표적으로 한국 법령 MCP(github.com/chrisryugj/korean-law-mcp)와 한국 법령 MCP 서버(github.com/SeoNaRu/korean-law-mcp)가 이 키를 필요로 합니다.

인증키를 분실했거나 재발급이 필요한 경우 어떻게 하나요?

open.law.go.kr에 로그인 후 ‘마이페이지 > 나의 Open API’ 메뉴에서 인증키 재발급을 신청할 수 있습니다. 재발급 시 기존 키는 즉시 만료되므로 MCP 설정 파일도 업데이트해야 합니다.

API 호출 건수 제한이 있나요?

법제처 Open API는 일일 호출 건수 제한이 있습니다. 정확한 제한 수치는 open.law.go.kr의 공식 이용 안내를 확인하세요. MCP를 통한 AI 자동화 사용 시 호출 빈도에 주의해야 합니다.

다음 단계

OC 인증키를 발급받았다면 이제 법령 MCP 서버를 설치할 준비가 완료된 것입니다.

법령 MCP 서버를 성공적으로 설치했다면 Claude에서 법령 검색, 판례 조회, 계약서 작성까지 법률 업무 전반을 AI로 처리할 수 있습니다.

이 글과 관련된 MCP 서버