AI 비서에서 소크라텍스 쓰기

Claude Code, Cursor 같은 AI 비서 안에서 소크라텍스의 세법 근거와 계산기를 바로 불러 쓸 수 있어요. AI 비서가 소크라텍스에 직접 물어보는 이 연결 방식을 MCP라고 불러요.

로그인하고 연결하기

쓸 수 있는 도구 8개

세법 질문만 웹과 같은 크레딧이 들어요. 나머지 도구는 AI를 쓰지 않아서 크레딧이 들지 않고, 하루 한도 안에서 쓸 수 있어요.

세법 질문

ask_tax_question

근거(법령, 예규, 판례)를 붙인 답을 받아요. 답이 늦으면 번호표를 받고 나중에 가져가요.

크레딧 웹과 같은 크레딧

답 받기

get_tax_answer

늦어진 질문의 답을 번호표로 가져와요.

크레딧 0

조문 원문

get_article

법령 조문 원문을 그대로 가져와요.

크레딧 0

근거 찾기

search_tax_sources

법령, 국세청 예규, 조세심판원과 법원 판례를 낱말로 찾아요.

크레딧 0

연결은 세 단계예요

1. 키 만들기

소크라텍스에 로그인한 뒤 설정의 AI 비서 연결에서 키를 만드세요. 키는 만든 직후 한 번만 보이니 바로 복사해 두세요. 키는 비밀번호처럼 다뤄 주세요.

2. 설정 붙여넣기

쓰는 프로그램을 골라 아래 내용을 붙여 넣고 <내 키> 자리에 만든 키를 넣으세요. 설정 화면의 복사 버튼을 쓰면 키가 이미 들어간 채로 복사돼요.

Claude Code

터미널에서 실행하세요. <내 키> 자리에 만든 키를 넣어요.

claude mcp add --transport http socratax https://socratax-starroot.fly.dev/mcp --header "Authorization: Bearer <내 키>"

질문 답은 보통 1분 안에 와요. 더 걸리면 AI 비서가 접수 번호로 이어서 받아요.

Cursor

.cursor/mcp.json 에 아래 내용을 추가하세요(모든 프로젝트에서 쓰려면 ~/.cursor/mcp.json).

{
  "mcpServers": {
    "socratax": {
      "url": "https://socratax-starroot.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer <내 키>"
      }
    }
  }
}

VS Code

작업 폴더의 .vscode/mcp.json 에 아래 내용을 추가하세요.

{
  "servers": {
    "socratax": {
      "type": "http",
      "url": "https://socratax-starroot.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer <내 키>"
      }
    }
  }
}

Codex

~/.codex/config.toml 에 아래 내용을 추가하고, 환경변수 SOCRATAX_KEY 에 키를 넣으세요.

~/.codex/config.toml

[mcp_servers.socratax]
url = "https://socratax-starroot.fly.dev/mcp"
bearer_token_env_var = "SOCRATAX_KEY"

터미널에서 실행(맥과 리눅스)

export SOCRATAX_KEY="<내 키>"

Claude 데스크톱

claude_desktop_config.json 의 mcpServers 에 아래 내용을 추가하고 Claude 데스크톱을 다시 시작하세요.

{
  "mcpServers": {
    "socratax": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://socratax-starroot.fly.dev/mcp",
        "--header",
        "Authorization:${SOCRATAX_AUTH}"
      ],
      "env": {
        "SOCRATAX_AUTH": "Bearer <내 키>"
      }
    }
  }
}

컴퓨터에 Node.js 가 설치되어 있어야 해요.

설정 파일은 Claude 데스크톱의 설정 > 개발자 > 설정 편집에서 열 수 있어요.

claude.ai 웹, Claude 데스크톱의 커넥터 화면, ChatGPT는 지금은 지원하지 않아요. 키를 직접 넣을 수 있는 위 프로그램에서만 연결돼요.

3. 이렇게 물어보세요

연결한 AI 비서에 아래 문장을 그대로 붙여 넣어 보세요.

인용 검사

방금 쓴 답변에서 인용한 조문과 판례가 실제로 있는지 소크라텍스로 검사해 줘.

근거 찾기

1세대1주택 고가주택 양도에 관한 예규와 조세심판 결정례를 소크라텍스에서 찾아 줘.

양도세 계산

취득가 5억, 양도가 12억인 1세대1주택을 3년 보유하고 2년 거주한 뒤 팔 때 양도세를 소크라텍스 계산기로 계산해 줘.

개인정보

AI 비서에 입력한 내용은 그 AI 회사에도 남아요. 소크라텍스는 질문과 답을 평문으로 저장하지 않고, 답이 늦어질 때만 암호화해 최대 48시간 보관해요.

로그인하고 연결하기