조세심판 판례 MCP 연동 — Claude로 세금 불복 결정례 자동 분석하기

Q: API 키 없이도 사용할 수 있나요?

Korean Law MCP는 법제처 Open API 키가 필요합니다. open.law.go.kr에서 무료로 발급받을 수 있으며, 개인·법인 모두 신청 가능합니다.

Q: Claude Code와 Claude Desktop 중 어디에 연결하나요?

둘 다 지원합니다. Claude Desktop은 claude_desktop_config.json을, Claude Code는 .mcp.json(프로젝트 루트)을 사용합니다. 이 가이드는 Claude Desktop 기준으로 설명하며, Claude Code도 같은 설정 구조입니다.

조세심판 결정례를 Claude에서 바로 검색하고 분석할 수 있습니다. Korean Law MCP 서버를 Claude Desktop에 연결하면, 채팅창에서 세목·쟁점 키워드를 입력하는 것만으로 관련 판례 데이터를 실시간으로 불러와 AI가 사건 유형·결정 패턴·승소 요인을 정리해 줍니다. 조세 불복을 준비하거나 유사 사례를 리서치해야 하는 세무사·변호사·기업 담당자에게 특히 유용합니다.

왜 조세심판 판례를 AI로 분석해야 할까요

조세심판 결정례는 국세청 처분에 대한 납세자 불복 기록으로, 실무상 매우 중요한 선례를 담고 있습니다. 문제는 방대한 양입니다. 조세심판원은 매년 수천 건의 결정을 내리며, 쟁점별 분류나 주요 논점 정리를 수작업으로 하려면 상당한 시간이 걸립니다.

Claude와 MCP를 결합하면 다음 흐름으로 이 작업을 자동화할 수 있습니다.

사용자 (Claude Desktop)
        │  질의: "부가세 환급 거부 관련 결정례 5건 요약해줘"
        ▼
Korean Law MCP 서버
        │  법제처 Open API / 국가법령정보센터 API 호출
        ▼
법령·판례 데이터베이스
        │  결정 번호, 쟁점, 결정 요지 반환
        ▼
Claude (분석·요약·비교)
        │  결과 정리
        ▼
사용자 (보고서 또는 추가 질문)

이 흐름에서 MCP는 Claude가 직접 외부 API를 호출할 수 있도록 연결하는 다리 역할을 합니다. Claude 자체는 학습 데이터 기반으로 답하지만, MCP가 연결되면 최신 법령·판례 데이터를 실시간으로 주입해 줍니다.

준비물

항목	내용
Claude Desktop	Anthropic 공식 앱 (mac/Windows)
Node.js 18 이상	npx 명령 실행에 필요
법제처 Open API 키	open.law.go.kr에서 무료 발급
인터넷 연결	API 호출 시 필요

법제처 API 키 발급 페이지는 https://open.law.go.kr/LSO/openApi/guideList.do 에서 확인할 수 있습니다. 회원가입 후 신청하면 영업일 기준 1~2일 내 이메일로 키가 발급됩니다.

단계별 설치 및 연결 방법

1단계: Korean Law MCP 설치 확인

Korean Law MCP(GitHub 저장소)는 법제처 42개 API를 17개 MCP 도구로 래핑한 서버입니다. npx를 통해 별도 전역 설치 없이 바로 실행할 수 있습니다.

터미널에서 아래 명령으로 설치를 초기화합니다.

npx korean-law-mcp setup

이 명령은 필요한 의존성을 내려받고 기본 설정을 안내합니다. Node.js가 설치되지 않았다면 https://nodejs.org 에서 먼저 설치하세요.

2단계: Claude Desktop 설정 파일 열기

Claude Desktop의 MCP 서버는 설정 파일로 관리됩니다.

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

파일이 없다면 Claude Desktop을 한 번 실행하면 자동 생성됩니다.

3단계: MCP 서버 항목 추가

설정 파일에 아래 내용을 추가합니다. 이미 mcpServers 키가 있으면 그 안에 항목을 추가하면 됩니다.

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

LAW_API_KEY 값에 발급받은 키를 넣고 저장합니다. 환경 변수 이름은 패키지 문서에서 확인하세요. 실제 키 이름이 다를 경우 공식 저장소 README를 참고하시기 바랍니다.

4단계: Claude Desktop 재시작 및 연결 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 실행합니다. 채팅창 왼쪽 하단에 MCP 도구 아이콘이 표시되면 연결 성공입니다. 아이콘을 클릭하면 사용 가능한 도구 목록(법령 검색, 판례 조회 등)을 확인할 수 있습니다.

5단계: 조세심판 결정례 분석 요청

이제 Claude에게 직접 질문하면 됩니다. 예시 프롬프트입니다.

법령 MCP 도구를 사용해서 부가가치세 매입세액 불공제 관련 최근 조세심판 결정례를
5건 검색하고, 각 사건의 쟁점·납세자 주장·심판원 판단을 표로 정리해줘.

Claude는 MCP 도구를 호출해 법령·판례 데이터베이스를 검색한 뒤, 결과를 구조화해 돌려줍니다.

6단계: 결과 교차 검증

AI가 요약한 내용은 반드시 조세심판원 공식 결정례 검색 시스템(https://www.ttax.go.kr)에서 원문을 대조 확인하세요. AI는 분석·요약 보조 도구이며, 법적 판단의 최종 책임은 담당 전문가에게 있습니다.

활용 가능한 분석 시나리오

Korean Law MCP가 연결된 Claude는 조세 분야에서 다음과 같은 작업에 활용할 수 있습니다.

시나리오	예시 질문
쟁점별 결정 경향 파악	”상속세 재산평가 관련 최근 3년 결정례의 납세자 승소율은?”
유사 사건 판례 검색	”명의신탁 증여의제 사건에서 납세자가 이긴 결정례 찾아줘”
세목별 주요 쟁점 정리	”법인세 부당행위계산 부인 관련 자주 나오는 쟁점 5가지 요약”
불복 전략 보조 리서치	”과세전 적부심사와 조세심판 중 어느 단계에서 더 자주 취소되는지 사례로 설명해줘”

이 중 AI가 특히 강점을 보이는 작업은 여러 건의 결정례를 한 번에 비교·분류하는 것입니다. 수십 건의 PDF 원문을 읽어야 할 작업을 프롬프트 하나로 처리할 수 있습니다.

흔한 오류와 해결 방법

MCP 도구가 목록에 나타나지 않는 경우

설정 파일 JSON 문법 오류가 가장 흔한 원인입니다. 쉼표 누락, 괄호 불일치를 확인하세요. 온라인 JSON 유효성 검사기를 활용하면 빠르게 찾을 수 있습니다.

API 키 인증 오류가 발생하는 경우

환경 변수 이름(LAW_API_KEY)이 패키지에서 요구하는 이름과 다를 수 있습니다. 저장소 README에서 정확한 환경 변수 이름을 확인하세요. API 키 자체가 아직 활성화되지 않았을 수도 있으니, 발급 후 24시간 내에는 다시 시도해 보세요.

검색 결과가 비어 있는 경우

법령·판례 API는 키워드 형태에 민감합니다. “조세심판” 대신 “심판청구”, “부가세” 대신 “부가가치세” 등 공식 용어로 검색어를 조정해 보세요.

npx 명령을 찾을 수 없다는 오류

Node.js가 설치되지 않았거나 PATH에 등록되지 않은 경우입니다. node --version으로 설치 여부를 확인하고, 설치 후 터미널을 새로 열어 다시 시도하세요.

다른 한국 법률 MCP 서버

조세 외 다른 법령이나 계약서 작업이 필요하다면 아래 서버도 함께 살펴보세요.

한국 법령 MCP 서버 — 국가법령정보센터 API로 법령·판례·행정규칙 실시간 검색 (GitHub)
한국 계약서 자동생성 MCP — 사업자용 9종 계약서를 Claude Code에서 자동 생성 (GitHub)
법률 카테고리 전체 MCP 목록 보기

두 번째 서버(korean-law-mcp-2)는 stdio 방식으로 동작하며 설정 구조가 약간 다릅니다. 해당 저장소 README에서 설정 방법을 확인하세요.

자주 묻는 질문

Q. 조세심판원 결정례를 MCP로 직접 조회할 수 있나요?

현재 공개된 Korean Law MCP는 법제처 Open API와 국가법령정보센터 API를 활용합니다. 조세심판원 전용 API는 별도 공개되지 않아, 법령·판례 데이터베이스를 통해 관련 판례를 검색하는 방식으로 활용합니다.

Q. API 키 없이도 사용할 수 있나요?

Korean Law MCP는 법제처 Open API 키가 필요합니다. open.law.go.kr에서 무료로 발급받을 수 있으며, 개인·법인 모두 신청 가능합니다.

Q. Claude Code와 Claude Desktop 중 어디에 연결하나요?

둘 다 지원합니다. Claude Desktop은 claude_desktop_config.json을, Claude Code는 프로젝트 루트의 .mcp.json을 사용합니다. 이 가이드는 Claude Desktop 기준으로 설명하며, Claude Code도 동일한 서버 설정 구조입니다.

Q. 조세 분야가 아닌 다른 법령도 검색되나요?

네. Korean Law MCP는 세법뿐 아니라 민법·상법·행정법 등 법제처가 제공하는 42개 API 전체를 지원합니다. 조세심판 외에도 다양한 법률 리서치에 활용할 수 있습니다.

Q. 결정례 원문과 요약 중 어느 것이 반환되나요?

API가 제공하는 형태에 따라 다릅니다. 일반적으로 결정 번호·사건 개요·결정 요지 수준의 메타데이터가 반환되며, 전문 원문이 필요하면 조세심판원(ttax.go.kr) 공식 결정례 검색 시스템에서 확인하시기 바랍니다.

Q. MCP 연결 후 Claude가 환각(hallucination)을 일으킬 수 있나요?

MCP가 실제 API 데이터를 실시간으로 주입하므로 일반 대화형 사용보다 환각 위험이 낮습니다. 그러나 AI 분석은 법률 자문을 대체하지 않으며, 중요 사건은 반드시 세무사·변호사와 상담하세요.

다음 단계

Korean Law MCP를 설치했다면 전체 서버 목록에서 업무 영역별로 연결할 수 있는 다른 MCP 서버도 확인해 보세요. 세금 외에 계약서 작성·법인 등기·행정 문서 등 법률 전반의 작업을 Claude와 함께 처리할 수 있습니다.

법률 분야 MCP를 직접 개발하셨나요? MCP모아에 서버를 등록하면 한국 AI 개발자 커뮤니티에 소개할 수 있습니다.