Korean Law MCP 설치 가이드
Claude에서 한국 법령 검색 먼저 연결하기
가장 쉬운 방법은 Claude의 원격 커스텀 커넥터에 Korean Law MCP 서버를 등록하는 것입니다. 이 방식은 내 컴퓨터에 Node.js나 npm을 설치하지 않아도 됩니다. GPT와 Gemini는 짧게만 비교하고, 이 글은 Claude에서 바로 쓰는 방법을 먼저 설명합니다.
?oc=인증키핵심 요약
- Claude에서 쓰려면 Node.js나 npm을 설치하지 않고 커스텀 커넥터만 추가하면 됩니다.
- Remote MCP server URL에는
https://korean-law-mcp.fly.dev/mcp?oc=본인_OC_코드처럼 법제처 OC 키를 URL 쪽에 붙여 넣습니다. - OAuth Client ID와 OAuth Client Secret에는 법제처 OC 키를 넣지 않습니다. 이 연결 방식에서는 비워두는 것이 맞습니다.
- 커넥터를 추가한 뒤 Configure 화면에서 도구를 확인하고 Always allow로 허용합니다.
- 로컬 설치, Node.js, npm, npx는 직접 서버를 실행해야 하는 고급 사용자에게만 필요합니다.
1. 먼저 정리: Node/npm은 언제 필요한가
Korean Law MCP를 쓰는 방법은 크게 두 가지입니다.
| 방식 | 필요한 것 | Node/npm 필요 여부 | 추천 대상 |
|---|---|---|---|
| Claude 원격 커넥터 | Claude 커스텀 커넥터, 법제처 OC 키를 붙인 원격 MCP 서버 URL | 불필요 | 대부분의 일반 사용자 |
| 로컬 실행 | Node.js, npm/npx, 로컬 설정 파일, LAW_OC 환경변수 | 필요 | 개발자, 사내망, 직접 서버 실행이 필요한 사용자 |
2. Claude에서 바로 연결하는 방법
Claude 커스텀 커넥터 화면에는 Name, Remote MCP server URL, OAuth Client ID, OAuth Client Secret 입력란이 있습니다. Korean Law MCP 연결에서는 법제처 OC 키를 OAuth ID/Secret에 넣지 않고, Remote MCP server URL 뒤에 붙여 입력합니다.

입력값은 이렇게 넣습니다
| 입력란 | 입력값 | 설명 |
|---|---|---|
| Name | korean-law | 커넥터 이름입니다. 원하는 이름을 써도 되지만 공식 예시는 korean-law입니다. |
| Remote MCP server URL | https://korean-law-mcp.fly.dev/mcp?oc=본인_OC_코드 | 원격 MCP 서버 주소 뒤에 법제처 Open API OC 키를 쿼리스트링으로 붙입니다. |
| OAuth Client ID | 비워둠 | 여기에 x-law-oc나 OC 키를 넣지 않습니다. |
| OAuth Client Secret | 비워둠 | 여기에 법제처 OC 코드를 넣지 않습니다. OC 코드는 서버 URL 쪽에 입력합니다. |
Name: korean-law
Remote MCP server URL: https://korean-law-mcp.fly.dev/mcp?oc=honggildong
OAuth Client ID: 비워둠
OAuth Client Secret: 비워둠honggildong은 설명용 값입니다. 실제 설정에서는 본인에게 발급된 OC 코드를 URL의 ?oc= 뒤에 넣어야 합니다.?oc= 포함 서버 주소3. 연결 후 꼭 해야 할 설정
커넥터를 추가한 뒤에는 Configure 또는 구성 화면을 열어 도구 목록을 확인합니다. 자주 쓸 도구는 Always allow로 설정해야 매번 승인 팝업에 막히지 않습니다.
4. GPT에서는 어떻게 쓰나
ChatGPT 웹이나 일반 데스크탑 앱은 Claude 커스텀 커넥터처럼 원격 MCP 서버를 바로 등록하는 흐름이 아닙니다. 그래서 초보자에게 “GPT에 설치한다”고 설명하면 오해가 생깁니다.
추천
Claude에서 법령 원문과 근거를 찾은 뒤, GPT에는 글 구조화·요약·표현 개선을 맡깁니다.
개발자 방식
GPT API 기반 에이전트를 직접 만들면 외부 도구 호출 구조를 붙일 수 있지만 일반 사용자용 설명 범위를 벗어납니다.
주의
GPT 답변만으로 조문을 확정하지 말고, 반드시 법령명·조문·시행일·공식 원문 링크를 확인합니다.
5. Gemini에서는 어떻게 쓰나
Gemini도 웹 화면에서 바로 연결하기보다는 Gemini CLI나 MCP 설정을 지원하는 개발자 환경에서 쓰는 편이 현실적입니다. 일반 사용자는 Claude 원격 커넥터로 먼저 시작하고, 필요할 때 Gemini CLI를 검토하면 됩니다.
{
"mcpServers": {
"korean-law": {
"command": "npx",
"args": ["-y", "korean-law-mcp"],
"env": {
"LAW_OC": "여기에_발급받은_인증키"
}
}
}
}위 방식은 로컬 실행이므로 Node.js와 npm이 필요합니다. Claude 원격 커넥터 방식과 다릅니다.
6. 고급: 로컬에 직접 설치해야 하는 경우
원격 서버를 쓰지 않고 내 컴퓨터에서 Korean Law MCP 서버를 직접 실행해야 하는 경우에만 Node.js/npm이 필요합니다. 예를 들어 사내 보안 정책상 외부 원격 MCP 서버를 쓰기 어렵거나, 로컬 개발환경에 붙여야 하는 경우입니다.
설치 마법사
npx korean-law-mcp setup수동 설정 예시
{
"mcpServers": {
"korean-law": {
"command": "korean-law-mcp",
"env": {
"LAW_OC": "honggildong"
}
}
}
}7. 자주 막히는 지점
| 증상 | 원인 | 해결 |
|---|---|---|
| Claude에서 도구가 안 보임 | 커넥터 추가 후 Configure/도구 허용을 하지 않음 | 구성 화면에서 도구를 확인하고 Always allow 설정 |
| 인증 오류 | URL에 OC 키 누락, ?oc= 오타, OAuth 입력란에 잘못 입력 | Remote MCP server URL이 https://korean-law-mcp.fly.dev/mcp?oc=본인_OC_코드 형태인지 확인하고, OAuth Client ID/Secret은 비워둠 |
| 검색 결과 없음 | 검색어가 너무 길거나 법령명이 부정확함 | 법령명만 먼저 검색한 뒤 조문번호로 좁히기 |
| npx 오류 | 로컬 실행 방식인데 Node/npm이 없음 | Claude 원격 커넥터 방식으로 바꾸거나 Node.js LTS 설치 |
출처 및 확인 기준
- 공식 저장소:
github.com/chrisryugj/korean-law-mcp - 원격 MCP 서버 URL:
https://korean-law-mcp.fly.dev/mcp?oc=본인_OC_코드 - OAuth Client ID 입력값: 비워둠
- OAuth Client Secret 입력값: 비워둠
- npm 패키지:
korean-law-mcp - 기준일: 2026-04-29
이 글은 설치와 사용 흐름을 설명하는 일반 정보입니다. 법령 해석이나 사건 적용은 구체적 사실관계, 시행일, 판례, 행정해석에 따라 달라질 수 있습니다.