관세 해석 MCP 연동 — Claude로 관세율·품목분류 자동 조회하기
관세청 품목분류·관세율 해석을 MCP로 Claude에 연결해 수출입 세무를 자동화하는 방법을 단계별로 안내합니다. 한국 법령 MCP와 Claude Desktop·Claude Code 설정까지 완전 정리.
관세청 품목분류·관세율 정보를 MCP로 Claude에 연결하면 수출입 서류 검토, 세율 확인, 법령 조문 검색을 자연어 대화 한 줄로 처리할 수 있습니다. 법제처 Open API 키를 발급받고 한국 법령 MCP 서버를 Claude Desktop 또는 Claude Code에 등록하면, “이 제품의 수입 관세율은 얼마야?”라는 질문에 Claude가 실제 관세법·관세율표 원문을 근거로 답합니다. 이 가이드는 키 발급부터 첫 조회까지 전 과정을 단계별로 안내합니다.
왜 관세 해석에 AI와 MCP가 필요한가
수출입 실무에서 관세율과 품목분류(HS코드) 확인은 반복적이면서도 실수가 잦은 작업입니다. 관세율표는 수천 개의 세번(稅番)으로 구성되어 있고, 동일한 물건도 재질·용도·가공 상태에 따라 세율이 달라집니다. 관련 법령도 관세법·자유무역협정 특례법·품목분류 사전심사 사례 등 여러 곳에 흩어져 있습니다.
MCP(Model Context Protocol)는 Claude 같은 AI 모델이 외부 데이터 소스에 실시간으로 접근하도록 연결하는 표준 인터페이스입니다. 한국 법령 MCP 서버를 연결하면 Claude는 법제처 Open API를 통해 관세법 조문, 관세율표, 관련 시행령을 직접 검색해 해석 근거와 함께 답변합니다. 단순 기억이 아니라 법령 원문을 실시간으로 참조하는 점이 일반 AI 답변과의 차이입니다.
사용자 질문 (자연어)
│
▼
Claude (LLM) ─── 도구 호출 ───▶ 한국 법령 MCP 서버 (로컬)
│
▼
법제처 Open API (open.law.go.kr)
국가법령정보센터 (국가법령정보 DB)
│
▼
관세법·관세율표 조문 반환
│
▼
Claude가 법령 원문 기반으로 해석·답변
관세 해석 MCP로 할 수 있는 것들
| 활용 시나리오 | 예시 질문 | 활용 법령 |
|---|---|---|
| 품목분류 참고 조회 | ”리튬이온 배터리팩 HS코드가 뭐야?” | 관세율표 주(注) 및 세번 |
| 세율 확인 | ”냉장고 수입 기본관세율이 얼마야?” | 관세율표 별표 |
| 관세법 조문 검색 | ”관세법 제38조 내용 알려줘” | 관세법 원문 |
| FTA 특혜세율 검토 | ”한-EU FTA에서 와인 관세율 조항 찾아줘” | FTA 특례법·협정문 |
| 감면·면세 요건 확인 | ”학술연구용 기자재 관세 감면 조건이 뭐야?” | 관세법 시행규칙 |
관세 전문가의 최종 판단을 대체하는 것이 아니라, 사전 조사·초안 검토·법령 원문 탐색 단계의 속도를 높이는 데 가장 효과적입니다.
준비물
- 법제처 Open API 인증키: open.law.go.kr 가입 후 발급 (무료)
- Node.js 18 이상: npx 방식 서버 실행에 필요
- Claude Desktop 또는 Claude Code: MCP 클라이언트
- 인터넷 연결: 법제처 API 실시간 호출 필요
단계별 연동 방법
1단계 — 법제처 Open API 키 발급
- open.law.go.kr 에 접속해 회원가입하거나 로그인합니다.
- 상단 메뉴에서 Open API 신청 또는 API 키 발급 메뉴를 선택합니다.
- 이용 목적을 입력하고 신청하면 인증키가 발급됩니다.
- 마이페이지에서 발급된 인증키를 복사해 안전한 곳에 보관합니다.
발급된 인증키는 소스코드나 공개 저장소에 절대 넣지 마세요. 환경 변수 또는 설정 파일의 env 블록에만 저장합니다.
2단계 — 한국 법령 MCP 서버 설치
관련 서버 중 npx로 간편하게 설치·실행할 수 있는 Korean Law MCP (github.com/chrisryugj/korean-law-mcp)를 기준으로 설명합니다. 이 서버는 법제처 42개 API를 17개 MCP 도구로 래핑하여 법령 전문 검색, 조문 조회, 판례 검색 등을 지원합니다.
터미널에서 아래 명령을 실행해 서버를 초기화합니다.
npx korean-law-mcp setup
설치 중 인증키 입력을 요구하면 1단계에서 발급받은 법제처 API 키를 입력합니다. 설정 파일에 직접 넣으려면 3단계로 넘어가면 됩니다.
stdio 방식의 대안 서버(github.com/SeoNaRu/korean-law-mcp)는 npx 없이 직접 실행하는 방식으로, 해당 저장소의 README에서 실행 방법을 확인하세요.
3단계 — Claude 설정 파일에 MCP 서버 등록
Claude Desktop과 Claude Code 각각의 설정 파일에 MCP 서버 블록을 추가합니다.
Claude Desktop 설정 파일 경로
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code 설정 파일 경로
~/.claude/settings.json
아래는 npx 방식으로 Korean Law MCP를 등록하는 설정 예시입니다.
{
"mcpServers": {
"korean-law": {
"command": "npx",
"args": ["korean-law-mcp"],
"env": {
"LAW_API_KEY": "여기에_발급받은_법제처_인증키_입력"
}
}
}
}
환경 변수 키 이름(LAW_API_KEY)은 서버 버전에 따라 다를 수 있습니다. 저장소 README에서 정확한 환경 변수 이름을 확인한 뒤 입력하세요.
이미 다른 MCP 서버가 등록되어 있다면 mcpServers 객체 안에 "korean-law" 항목을 추가하면 됩니다.
4단계 — 클라이언트 재시작 및 연결 확인
설정 파일을 저장한 뒤 Claude Desktop 또는 Claude Code를 완전히 종료하고 다시 시작합니다.
- Claude Code: 터미널에서
/mcp명령을 입력합니다. 서버 목록에korean-law가 보이고connected상태이면 성공입니다. - Claude Desktop: 대화창 하단의 도구(망치) 아이콘을 클릭해 MCP 도구 목록에 법령 검색 관련 도구가 보이는지 확인합니다.
연결에 실패하면 아래 흔한 오류와 해결 섹션을 참고하세요.
5단계 — 자연어로 관세율·품목분류 조회
연결이 완료되면 Claude에게 자연어로 질문합니다.
관세율·품목분류 조회 예시
- “관세율표에서 리튬이온 배터리 세번과 기본세율을 찾아줘”
- “반도체 웨이퍼 수입 시 적용되는 기본관세율이 얼마야?”
- “관세법 제84조 품목분류 사전심사 절차를 설명해줘”
- “수입 화장품의 관세율과 개별소비세 면세 여부를 알려줘”
- “한-미 FTA 특혜세율 적용 조건을 관련 조문 기반으로 알려줘”
Claude는 법령 MCP 서버를 통해 법제처 API를 호출하고, 검색된 조문 원문을 근거로 해석을 제공합니다. 답변 내에 근거 조문이 함께 표시되므로 정확성을 직접 확인할 수 있습니다.
흔한 오류와 해결
| 오류 증상 | 원인 | 해결 방법 |
|---|---|---|
| 서버가 disconnected 상태 | npx 경로 문제 또는 Node.js 미설치 | node --version으로 18 이상 확인, 없으면 nodejs.org에서 설치 |
| API 인증 오류 (401) | env 인증키 오류 또는 누락 | 설정 파일 env 값과 발급 키 재대조, 키 앞뒤 공백 제거 |
| 법령 검색 결과 없음 | 검색어가 너무 짧거나 오타 | ”관세법 제XX조” 형식이나 법령 전체 이름으로 다시 질문 |
| 서버 시작 시 패키지 오류 | npx 캐시 문제 | npx --yes korean-law-mcp setup으로 재설치 시도 |
| 하루 호출 한도 초과 | 법제처 API 일일 제한 | 다음 날 재시도 또는 open.law.go.kr에서 한도 정책 확인 |
관세·법령 관련 MCP 서버 더 보기
관세 해석 외에도 수출입 실무에 유용한 법령 MCP 서버들을 함께 활용해 보세요.
- 한국 법령 MCP (chrisryugj): 법제처 42개 API를 17개 MCP 도구로 래핑한 서버. 관세법 외에 상법·민법·노동법 등 전 법령 검색 가능
- 한국 법령 MCP 서버 (SeoNaRu): 국가법령정보센터 API로 법령·판례·행정규칙 실시간 검색. stdio 방식
- 한국 계약서 자동생성 MCP: 무역·거래 관련 계약서 초안을 Claude Code에서 자동 생성
/category/law 카테고리에서 법률·세금·규제 관련 MCP 서버를 더 찾아보실 수 있습니다. 전체 서버 목록은 /servers 에서 확인하세요.
자주 묻는 질문
관세 해석 MCP를 쓰면 실제 세관 신고를 자동으로 할 수 있나요?
아닙니다. 이 연동은 관세율표·관세법 조문 검색 및 해석 보조에 활용합니다. 실제 수출입 신고는 관세사·전자통관시스템(UNI-PASS)을 통해 진행해야 합니다. AI 해석은 참고용으로만 사용하고, 법적 효력이 있는 결정은 전문가에게 의뢰하세요.
법제처 Open API 키는 유료인가요?
법제처 Open API는 기본적으로 무료로 제공됩니다. 다만 일일 호출 한도가 있으므로 과도한 반복 조회 시 한도에 걸릴 수 있습니다. open.law.go.kr의 API 이용 안내 페이지에서 현재 정책을 확인하세요.
HS코드(품목분류번호)를 직접 물어보면 정확하게 알려주나요?
한국 법령 MCP는 관세법·관세율표 조문을 검색해 Claude에 전달합니다. Claude는 해당 법령 원문을 바탕으로 HS코드 분류를 설명할 수 있지만, 품목분류는 복잡한 전문 판단이 필요하므로 최종 확정은 관세청 품목분류 사전심사나 관세사를 통해 확인하세요.
Korean Law MCP 서버 두 종류 중 어느 것을 써야 하나요?
github.com/chrisryugj/korean-law-mcp는 npx로 간단히 설치하며 API 키가 필요합니다. github.com/SeoNaRu/korean-law-mcp는 stdio 방식으로 직접 실행합니다. 설치 편의성을 우선한다면 npx 버전을, 세부 설정이 필요하다면 stdio 버전의 README를 참고해 직접 구성하세요.
관세 외에 부가세·개별소비세도 조회할 수 있나요?
법제처 API는 부가가치세법·개별소비세법 등 다른 세법 조문도 포함합니다. 한국 법령 MCP를 통해 해당 법령을 검색하면 관련 조항을 불러올 수 있습니다. 다만 실시간 세율 계산 기능은 서버 구현에 따라 다르므로 각 저장소의 지원 도구 목록을 확인하세요.
Windows에서도 npx korean-law-mcp setup이 동작하나요?
네, Node.js 18 이상이 설치된 Windows 환경에서도 동작합니다. Claude Desktop 설정 파일 경로는 %APPDATA%\Claude\claude_desktop_config.json이므로 이 경로를 열어 mcpServers 블록을 편집하세요.
다음 단계
관세 해석 MCP 연동에 성공했다면, 수출입 실무에서 활용 범위를 확장해 보세요. 법령 검색과 함께 한국 계약서 자동생성 MCP를 연결하면 무역 계약서 초안 작성도 Claude에서 처리할 수 있습니다. /guides 페이지에서 Claude Code·Cursor 등 다양한 MCP 클라이언트 설정 가이드를 찾아보세요. MCP모아에 아직 등록되지 않은 관세·무역 특화 MCP 서버가 있다면 /submit 페이지로 제보해 주시면 감사하겠습니다.