클로드 세금 계산기 85개 설치 가이드

업스테이지가 공개한 korean-tax-calc-mcp(한국 세금 계산 도구 85개 · MIT 라이선스 · 키 없이 동작)를 클로드에 붙이는 방법이에요.

• 공식 저장소: https://github.com/UpstageAI/korean-tax-calc-mcp
• 계산은 코드가 조문 순서대로 하고 결과마다 근거 조문이 붙어요.
• 세율·한도는 그해 연도표에서 꺼내요. 표가 없는 해는 추정하지 않고 멈춰요.
• 계산·판정 도구 73개는 생성형 AI 없이 내 PC에서 돌아가요.
• 도구 이름을 몰라도 평소 말로 물으면 맞는 계산기를 찾아 줘요.

1. 시작 전 준비

어디에 붙이나요? 클로드 코드(Claude Code)에 붙여요. 내 컴퓨터에서 명령을 실행할 수 있는 클로드라서 설치를 통째로 맡길 수 있어요. Windows와 macOS 모두 같은 방법이에요.

uv가 꼭 필요한가요? 네. 공식 설치 명령이 uvx korean-tax-calc-mcp로 계산기를 실행하는데, uvx는 uv라는 무료 프로그램에 들어 있어요. 파이썬을 따로 깔지 않아도 uv가 필요한 버전을 알아서 받아요. uv 설치도 아래 요청문에 넣어 뒀으니 직접 할 일은 없어요.

내가 직접 하는 것은 두 가지뿐이에요.

1. 클로드 코드 설치와 로그인 (처음 한 번 · 공식 안내 https://code.claude.com/docs/ko/overview )
2. 설치 중 클로드가 명령 실행 권한을 물으면 승인

준비물 확인

• 클로드 코드가 열리고 로그인돼 있어요
• 인터넷에 연결돼 있어요 (처음 실행할 때 계산기를 내려받아요)
• 업스테이지 키는 없어도 돼요 (PDF 표 추출 3개에만 선택으로 써요)

2. 설치 요청문 — Windows

클로드 코드를 열고 아래 전체를 붙여 넣어요.

아래 공식 저장소 README를 읽고 korean-tax-calc-mcp를 이 클로드 코드에 연결해 줘. 내 컴퓨터는 Windows야.
https://github.com/UpstageAI/korean-tax-calc-mcp

1. uv(uvx)가 설치돼 있는지 uvx --version으로 확인해 줘.
   없으면 uv 공식 설치 명령으로 설치해 줘.
   PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   설치 뒤 새 터미널에서 uvx --version이 나오는지 다시 확인해 줘.
2. 아래 명령으로 계산기가 실행되는지 먼저 확인해 줘. 사용법(usage)이 나오면 정상이야.
   uvx korean-tax-calc-mcp --help
3. 어느 폴더에서 클로드 코드를 열어도 쓸 수 있게 user 범위로 연결해 줘.
   claude mcp add --scope user korean-tax-calc -- uvx korean-tax-calc-mcp
4. claude mcp list에서 korean-tax-calc 옆에 Connected가 보이는지 확인해 줘.
5. 키는 넣지 마. 기본 계산 도구는 키 없이 동작해.
6. 이미 있는 다른 MCP 설정은 지우거나 바꾸지 말고 그대로 둬.
7. 끝나면 무엇을 설치했는지와 연결 결과를 짧게 알려 줘. 실패한 단계가 있으면 그 단계와 오류 문구를 그대로 보여 줘.

3. 설치 요청문 — macOS

아래 공식 저장소 README를 읽고 korean-tax-calc-mcp를 이 클로드 코드에 연결해 줘. 내 컴퓨터는 macOS야.
https://github.com/UpstageAI/korean-tax-calc-mcp

1. uv(uvx)가 설치돼 있는지 uvx --version으로 확인해 줘.
   없으면 uv 공식 설치 명령으로 설치해 줘.
   터미널: curl -LsSf https://astral.sh/uv/install.sh | sh
   설치 뒤 새 터미널에서 uvx --version이 나오는지 다시 확인해 줘.
2. 아래 명령으로 계산기가 실행되는지 먼저 확인해 줘. 사용법(usage)이 나오면 정상이야.
   uvx korean-tax-calc-mcp --help
3. 어느 폴더에서 클로드 코드를 열어도 쓸 수 있게 user 범위로 연결해 줘.
   claude mcp add --scope user korean-tax-calc -- uvx korean-tax-calc-mcp
4. claude mcp list에서 korean-tax-calc 옆에 Connected가 보이는지 확인해 줘.
5. 키는 넣지 마. 기본 계산 도구는 키 없이 동작해.
6. 이미 있는 다른 MCP 설정은 지우거나 바꾸지 말고 그대로 둬.
7. 끝나면 무엇을 설치했는지와 연결 결과를 짧게 알려 줘. 실패한 단계가 있으면 그 단계와 오류 문구를 그대로 보여 줘.

설치가 끝나면 클로드 코드를 한 번 껐다 켜요.

공식 README의 설치 명령은 claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp예요. 이 명령은 지금 연 폴더에만 연결돼서, 요청문에는 어느 폴더에서나 쓰도록 --scope user를 붙였어요.

클로드 데스크톱 앱에 붙이고 싶다면

README의 설정 한 줄을 앱 설정 파일에 넣어요. 이것도 클로드 코드에 맡겨요.

클로드 데스크톱 앱 설정 파일(claude_desktop_config.json)에 아래 mcpServers 항목을 추가해 줘.
macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json
Windows는 %APPDATA%\Claude\claude_desktop_config.json 이야.
파일이 없으면 만들고, 이미 있는 다른 서버 설정은 그대로 둬. 고친 뒤 JSON 형식이 맞는지 확인해 줘.
uvx가 없으면 uv 공식 설치 명령으로 먼저 설치해 줘.
{ "mcpServers": { "korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] } } }
끝나면 앱을 완전히 종료했다가 다시 켜라고 알려 줘.

4. 연결 확인

클로드 코드를 다시 켜고 이 한 줄을 보내요.

korean-tax-calc의 find_tool로 "퇴직금 세금"에 맞는 도구를 찾아 주고, 그 도구에 필요한 입력 항목을 알려 줘.

retirement_income_tax(퇴직소득세) 같은 도구 이름과 입력 항목이 나오면 연결 완료예요.

• 클로드 코드 입력창에 /mcp를 쳐도 연결된 서버 목록이 보여요.
• 도구 이름을 몰라도 돼요. find_tool이 평소 말로 맞는 계산기를 찾아 줘요.

5. 질문 잘 하는 법

계산기는 이렇게 움직여요. 입력 확인 → 그해 기준값 → 조문 순서대로 계산 → 세액·중간 계산·근거 조문.

• 연도를 꼭 넣어요. “2025 사업연도”, “2025 귀속”, “2025년 1기”처럼요. 그해 세율표로 계산해요.
• 금액은 원 단위로 정확히. “5억”, “1천만 원”처럼 써도 클로드가 원 단위로 바꿔 넣어요.
• 빠진 값이 있으면 계산하지 않고 무엇이 필요한지 먼저 알려 줘요. 그대로 답하면 이어서 계산해요.
• 장부는 그대로 붙여 넣어요. 세무조정 도구는 장부 항목(이름·금액·증빙·성격)을 그대로 받아 항목 판단 → 세무조정 → 소득처분까지 돌려줘요.
• 계산기를 확실히 쓰게 하려면 질문 앞에 “korean-tax-calc로”를 붙여요.

모든 질문 끝에 붙이면 좋은 한 줄

korean-tax-calc 도구로만 계산하고, 쓴 도구 이름과 근거 조문을 같이 보여 줘. 빠진 값이 있으면 추측하지 말고 물어봐.

6. 세금별 질문 34개

★ 공식 README 예시는 문장 그대로예요. 나머지는 대괄호 [ ]만 내 상황으로 바꿔요. 질문마다 클로드가 부르는 도구 이름을 같이 적었어요.

개인 · 직장인

1. 퇴직소득세 ★ · retirement_income_tax

퇴직금 1억 근속 15년 퇴직소득세

2. 종합소득세 산출세액 · income_tax

[2025] 귀속 종합소득 과세표준이 [4,000만 원]이야. 종합소득세 산출세액은?

3. 연말정산 근로소득세 · wage_income_tax

[2025] 귀속 총급여 [5,000만 원] 종합소득 과세표준 [2,800만 원]이야. 근로소득공제·산출세액·근로소득세액공제 계산해줘.

4. 부양가족 인적공제 · personal_deduction

[2025] 귀속 인적공제 계산해줘. 나는 [근로자]이고 부양가족은 [아내(소득 없음)·만 72세 어머니·자녀 2명]이야.

5. 자녀세액공제 · child_tax_credit

[2025] 귀속 자녀세액공제는? 기본공제대상 자녀는 [9살·5살] 두 명이고 [2025년에 셋째 출산]했어.

6. 의료비·교육비·보험료 공제 · special_tax_credit

[2025] 귀속 총급여 [6,000만 원]이야. 공제대상자는 [본인·배우자·자녀 1명]이고 의료비 [300만 원]·교육비 [200만 원]·보장성 보험료 [100만 원]이면 특별세액공제와 표준세액공제 중 뭐가 유리해?

7. 금융소득 종합과세 · financial_income_aggregate → dividend_tax_credit

[2025] 귀속 예금이자 [1,500만 원] 국내 상장주식 배당 [1,200만 원]이야. 금융소득 종합과세 대상인지와 배당가산(Gross-up)액, 배당세액공제까지 계산해줘.

8. 연금계좌 인출 · pension_account_withdrawal

연금저축에서 [2025]년에 [1,500만 원]을 인출하려고 해. 나는 [1968-03-01]생이고 가입일 [2012-05-01], 연금수령 개시 신청일 [2025-01-10], 연초 평가액 [1억 2천만 원], 납입액 합계 [9,000만 원] 중 세액공제 안 받은 납입액 [1,000만 원]이야. 연금수령분과 연금외수령분을 나눠줘.

집 · 상속 · 증여

9. 집 팔 때 양도소득 · capital_gains_income → capital_gains_tax

[2016-04-01]에 [5억]에 산 주택을 [2025-09-30]에 [13억]에 팔았어. [1세대 1주택]이고 [보유·거주 9년]이야. 비과세·고가주택 안분·장기보유특별공제 거쳐서 양도소득 산출세액까지 계산해줘.

10. 증여세 · gift_tax

[2025-11-01]에 [아버지]께 현금 [1억]을 증여받아. 받는 사람은 [성인 자녀]이고 10년 안에 같은 분께 받은 증여는 [없어]. 증여세 납부할 세액은?

11. 상속세 · inheritance_tax

[2025]년 상속 개시, 상속재산 [20억] 채무 [2억] 장례비용 [1,000만 원]이야. 상속인은 [배우자와 자녀 2명]이야. 상속공제·과세표준·납부할 세액 계산해줘.

12. 상속·증여 재산 평가 · inheritance_gift_valuation

[증여]일 [2025-10-01] 기준 아파트 평가액을 구해줘. 기준시가는 [6억]이고 같은 단지 비슷한 집이 [2025-08-20]에 [9억]에 거래됐어.

13. 주택임대소득 · housing_rental_income

[2025] 귀속 [2주택]이고 그중 한 채를 월세 [100만 원]·보증금 [1억]에 [12개월] 임대했어. 비과세인지 분리과세인지 판정하고 분리과세와 종합과세 세액을 비교해줘.

프리랜서 · 개인사업자

14. 프리랜서 3.3% 원천징수 · withholding_tax

프리랜서에게 사업소득 [300만 원]을 [2025]년에 지급해. 원천징수할 소득세는?

15. 일용직 원천징수 · daily_worker_withholding

[2025]년에 일용근로자에게 일급 [20만 원]을 줘. 원천징수세액은?

16. 장부 없는 사업자 추계 · estimated_business_income

[2025] 귀속 [음식점] 사업자야. 직전 연도 수입 [6,000만 원] 올해 수입 [7,000만 원] 증빙 있는 지출 [2,000만 원]이고 기준경비율 [ ]% 단순경비율 [ ]%야. 추계 사업소득금액 계산해줘.

17. 간이과세자 부가세 · vat_simplified_taxpayer · simplified_vat_return

간이과세자 [2025]년 공급대가 [6,000만 원] 업종 [음식점(부가가치율 15%)] 카드·현금영수증 매출 [4,500만 원] 세금계산서 매입 [2,200만 원]이야. 부가세 납부세액은?

18. 카드 매출 발행세액공제 · vat_card_sales_credit

[2025-1]기(공급일 [2025-06-30] 기준) 신용카드·현금영수증 매출 [8,000만 원]이야. 개인사업자이고 올해 이미 받은 공제는 [0원]이야. 신용카드 발행세액공제 계산해줘.

19. 음식점 의제매입세액 · vat_deemed_input_credit

[2025-2]기 [음식점] 개인사업자야. 면세 농산물 매입 [3,000만 원] 과세표준 [1억 2천만 원]이면 의제매입세액공제는?

20. 상가 보증금 간주임대료 · vat_deemed_rent

상가 보증금 [3억]을 [2025-2]기 [184]일 동안 받았어. 부가세 간주임대료 계산해줘.

21. 매입세액 공제 판정 · vat_input_tax_deduction

[2025-1]기 확정신고 매입 내역이야. 항목별로 공제·불공제 판정해줘.
[노트북 / 세금계산서 / 공급가액 200만 원 / 일반]
[거래처 식사 / 신용카드 / 공급가액 30만 원 / 접대]
[직원 출퇴근용 승용차 수리 / 세금계산서 / 공급가액 50만 원 / 비영업용승용차]

가산세 · 제척기간

22. 과소신고 가산세 ★ · underreporting_penalty · late_payment_penalty

과소신고 1천만 원을 10월 7일에 납부하면 가산세는?

23. 납부지연가산세 · late_payment_penalty

납부기한이 [2025-05-31]이었던 세금 [500만 원]을 [2025-10-15]에 냈어. 납부지연가산세는?

24. 세금계산서 가산세 · invoice_penalty

공급가액 [2,000만 원] 세금계산서를 [지연발급]했어. 공급일은 [2025-03-15]야. 세금계산서 가산세는?

25. 부과제척기간 · assessment_limitation

법정신고기한이 [2021-05-31]인 [종합소득세]야. [일반 신고]한 경우 부과제척기간 만료일은?

법인

26. 법인세 산출세액 ★ · corporate_tax

2025 사업연도 과세표준 5억 법인세 산출세액은?

27. 가지급금 인정이자 ★ · deemed_interest

가지급금 3월 1일 2억 대여 9월 30일 1억 회수 인정이자 계산해줘

28. 기업업무추진비(접대비) 한도 · entertainment_limit

[2025] 사업연도 [중소기업]이고 매출 [50억] 기업업무추진비 지출 [6,000만 원]이야. 한도와 한도초과액은?

29. 업무용승용차 · business_car_expense

[2025] 사업연도 업무용승용차 유지비 [1,200만 원] 세법상 감가상각비 [1,600만 원] 장부상 감가상각비 [1,600만 원]이야. 운행기록부는 [작성했고] 업무사용비율 [80%]야. 손금불산입액 보여줘.

30. 최저한세 · minimum_tax

[2025] 사업연도 [중소기업] 감면 전 과세표준 [10억]이야. 최저한세액은?

31. 기부금 한도 · donation_limit

[2025] 사업연도 기준소득 [5억] 특례기부금 [1억] 일반기부금 [8,000만 원]이야. 한도·한도초과·이월액 계산해줘.

장부 → 세무조정

32. 기업업무추진비 세무조정 ★ · entertainment_adjustment

기업업무추진비 원장 5건 그대로 줄게 2025 사업연도 세무조정 뽑아줘
[여기에 장부 5건을 그대로 붙여 넣기: 항목 / 금액 / 증빙 / 성격]

33. 감가상각 시부인 · depreciation_adjustment

[2025] 사업연도 [기계장치] 취득가액 [1억] [정률법] 내용연수 [5년]이고 당기 장부상 감가상각비 [5,000만 원]이야. 상각부인액이나 시인부족액 계산해줘.

34. 차가감소득금액 집계 · income_adjustment_total

당기순이익 [3억]이야. 아래 세무조정 항목으로 차가감소득금액과 각 사업연도 소득금액을 집계해줘.
[항목 / 익금산입·손금불산입 또는 손금산입·익금불산입 / 금액 / 소득처분]

같은 묶음에서 더 물어볼 수 있는 것

• 대손금·대손충당금 → bad_debt_adjustment · 퇴직급여충당금 → retirement_allowance_adjustment · 재고자산 평가 → inventory_valuation_adjustment
• 특수관계 판정 → related_judge · 일감몰아주기 → tunnelling_gift_nts · 신고서 숫자 사전검토 → precheck_schema → return_precheck
• 경매·공매 매각대금 배분 → tax_priority_distribution

7. 연도표가 없는 해는 이렇게 처리해요

공식 README 기준 지원 연도예요.

그 밖의 연도는 추정하지 않고 오류로 멈춰요. 멈추면 클로드가 다른 해 표로 바꿔 계산하지 않게 이렇게 보내요.

계산기가 연도 때문에 멈췄으면 다른 연도 값으로 바꿔서 계산하지 마. 멈춘 이유 문구와 지원 연도를 그대로 보여 줘.

근거 조문을 같이 찾고 싶으면 업스테이지의 짝꿍 서버 korean-tax-mcp를 함께 붙여요. README 설명대로 “근거 찾기 → 계산”이 이어져요.

8. PDF 표 추출 도구와 업스테이지 키

PDF 도구 3개(extract_relations 관계표 · tunnelling_from_pdf 일감몰아주기 자료 · return_precheck_pdf 법인세 신고서)만 키에 따라 동작이 달라져요. 공식 README 문구 그대로예요.

데이터 전송: UPSTAGE_API_KEY를 설정해 PDF 도구를 사용할 때만 문서 내용이 Upstage API(api.upstage.ai)로 전송됩니다. 키 없이 사용하면(pypdf 로컬 추출) 외부 전송이 없습니다. 민감정보가 담긴 문서는 API 전송 시 넣지 마세요.

• 키 없이: 내 PC에서 pypdf로 글자를 뽑고, 정리 안내에 따라 다음 도구 입력으로 정리해요.
• 키를 넣으면: 생성형 AI(Upstage Solar Pro 4)로 표를 추출하고, 결과에 그 사실을 표시해요.
• 나머지 82개 도구는 키와 상관없이 그대로 써요.

키를 넣고 싶을 때 요청문 (키는 내가 직접 붙여 넣어요)

korean-tax-calc 연결에 UPSTAGE_API_KEY 환경변수를 추가하고 싶어. 다른 설정은 그대로 두고, 키를 넣을 자리와 실행할 명령만 알려 줘. 키 값은 내가 직접 붙여 넣을게.

선택 키가 하나 더 있어요. LAW_OC를 넣으면 세무조사 판정 도구 2개가 법제처 조문을 조회해요.

9. 계산 근거를 엑셀로 받기

방금 계산한 내용을 korean-tax-calc의 export_workbook으로 엑셀로 만들어 줘.
문서 제목은 [2025 법인세 검토], 저장 폴더는 [바탕화면] 이야.
회사명 [ ]·사업연도 [2025.01.01 ~ 2025.12.31]도 서식 머리에 넣어 줘.
끝나면 파일 위치와 들어 있는 시트 이름을 알려 줘.

• export_workbook은 앞에서 쓴 도구 호출을 다시 실행해서 엑셀로 정리해요.
• 법정서식 모양(별지 제3호·제15호·제23호(갑)(을)·제50호(을), 양도소득세 별지 제84호 신고서 세액 계산 등)으로 나와요.
• 금액 칸은 서식 산식 그대로의 수식이고 서식끼리 연결돼요. 도구 값과 맞춰 보는 확인 칸도 붙어요.
• 여러 계산을 한 파일로 묶을 수 있어요. “방금 한 계산 전부 한 파일로”라고 보내요.

10. 도구 85개 한글 목록 (공식 README 기준 9묶음)

법인세 (18)

• 산출세액 corporate_tax
• 외국납부세액공제 foreign_tax_credit
• 기업업무추진비 한도 entertainment_limit
• 가지급금 인정이자 deemed_interest
• 부당행위 기준 unfair_transaction
• 이월결손금 한도 loss_carryforward_limit
• 최저한세 minimum_tax
• 업무무관 지급이자 nonbusiness_interest_disallowance
• 업무용승용차 business_car_expense
• 기부금 한도 donation_limit
• 대손충당금 한도 bad_debt_allowance
• 과소자본 thin_capitalization
• 적격증빙 미수취 missing_receipt_disallowance
• 수입배당금 익금불산입 dividend_received_deduction
• 일시상각충당금 asset_grant_reserve
• 임대보증금 간주익금 corporate_deemed_rent_income
• 청산소득 liquidation_income
• 재해손실세액공제 disaster_loss_credit

소득세·원천·양도·상속증여 (23)

• 종합소득세 income_tax
• 원천징수 withholding_tax
• 비거주자 원천징수 nonresident_withholding
• 퇴직소득세 retirement_income_tax
• 근로소득세 wage_income_tax
• 일용근로자 daily_worker_withholding
• 소득처분 상여 재정산 deemed_bonus_resettlement
• 특별세액공제 special_tax_credit
• 양도소득 capital_gains_income
• 상속세 inheritance_tax
• 증여세 gift_tax
• 추계 사업소득 estimated_business_income
• 인적공제 personal_deduction
• 연금소득금액 pension_income
• 결손금 공제 income_loss_offset
• 연금계좌 인출 pension_account_withdrawal
• 상속·증여재산 평가 inheritance_gift_valuation
• 양도소득 산출세액 capital_gains_tax
• 주택 간주임대료 housing_deemed_rent_income
• 주택임대소득(비과세·분리과세) housing_rental_income
• 자녀세액공제 child_tax_credit
• 배당세액공제 dividend_tax_credit
• 종교인소득 religious_income

부가세·가산세·제척기간 (14)

• 간주임대료 vat_deemed_rent
• 의제매입세액 vat_deemed_input_credit
• 공통매입세액 안분 vat_common_input_allocation
• 간이과세 납부세액 vat_simplified_taxpayer
• 카드 발행세액공제 vat_card_sales_credit
• 대손세액공제 vat_bad_debt_credit
• 과소신고가산세 underreporting_penalty
• 납부지연가산세 late_payment_penalty
• 세금계산서 가산세 invoice_penalty
• 부과제척기간 assessment_limitation
• 면세전용 간주공급 vat_exempt_use_deemed_supply
• 매입세액 공제 판정 vat_input_tax_deduction
• 간주공급 판정 vat_deemed_supply_items
• 공급시기 판정 vat_supply_timing

사실관계·원장 → 세무조정 (15)

• 대손 조정 bad_debt_adjustment
• 기업업무추진비 조정 entertainment_adjustment
• 무상주 의제배당 deemed_dividend_bonus_shares
• 금융소득 합산 financial_income_aggregate
• 기타소득 other_income_aggregate
• 근로소득 총급여 earned_income_gross_pay
• 간이과세 확정신고 simplified_vat_return
• 공통매입세액 정산 common_input_tax
• 매입세액 재계산 input_tax_recalculation
• 토지·건물 안분 bundled_supply_split
• 감가상각 시부인 depreciation_adjustment
• 퇴직급여충당금 retirement_allowance_adjustment
• 감자 의제배당 deemed_dividend_capital_reduction
• 재고자산 평가 inventory_valuation_adjustment
• 차가감소득금액 income_adjustment_total

세무조사 판정 (9)

• 특수관계 related_judge
• 친족관계 kinship_check
• 간접보유비율 ownership_ratio
• 지배주주 dominant_shareholder
• 일감몰아주기 tunnelling_gift
• 일감몰아주기(국세청 산식) tunnelling_gift_nts
• 특수관계 조문 위치 related_provision_at
• 신고서 사전검토 return_precheck
• 사전검토 입력 목록 precheck_schema

PDF 표 추출 (3)

• 관계표 extract_relations
• 일감몰아주기 자료 tunnelling_from_pdf
• 법인세 신고서 return_precheck_pdf

국세징수 (1)

• 국세 우선권 매각대금 배분 tax_priority_distribution

엑셀 내보내기 (1)

• 계산 근거 엑셀 export_workbook

도구 찾기 (1)

• 평소 말로 맞는 도구 찾기 find_tool

합계 18 + 23 + 14 + 15 + 9 + 3 + 1 + 1 + 1 = 85개예요.

11. 새 버전 받기

uvx는 한 번 받은 버전을 저장해 두고 계속 써요. 새 기능이 나왔다면 이렇게 보내요.

korean-tax-calc-mcp를 최신 버전으로 바꿔 줘. uvx --refresh korean-tax-calc-mcp --help로 새로 받고, claude mcp list로 연결을 다시 확인해 줘. 끝나면 클로드 코드를 다시 켜라고 알려 줘.

• 바뀐 내용은 공식 CHANGELOG에서 봐요: https://github.com/UpstageAI/korean-tax-calc-mcp/blob/main/CHANGELOG.md
• 특정 버전에 고정하고 싶으면 README대로 uvx korean-tax-calc-mcp@0.15.1처럼 버전을 붙여요.

12. 막힐 때 점검 목록

• uvx를 찾을 수 없다고 나와요 → uv를 설치한 뒤 터미널을 새로 열어야 잡혀요. 클로드 코드도 껐다 켜고 uvx --version부터 다시 확인해요.
• claude mcp list에 korean-tax-calc가 없어요 → 다른 폴더에서 연결했을 수 있어요. --scope user로 다시 연결해 달라고 해요.
• Failed to connect가 떠요 → uvx korean-tax-calc-mcp --help를 직접 실행해서 사용법이 나오는지 봐요. 오류가 나오면 그 문구를 그대로 클로드에게 붙여 넣어요.
• 처음 연결이 오래 걸려요 → 첫 실행 때 계산기를 내려받아요. 잠시 기다린 뒤 claude mcp list로 다시 확인해요.
• 질문했는데 계산기를 안 쓰고 그냥 답해요 → 질문 앞에 “korean-tax-calc로”를 붙이고, 5번의 ’모든 질문 끝에 붙이면 좋은 한 줄’을 같이 보내요.
• 계산 대신 질문이 돌아와요 → 정상이에요. 빠진 값을 먼저 묻는 단계예요. 물어본 값만 답하면 이어서 계산해요.
• 연도 때문에 멈췄어요 → 7번 표의 지원 연도인지 확인해요.
• 엑셀 파일이 안 생겨요 → 저장할 폴더가 실제로 있는지 확인하고, 폴더 경로를 정확히 적어서 다시 보내요.
• 데스크톱 앱에 안 보여요 → 앱을 완전히 종료했다가 다시 켜요. 설정 파일의 JSON 쉼표·괄호가 맞는지 클로드 코드에게 검사를 맡겨요.
• 이미 쓰던 다른 MCP가 사라졌어요 → 요청문 6번(다른 설정은 그대로 둬)을 빼고 보냈는지 봐요. claude mcp list로 목록을 보여 달라고 하고 빠진 것만 다시 연결해요.