MCP vs CLI: 컨텍스트 토큰 비용 비교
Resumo
Pixel에서 공유된 DEV Community 글은 MCP 서버와 CLI의 도구 정의 토큰 비용을 비교합니다. 측정 사례에서 MCP 서버 4개는 11,923토큰을 추가한 반면 Apidog CLI 스킬은 112토큰만 사용했으며, 이는 에이전트의 컨텍스트 공간과 도구 선택 정확도에 영향을 줄 수 있습니다.
DEV Community
MCP vs CLI: MCP 서버가 컨텍스트 윈도우를 빠르게 소모하는 이유
MCP vs CLI: 도구 정의 토큰이 컨텍스트 윈도우를 얼마나 먹어치우는가 MCP vs CLI의 핵심은 에이전트가 언제 도구에 대한 비용을 지불하느냐에 있습니다. MCP 서버는 사용자가 아무것도 입력하기 전에 모든 도구의 이름, 설명, JSON Schema를 모델에 전송합니다. 반면 CLI는 에이전트가 실제로 실행해서 --help나 출력 결과를 읽기 전까지는 아무 비용도 들지 않습니다. 측정된 환경에서 네 개의 일반적인 MCP 서버는 11,923개의 도구 정의 토큰을 추가한 반면, Apidog CLI 스킬은 112토큰만 추가했습니다. 오늘 Apidog를 사용해 보세요 이 격차가 바로 이번 주에 발행된 두 개의 Dev.to 게시물의 배경에 있는 전부입니다. 한 개발자가 코딩 에이전트에 "Run tests"라고 입력했더니 파일도 첨부하지 않았고 히스토리도 없는데 첫 요청에서 28,400개의 입력 토큰이 소모되는 것을 보았습니다. 원인은 일곱 개의 MCP 서버였습니다. 또 다른 개발자는 MCP가 너무나 간단해서 만들기 쉽다는 점이 바로 문제라고 주장하며, 어려운 부분들(인증, 승인, 중복 호출)은 데모가 동작하는 순간부터 시작된다고 말했습니다. 이 글은 한 가지 질문에 집중합니다. 도구 정의가 컨텍스트 윈도우에 얼마나 비용을 발생시키며, 에이전트가 필요할 때 호출하는 CLI는 언제 더 적은 비용을 들일까요? 만약 문제가 거대한 도구 응답이라면, 비대해진 API 응답 줄이기에 관한 자매 포스트를 읽어보세요. MCP 서버는 왜 컨텍스트 윈도우 토큰을 소모할까 MCP 서버는 tools/list 메서드를 통해 자신의 도구를 알립니다. MCP 도구 사양에 따르면 각 도구는 name, description, inputSchema(인자에 대한 JSON Schema)를 가집니다. 모델이 도구를 선택하려면 클라이언트가 이러한 정의들을 요청에 넣어야 합니다. 전통적인 구성에서는 에이전트가 도구를 호출하든 아니든, 모든 대화의 매 턴마다 이 작업이 일어납니다. 따라서 비용은 세 가지 요소에 따라 커집니다: 도구 개수. 완전한 GitHub 통합은 수십 개의 도구를 노출할 수 있습니다. 스키마 깊이. 중첩된 객체, 열거형, 긴 설명이 모두 토큰이 됩니다. 턴 수. 에이전트 루프는 매 단계마다 정의를 다시 전송합니다. necoz의 포스트는 이에 대한 수치를 제시합니다: 52개 도구로 구성된 스택은 첫 턴에 24,600토큰의 스키마가 소모된 반면, 4개 도구 구성은 640토큰, 10단계 루프 전체에서는 약 246,000토큰이 소모되었습니다. 이는 벤치마크가 아니라 한 개발자의 측정치로 받아들이세요. 프롬프트 캐싱은 반복되는 정의의 금전적 비용을 줄여주지만, 토큰은 여전히 윈도우를 차지하며 코드와 주의(attention)를 두고 경쟁합니다. 품질 비용도 존재합니다. Anthropic의 도구 검색 문서에 따르면 GitHub, Slack, Sentry, Grafana, Splunk를 갖춘 멀티 서버 구성은 "Claude가 아무 작업도 하기 전에 정의만으로 약 55k 토큰을 소모할 수 있으며", 사용 가능한 도구가 30~50개를 넘으면 Claude의 도구 선택 정확도가 저하된다고 합니다. MCP 도구 정의 토큰: 재현 가능한 측정 2026년 11월 16일, 저는 stdio를 통해 다섯 개의 MCP 서버를 로컬에서 실행하고, 30줄짜리 Node 스크립트로 initialize와 tools/list를 전송한 뒤, 각 도구의 name, description, inputSchema에 포함된 토큰 수를 세었습니다. 먼저 한 가지 전제를 밝힙니다: 오프라인에서 동작하기 때문에 OpenAI의 tiktoken o200k_base 인코딩으로 토큰을 세었습니다. Claude, Gemini 등 다른 모델은 자체 토크나이저를 사용하므로 실제 수치는 어느 정도 차이가 날 것입니다. 여기서 중요한 것은 구성 간의 비율입니다. MCP 서버 (버전) 도구 수 정의 토큰 도구당 평균 @playwright/mcp 0.0.85 25 4,634 185 @modelcontextprotocol/server-filesystem 2.3.0 16 3,281 205 @modelcontextprotocol/server-memory 2.1.1 9 2,013 224 @modelcontextprotocol/server-everything 2.3.0 16 1,995 125 이 네 개를 합친 경우 66 11,923 181 apidog-mcp-server 0.0.18 3 291 97 평범한 네 개의 서버가 에이전트가 파일 하나 읽기도 전에 약 12,000토큰의 비용을 발생시켰습니다. 마지막 행이 유용한 반례입니다. Apidog MCP 서버는 세 개의 좁은 도구(프로젝트의 OpenAPI 스펙 읽기, $ref 파일 읽기, 스펙 갱신)만 노출하므로 291토큰에 그칩니다. 비용을 좌우하는 것은 프로토콜이 아니라 도구 개수와 스키마 깊이입니다. CLI 쪽에서는 에이전트가 Apidog CLI 2.2.12를 사용할 때 실제로 무엇을 읽는지 측정했습니다: CLI 텍스트 컨텍스트에 들어오는 시점 토큰 Apidog CLI 스킬 설명 (frontmatter) 매 세션, 스킬 목록으로 112 Apidog CLI 스킬 본문 작업이 일치할 때만 1,189 apidog --help 에이전트가 실행할 때만 668 apidog test-case --help 에이전트가 실행할 때만 511 apidog run --help 에이전트가 실행할 때만 1,036 CLI 방식의 상시 비용은 112토큰입니다. 에이전트가 전체 스킬을 로드하고 help 페이지 세 개를 읽더라도 약 3,500토큰 정도이며, 필요한 대화에서만 발생합니다. MCP vs CLI: 토큰 비용 비교 MCP 서버 (정의를 미리 로드) 셸을 통해 호출하는 CLI 선비용 모든 도구의 스키마가 매 턴마다 0, 또는 짧은 스킬 설명 탐색 구조화된 tools/list --help 텍스트, 필요할 때 읽음 출력 도구가 반환하는 값 그대로 명령이 출력하는 값 (필터링 가능) 여러 클라이언트에서 사용 어떤 MCP 클라이언트든, 설정 하나 셸 도구가 있는 어떤 에이전트든 타입이 지정된 인자 예, JSON Schema 기반 플래그; 페이로드 파일은 별도 검증 인증 및 권한 서버의 역할 (원격 HTTP 서버는 OAuth) 로컬 로그인과 셸 권한 에이전트는 이미 셸 도구를 갖고 있기 때문에 선비용 측면에서는 CLI가 우위입니다. apidog endpoint list --project 123을 실행하는 것은 어차피 로드할 Bash 도구를 사용하는 것입니다. MCP 방식이 유리한 경우는 각 클라이언트마다 통합을 따로 작성하지 않고도 여러 클라이언트에서 동일한 기능이 필요할 때이며, 이것이 Sylwia Lask가 지적한 바로 그 요점입니다. MCP는 REST를 대체하는 것이 아니라 AI 클라이언트가 도구를 탐색하고 호출하는 표준 방법입니다. 이미 클라이언트가 MCP 도구를 지연 로딩하고 있을 수 있습니다 모든 서버를 제거하기 전에, 에이전트가 실제로 어떻게 동작하는지 확인하세요. 앞서 말한 비용은 정의가 미리 로드된다는 가정에 기반합니다. 일부 클라이언트는 더 이상 기본적으로 그렇게 하지 않습니다. Claude Code의 MCP 문서에 따르면 도구 검색은 기본적으로 활성화되어 있습니다. "세션 시작 시 도구 이름과 서버 지침만 로드되며", 전체 정의는 Claude가 검색할 때 로드됩니다. ENABLE_TOOL_SEARCH로 이를 제어할 수 있습니다: 설정 안 함 또는 true: MCP 도구가 지연되고 필요할 때 로드됨 auto: 정의 총량이 컨텍스트 윈도우의 10% 미만인 동안 도구를 미리 로드 auto:N: 동일하되 직접 지정한 백분율 사용 false: 모든 MCP 도구를 미리 로드 두 가지 예외가 있습니다. Opus 4와 Sonnet 4 이전 모델은 설정과 무관하게 MCP 도구를 미리 로드하며, alwaysLoad: true로 설정된 서버는 지연 로딩을 건너뜁니다. Claude Code에서 /context를 실행하면 어떤 도구가 지연되었는지 확인할 수 있습니다. Claude API 자체에서는 같은 개념이 too...

Powered by Readybot.io