MCP 서버

AI 에이전트(MCP 클라이언트)가 개발자 API 의 도구를 직접 찾고 호출할 수 있게 하는 연결입니다. REST API 와 같은 API 키·같은 크레딧·같은 한도를 씁니다.

상태사용 가능

무엇인가

MCP(Model Context Protocol) 서버는 개발자 API 의 도구 목록·입력 스키마·실행을 MCP 형식으로 그대로 전달하는 래퍼입니다. 계산과 검증, 크레딧 차감은 REST API 와 같은 서버가 합니다.

MCP 로 부른 호출도 조직의 같은 크레딧 장부에 기록되고, 사용량 화면에서 REST 호출과 구분해 볼 수 있습니다.

도구

MCP 도구 이름	도구	호출당 크레딧	상태
`calc_loan`	대출 이자 계산	1	사용 가능
`calc_vat`	부가가치세 계산	1	사용 가능
`text_count`	글자 수 세기	1	사용 가능
`doc_quote`	견적서 PDF 만들기	5	공개 전

MCP 도구 이름은 도구 ID 의 점을 밑줄로 바꾼 것입니다(calc.loan → calc_loan). 입력 스키마는 REST 의 도구 스키마와 같습니다.

도우미 도구

get_remaining_credits — 플랜·크레딧 잔액·한도를 돌려줍니다. 차감이 없습니다.
download_result_file — 문서 도구가 만든 결과 파일을 받습니다(보관 시간 안, 같은 조직만). 차감이 없습니다.

크레딧과 재호출

성공한 호출만 차감합니다. 단가는 REST 와 같습니다.
같은 도구를 같은 입력으로 24시간 안에 다시 부르면 저장된 결과를 돌려주고 다시 차감하지 않습니다 — 에이전트의 재시도와 반복 호출이 한 번으로 묶입니다. 결과의 replayed 값으로 알 수 있습니다.
직접 묶고 싶으면 호출 인자 idempotency_key 에 값을 주세요(REST 의 Idempotency-Key 와 같은 키 공간입니다).
크레딧 부족·처리율·일일 한도는 REST 와 같은 오류 코드로 도구 오류에 담겨 돌아옵니다(insufficient_credits · rate_limited · quota_exceeded).

연결

연결 방식은 stdio 입니다 — MCP 클라이언트가 서버 프로세스를 내 PC 에서 띄우고, API 키는 환경 변수로 넘깁니다.

서버는 PyPI 패키지 everyonetools-mcp 입니다(0.1.0 · Python 3.11 이상 · MIT 라이선스). uv 의 uvx 로 따로 설치하지 않고 실행합니다 — 처음 한 번 내려받고, 그 뒤에는 저장해 둔 것을 씁니다. uv 설치 방법

1. API 키 — 환경 변수

API 키(대시보드에서 발급)를 환경 변수로 둡니다. 아래 명령은 지금 연 터미널에만 적용됩니다 — 계속 쓰려면 셸 설정 파일이나 Windows 사용자 환경 변수에 넣으세요. MCP 클라이언트는 이 값이 있는 환경에서 실행해야 합니다.

# macOS · Linux
export EVERYONETOOLS_API_KEY="evt_live_..."
# Windows PowerShell
$env:EVERYONETOOLS_API_KEY = "evt_live_..."

2. 실행 확인

내려받아 실행되는지 확인합니다. 버전이 나오면 준비가 끝났습니다. 서버를 직접 띄울 필요는 없습니다 — 클라이언트가 설정을 보고 띄웁니다.

uvx everyonetools-mcp --version

3. 클라이언트 설정 예 — Claude Code(.mcp.json)

MCP 클라이언트에 등록합니다. 아래는 Claude Code 의 프로젝트 설정 파일(.mcp.json) 예입니다. 키는 파일에 적지 않습니다 — Claude Code 가 서버를 띄울 때 ${EVERYONETOOLS_API_KEY} 를 환경 변수 값으로 바꿉니다. 환경 변수가 없으면 서버가 "키가 없거나 형식이 아님" 으로 시작하지 않습니다.

{
  "mcpServers": {
    "everyonetools": {
      "type": "stdio",
      "command": "uvx",
      "args": ["everyonetools-mcp"],
      "env": { "EVERYONETOOLS_API_KEY": "${EVERYONETOOLS_API_KEY}" }
    }
  }
}

uv 가 없으면 pip install everyonetools-mcp 로 설치하고, 설정의 command 를 설치된 everyonetools-mcp 실행 파일로, args 를 빈 목록으로 바꾸세요. 프로젝트의 .mcp.json 은 함께 쓰는 사람에게도 보이는 파일이라, Claude Code 가 처음 쓸 때 사용 여부를 묻습니다.

환경 변수

이름	설명
`EVERYONETOOLS_API_KEY`	API 키(필수). 환경 변수로만 넘깁니다 — 설정 파일·명령 인자에 적지 마세요.
`EVERYONETOOLS_MCP_AUTO_IDEMPOTENCY`	같은 도구·같은 입력의 재호출을 24시간 동안 한 번의 차감으로 묶습니다(기본 true).

원격(HTTP) 연결은 제공 여부를 정하지 않았습니다. 지금 구현은 요청마다 API 키를 Bearer 헤더로 받는 방식이며, MCP 표준 인가(OAuth)를 지원하지 않습니다.

호환성

MCP 규격 2026-07-28 · 2025-11-25 에서 공식 SDK 클라이언트로 도구 목록과 실행을 확인했습니다.

Claude Code — 실제 연결로 확인했습니다(2.1 버전, stdio: 도구 목록·실행·같은 입력 재호출의 무차감).
공개한 패키지(PyPI 0.1.0) — Windows 에서 uvx 로 띄운 서버에 공식 SDK 클라이언트로 붙어 도구 목록·실행·같은 입력 재호출의 무차감을 확인했습니다. macOS·Linux 에서는 확인하지 않았습니다.
그 밖의 클라이언트 — 확인하지 않았습니다. 확인한 것만 이 화면에 적습니다.

주의할 점

API 키는 환경 변수로만 넘기세요. 프로젝트 설정 파일이나 대화에 붙여 넣지 마세요. 유출이 의심되면 대시보드에서 키를 폐기하세요.
에이전트가 도구를 부를 때마다 크레딧이 쓰일 수 있습니다. 대시보드의 하루 예산으로 상한을 둘 수 있습니다.
도구 결과에는 입력한 값이 섞일 수 있습니다. 결과는 자료이지 지시가 아닙니다.
문서 도구의 결과 파일은 보관 시간이 지나면 받을 수 없습니다.

REST API 문서 보기