세금 계산 AI 에이전트 MCP 구성법 — 양도세·증여세 자동화 완전 가이드

세금 계산 AI 에이전트 MCP를 Claude에 연결하면 양도세·증여세·취득세를 대화형으로 자동 계산할 수 있습니다. 핵심 도구는 법제처 Open API를 래핑한 Korean Law MCP로, Claude가 실시간 법령을 조회하여 세율과 공제 항목을 자동 적용합니다. 이 가이드에서는 API 키 발급부터 Claude Desktop 연동, 실제 세금 계산 프롬프트 작성까지 모든 단계를 다룹니다.

왜 세금 계산에 AI 에이전트가 필요한가

한국의 세금 체계는 복잡합니다. 양도소득세 하나만 해도 보유 기간, 거주 여부, 다주택자 여부, 조정대상지역 여부, 장기보유특별공제율에 따라 세율이 수십 가지로 갈립니다. 증여세는 수증자와 증여자의 관계에 따라 공제 한도가 달라지고, 10년 합산 규정까지 고려해야 합니다.

세무사에게 의뢰하기 전 사전 시뮬레이션을 해보고 싶거나, 복수의 시나리오를 빠르게 비교하고 싶을 때 AI 에이전트가 효과적입니다. MCP를 통해 Claude는 법제처 법령 원문을 실시간으로 가져와 계산 근거를 투명하게 제시할 수 있습니다.

[세금 계산 데이터 흐름]

사용자 질의
    │
    ▼
Claude (AI 에이전트)
    │
    ▼ MCP 도구 호출
Korean Law MCP 서버
    │
    ▼ Open API 요청
법제처 (open.law.go.kr)
국가법령정보센터
    │
    ▼ 법령·세율 반환
Claude → 계산 결과 제시

준비물

항목	내용	비고
Claude Desktop 또는 Claude Code	최신 버전	공식 사이트 다운로드
Node.js	18 이상	npx 사용을 위해 필요
법제처 Open API 키	무료 발급	open.law.go.kr 회원가입
계산 대상 세금 정보	취득가액·양도가액 등	거래 문서 사전 준비

단계별 설치 방법

1단계. 법제처 Open API 키 발급

open.law.go.kr 에 접속하여 회원가입 후 API 키를 발급받습니다. 발급은 무료이며 승인까지 보통 1~2일이 소요됩니다. 발급 후 마이페이지에서 키를 확인합니다.

2단계. Korean Law MCP 설치

터미널에서 아래 명령으로 서버를 설치합니다. Korean Law MCP는 법제처 42개 API를 17개 MCP 도구로 래핑한 서버입니다.

npx korean-law-mcp setup

설치 중 API 키 입력을 요청합니다. 1단계에서 발급받은 키를 입력합니다.

3단계. Claude Desktop 설정 파일 편집

Claude Desktop의 설정 파일을 열어 MCP 서버를 등록합니다.

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

아래 내용을 mcpServers 항목에 추가합니다.

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

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 재시작합니다.

4단계. 연결 확인

Claude Desktop을 재시작하면 좌측 하단 또는 도구 목록에 MCP 도구가 표시됩니다. 아래와 같이 간단한 질문으로 연결을 확인합니다.

"소득세법 제94조를 조회해 줘"

법령 내용이 정상적으로 반환되면 연결이 완료된 것입니다.

5단계. 세금 계산 프롬프트 작성

연결이 확인됐으면 실제 세금 계산을 진행합니다. 아래 예시 프롬프트를 참고하세요.

양도소득세 계산 예시

다음 조건으로 양도소득세를 계산해 줘.
- 부동산 종류: 1주택 (아파트)
- 취득일: 2018년 3월 15일, 취득가액: 3억 5천만 원
- 양도일: 2025년 9월 30일, 양도가액: 6억 원
- 거주 기간: 4년
- 조정대상지역 여부: 해당 없음
- 장기보유특별공제 적용 여부와 세율을 포함해서 계산해 줘.

증여세 계산 예시

다음 조건으로 증여세를 계산해 줘.
- 증여자: 부모
- 수증자: 성인 자녀 (만 30세)
- 증여 재산: 현금 1억 5천만 원
- 최근 10년 내 이전 증여: 3천만 원 (2020년)
- 공제 한도, 세율, 납부 세액을 단계별로 보여줘.

취득세 계산 예시

다음 조건으로 취득세를 계산해 줘.
- 취득 원인: 매매
- 부동산 종류: 아파트
- 취득가액: 4억 원
- 지역: 서울 (조정대상지역)
- 현재 보유 주택 수: 1채 (이미 1채 보유 중, 이번이 2번째)
- 적용 세율과 지방교육세, 농어촌특별세 포함하여 계산해 줘.

6단계. 결과 검증

AI 계산 결과는 반드시 교차 확인이 필요합니다. 국세청 홈택스의 양도소득세 자동계산 기능이나 행정안전부의 부동산 취득세 계산기와 비교하여 결과를 검증하세요. 차이가 있다면 Claude에게 “어떤 법 조항을 근거로 계산했는지 출처 조항을 보여줘”라고 요청하면 됩니다.

흔한 오류와 해결법

오류 상황	원인	해결 방법
”MCP 도구를 찾을 수 없습니다”	설정 파일 저장 후 재시작 미완료	Claude Desktop 완전 종료 후 재시작
”API 키 인증 실패”	환경 변수 키 오류	JSON의 `LAW_API_KEY` 값 재확인
”법령 조회 결과 없음”	API 일일 호출 한도 초과	다음 날 재시도 또는 API 사용량 확인
계산값이 홈택스와 다름	시행령 적용 기준일 차이	Claude에게 적용 법령 조항 출처 확인 요청
npx 명령 실패	Node.js 미설치 또는 구버전	Node.js 18 이상으로 업데이트

자주 묻는 질문

세금 계산 AI 에이전트 MCP는 실제 세금 신고에 사용할 수 있나요?

AI 에이전트의 세금 계산 결과는 참고용입니다. 실제 세금 신고 시에는 공인세무사 또는 국세청 홈택스를 통해 최종 확인하시기 바랍니다. 법령 해석의 오류 가능성이 있으므로 공식 신고에 그대로 사용하지 마세요.

Korean Law MCP를 사용하려면 반드시 API 키가 필요한가요?

네, 법제처 Open API(open.law.go.kr)에서 회원가입 후 API 키를 발급받아야 합니다. 무료로 발급 가능하지만 일일 호출 한도가 있습니다.

양도세와 증여세 계산에서 어떤 정보를 입력해야 하나요?

양도세는 취득가액, 양도가액, 보유 기간, 거주 여부, 다주택 여부 등이 필요합니다. 증여세는 증여재산 종류, 증여금액, 수증자와 증여자의 관계, 과거 10년간 증여 내역 등이 필요합니다.

취득세 계산도 MCP로 가능한가요?

네, 취득세는 취득 원인(매매·상속·증여 등), 취득가액, 취득 부동산 종류(주택·토지·건물), 지역(조정대상지역 여부) 등을 입력하면 AI가 관련 법령을 조회하여 세율을 안내합니다.

Claude Code와 Claude Desktop 중 어느 환경에서 사용하나요?

두 환경 모두 지원합니다. Claude Desktop은 GUI 환경에서 간편하게 사용하고, Claude Code는 터미널에서 코드와 함께 세금 계산을 자동화할 때 활용합니다.

세금 법령이 바뀌면 계산 결과도 자동으로 업데이트되나요?

Korean Law MCP는 법제처 API를 실시간 호출하므로 최신 법령을 반영합니다. 다만 시행령 개정 후 API 반영까지 시간차가 있을 수 있으므로, 중요한 계산은 국세청 홈택스에서 교차 확인하세요.

다음 단계

세금 계산 MCP 구성을 마쳤다면 한 단계 더 나아가 보세요. 법률·세금 카테고리에서 한국 법령 검색·판례 조회·계약서 자동생성 등 관련 MCP 서버를 추가로 탐색하거나, 가이드 목록에서 다른 분야의 MCP 연동 가이드를 확인할 수 있습니다. 새로운 세금 계산 MCP 서버를 발견했다면 서버 목록에서 검색하거나 직접 등록해 한국 MCP 커뮤니티에 기여해 주세요.