생활·재테크2026년 10월 8일· 5분 읽기
AI로 나만의 세무사를 만들어봅시다
클로드가 국세청 자료와 조세심판원 심판례를 먼저 찾아보고 근거 문서와 날짜를 붙여 답하도록 연결하는 방법과, 연결 전후 답변 비교를 담았어요.
같은 질문을 클로드에 연결 전·후로 물어본 답변이에요. 연결 후에는 국세청 자료를 먼저 검색하고, 쉬운 결론 아래에 근거 문서(국세청 해석·조세심판원 심판례)와 날짜가 붙어 나옵니다.
이게 뭔가요?
클로드가 국세청 자료실을 직접 뒤져 볼 수 있게 해 주는 연결 도구예요. 연결하면 클로드가 답하기 전에 아래 자료를 찾아봅니다.
국세청 해석(예규)·질의회신, 법원 판례, 조세심판원 심판례
기본통칙·집행기준, 국세청 사례집
신고 서식, 조세조약 원천세율
답에 붙은 문서번호가 진짜 있는 문서인지 확인
내 상황과 비슷한 실제 사례 찾아 비교
세법 조문(예전 시점 조문까지): 법제처 키를 넣어야 됩니다(아래 선택 항목 참고)
클로드가 답에 붙인 문서번호(서면-2023-소득-1744, 2025.06.04.)를 국세청 사이트에서 열어 본 실제 페이지예요.
무료(MIT 라이선스)이고, 업스테이지가 깃허브에 공개했어요: github.com/UpstageAI/korean-tax-mcp
1. uv 설치하기 (처음 한 번만)
연결 도구를 실행해 주는 작은 프로그램이에요. 한 줄만 붙여 넣으면 됩니다.
맥
키보드에서 Cmd + Space를 누르고 "터미널"을 검색해 엽니다.
아래 한 줄을 붙여 넣고 Enter를 누릅니다.
curl -LsSf https://astral.sh/uv/install.sh | sh윈도우
시작 버튼을 누르고 "PowerShell"을 검색해 엽니다.
아래 한 줄을 붙여 넣고 Enter를 누릅니다.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"설치 끝 문구가 나오면 창을 닫았다가 다시 열고 uvx --version을 쳐 봅니다. 숫자(버전)가 나오면 성공이에요.
명령어가 낯설면 클로드한테 시켜도 됩니다. "내 컴퓨터에 uv 설치하는 방법 알려주고, 설치됐는지 확인하는 법도 알려줘"라고 물어보세요.
2. 클로드 설정 파일에 붙여 넣기
클로드 데스크탑 앱을 엽니다.
설정 → 개발자 → 설정 편집을 누르면
claude_desktop_config.json파일이 있는 폴더가 열립니다. 이 파일을 메모장(맥은 텍스트 편집기)으로 엽니다.파일 내용을 지우고 아래를 그대로 붙여 넣은 뒤 저장합니다.
{
"mcpServers": {
"korean-tax": {
"command": "uvx",
"args": ["korean-tax-mcp"]
}
}
}파일에 이미 다른 내용("mcpServers" 등)이 있다면 지우지 마세요. "mcpServers" 안에 "korean-tax" 부분만 추가해야 해요. 헷갈리면 파일 내용을 통째로 복사해서 클로드에 "여기에 korean-tax 추가해서 고쳐줘"라고 하면 됩니다.
3. 클로드 완전히 껐다 켜기
창만 닫으면 설정이 안 바뀌어요.
맥: 클로드 창에서 Cmd + Q
윈도우: 화면 오른쪽 아래 작업 표시줄의 클로드 아이콘 우클릭 → 종료
그다음 클로드를 다시 엽니다. 처음 켤 때 연결 도구를 내려받느라 몇 초 더 걸릴 수 있어요.
4. 연결됐는지 확인하기
새 대화를 열고 입력창 아래 도구(연결) 메뉴를 눌러 korean-tax가 켜져 있는지 봅니다.
아래처럼 물어봅니다.
프리랜서인데 노트북 산 거 경비로 처리할 수 있어? 국세청 근거 문서번호도 같이 알려줘클로드가 도구 사용 허락을 물으면 허용을 누릅니다. 답 중간에 국세청 자료를 찾는 표시가 뜨고, 답에 문서번호가 붙어 나오면 성공이에요.
안 보이면 이것부터 (맥)
클로드가 uvx를 못 찾는 경우가 있어요. 터미널에 which uvx를 쳐서 나온 주소(예: /Users/내이름/.local/bin/uvx)를 복사하고, 설정 파일의 "uvx" 자리에 그 주소를 그대로 넣은 뒤 다시 Cmd + Q → 재실행하세요.
바로 복사해서 물어볼 질문 10개
질문 끝에 "국세청 근거 문서번호도 같이 알려줘"를 붙이면 근거까지 받을 수 있어요.
프리랜서인데 업무용으로 산 노트북, 경비 처리할 수 있어?회사 다니면서 부업으로 1년에 500만원 벌었는데 종합소득세 신고해야 돼?3.3% 떼고 받은 강의료, 5월에 신고하면 돈 돌려받을 수 있어?간이과세자도 부가세 신고해야 돼? 언제 하는 거야?혼자 쇼핑몰 시작하는데 간이과세자랑 일반과세자 중에 뭐가 나아?집에서 일하는 프리랜서인데 월세랑 관리비 일부를 경비로 넣을 수 있어?내 차로 거래처 미팅 다니는데 기름값이랑 보험료 경비 처리돼?연말정산 때 부모님을 부양가족으로 올리려면 조건이 뭐야?월세 사는 직장인인데 연말정산에서 월세 공제 받을 수 있어?스마트스토어로 조금씩 파는데 사업자 등록 안 해도 괜찮아?답에 나온 문서번호가 미심쩍으면 이어서 "방금 말한 문서번호가 실제로 있는 건지 확인해줘"라고 하세요. 연결 도구가 실제 문서인지 다시 찾아봅니다.
(선택) 클로드 코드를 쓰는 분
터미널에 아래 한 줄이면 연결됩니다. uv 설치(1단계)는 먼저 해 두세요.
claude mcp add korean-tax -- uvx korean-tax-mcp(선택) 키를 넣으면 뭐가 달라지나요?
키 없이 되는 것: 국세청 해석·판례 검색과 본문, 기본통칙·집행기준, 사례집, 문서번호 확인.
법제처 키(LAW_OC): 법령 조문을 날짜별로 찾아보는 기능은 이 키가 있어야 됩니다. open.law.go.kr에서 무료로 신청해요.
업스테이지 API 키: 내 사례와 판례 비교, 결과 요약, 영어 번역 같은 부가 기능이 켜집니다.
키는 설정 파일의 "args" 줄 아래에 "env": { "LAW_OC": "내 OC", "UPSTAGE_API_KEY": "내 키" }처럼 넣어요. 처음엔 없이 써 보세요.
⚠️ 꼭 알아둘 것
이 도구는 자료를 찾아 주는 연구 보조예요. 세무 자문이 아닙니다.
세법과 해석은 바뀔 수 있어요. 답에 붙은 문서의 날짜를 꼭 보세요.
최종 신고 전엔 꼭 세무사에게 확인받으세요. 금액이 크거나 처음 하는 신고라면 더더욱요.
막히면 화면을 캡처해서 @moodmode.ai 인스타그램 DM으로 보내주세요. 어디서 막혔는지 같이 봐드릴게요.
매주 새로운 AI 정보를 가장 빠르게 받아보세요 → 인스타그램 @moodmode.ai