세금 계산 AI 에이전트 MCP 구성법 — 양도세·증여세 자동화 완전 가이드
세금 계산 AI 에이전트 MCP를 설치하고 Claude로 양도세·증여세·취득세를 자동 계산하는 방법을 단계별로 안내합니다. 한국 법령 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 키를 발급받습니다. 발급은 무료이며, 승인까지 시간이 걸릴 수 있으니 미리 신청해 두는 편이 좋습니다. 발급 후 마이페이지에서 키를 확인합니다.
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_OC": "여기에_발급받은_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에게 “어떤 법 조항을 근거로 계산했는지 출처 조항을 보여줘”라고 요청하면 됩니다.
세금 계산 서버는 하나가 아닙니다: 서버별 차이와 고르는 기준
2026년 11월 기준 MCP모아에는 세금과 직접 관련된 서버가 여러 개 등록되어 있고, 하는 일이 서로 다릅니다. 이 글의 Korean Law MCP는 법령과 결정례를 찾아 주는 조회 도구이고, 계산 자체는 Claude가 문장으로 풀어 줍니다. 계산을 코드로 확정하고 싶다면 아래 서버도 비교해 보세요.
법령 조회 서버와 계산 서버는 무엇이 다른가요?
한국 법령 MCP는 법제처 42개 공공 API를 17개 도구로 묶은 서버로, 법령·판례·조세심판 결정례·해석례를 조회합니다. MCP모아 편집팀의 소스 점검에서 악성 동작은 확인되지 않았으며 2026년 11월 재점검 기준 판정은 주의입니다. 로컬 설치(npx)는 공공 도메인만 호출해 안전하지만 기본 원격 연결은 저자 서버를 거쳐 키가 전달되니 주의입니다. 다만 숫자 계산은 언어 모델이 하므로 같은 질문에도 계산 과정이 달라질 수 있습니다.
반면 업스테이지 한국 세금 계산·세무조정 MCP는 종합소득세, 퇴직소득세, 양도소득세, 상속증여세, 부가세 계산을 100여 개 도구로 코드가 수행하고 결과마다 근거 조문을 붙입니다. 연도별 세율표가 없는 해는 추정하지 않고 멈추며, 입력이 부족하면 필요한 항목을 되묻습니다. uvx로 실행하고 기본은 키 없이 동작합니다.
세법 해석 근거만 필요하면 어떤 서버인가요?
업스테이지 한국 세법 근거 MCP는 기준일에 시행 중이던 조문, 국세청 질의회신, 조세심판원 결정례, 세법집행기준을 문서번호와 링크로 찾아 주는 27개 도구 서버입니다. 계산이나 세무 자문은 하지 않고 근거 자료를 찾는 데 집중합니다. 이미 계산 결과가 있고 그 근거 조문이 맞는지 확인하려는 경우에 어울립니다.
세 서버를 한눈에 비교하면
| 구분 | 한국 법령 MCP | 세금 계산·세무조정 MCP | 세법 근거 MCP |
|---|---|---|---|
| 주 역할 | 법령·판례 원문 조회 | 코드로 세액 계산 | 질의회신·결정례 검색 |
| 실행 방식 | npx | uvx | uvx |
| 키 | 법제처 키 필요 | 기본은 불필요 | 조문 조회에 선택 |
| 어울리는 질문 | 이 조문의 현행 원문은? | 이 조건의 세액은? | 이 쟁점의 해석례는? |
계산 결과가 홈택스와 다를 때 점검 순서는?
먼저 양도일이나 증여일 같은 기준일이 같은지 봅니다. 세법은 기준일마다 적용 조문이 달라서 기준일이 어긋나면 결과가 달라집니다. 다음으로 입력 누락을 확인합니다. 보유 기간, 거주 기간, 주택 수처럼 빠진 항목을 Claude가 임의로 가정했을 수 있으니 가정한 값을 모두 말해 달라고 요청하세요. 마지막으로 근거 조문과 시행일을 물어 법제처 원문과 대조합니다. 그래도 차이가 풀리지 않으면 세무사에게 가져가는 것이 맞습니다.
흔한 오류와 해결법
| 오류 상황 | 원인 | 해결 방법 |
|---|---|---|
| ”MCP 도구를 찾을 수 없습니다” | 설정 파일 저장 후 재시작 미완료 | Claude Desktop 완전 종료 후 재시작 |
| ”API 키 인증 실패” | 환경 변수 키 오류 | JSON의 LAW_OC 값 재확인 |
| ”법령 조회 결과 없음” | API 일일 호출 한도 초과 | 다음 날 재시도 또는 API 사용량 확인 |
| 계산값이 홈택스와 다름 | 시행령 적용 기준일 차이 | Claude에게 적용 법령 조항 출처 확인 요청 |
| npx 명령 실패 | Node.js 미설치 또는 구버전 | Node.js 18 이상으로 업데이트 |
관련 MCP 서버 더 알아보기
세금 계산 외에 계약서 작성과 법령 검색이 함께 필요하다면 아래 서버를 함께 활용할 수 있습니다.
- 한국 법령 MCP: 법제처 42개 API를 17개 도구로 래핑, 세금 관련 법령 원문 검색에 최적화
- 한국 법령 MCP 서버: 국가법령정보센터 API로 판례·행정규칙까지 실시간 검색
- 한국 계약서 자동생성 MCP: 세금 신고 이후 필요한 8종 계약서를 Claude에서 자동 생성
법률·세금 분야 MCP 서버 전체 목록은 법률·세금 카테고리에서 확인할 수 있습니다.
자주 묻는 질문
세금 계산 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 커뮤니티에 기여해 주세요.