초대하고 적립

초대 보상 안내

초대 링크를 공유하세요. 친구가 링크로 가입하고 충전하면 이후 충전마다 표시된 보상을 받을 수 있습니다.

Claude Code의 MCP 컨텍스트: 도구를 유지할까, 명령을 실행할까

고정된 토큰 절감을 가정하지 않고 MCP 서버가 Claude Code 컨텍스트에 미치는 영향을 되돌릴 수 있게 점검하는 절차입니다.

목차

Claude Code의 MCP 컨텍스트: 도구를 유지할까, 명령을 실행할까

MCP 서버는 Claude Code가 작업 디렉터리 밖의 시스템, 예를 들어 티켓, 내부 API, 데이터베이스, 관측 데이터를 읽어야 할 때 유용합니다. 동시에 도구 이름, 설명, 입력 스키마, 가능한 작업도 세션에 추가합니다. 따라서 질문은 “MCP가 비싼가?”가 아닙니다. 이 작업에 외부 시스템에 대한 반복 접근이 필요한지, 아니면 짧은 로컬 작업이면 되는지를 판단해야 합니다.

한 번의 긴 응답만 보고 모든 서버를 끄지 마세요. 외부 효과가 없는 짧고 반복 가능한 작업을 하나 고르고, 현재 상태를 측정한 뒤 서버 하나만 제한하거나 제거합니다. turn 수, 실제로 필요했던 호출, 검증 가능한 결과가 컨텍스트가 커 보인다는 느낌보다 더 좋은 근거입니다.

별도의 Claude Code API workflow를 시험한다면 최신 BetterToken 설정 가이드를 열고 같은 prompt와 model로 두 번 실행한 뒤 Dashboard에서 시각, model, status, input/output/cache Token, 표시된 사용량을 바로 비교하세요. 막연한 컨텍스트 우려를 검증 가능한 A/B test로 바꿀 수 있습니다. read-only test 하나부터 시작하고 API Key는 repository에 저장하지 마세요.

추가 컨텍스트가 생기는 위치

Claude Code MCP 문서는 MCP를 외부 도구와 데이터에 연결하는 방식으로 설명합니다. 모델 입장에서는 호출 결과만 문제가 아닙니다. 첫 호출 전에도 각 도구의 목적, 파라미터, 제한을 고려해야 합니다. 필터 없이 많은 도구를 노출하는 넓은 서버일수록 고려할 선택지가 많아집니다.

그렇다고 MCP에 고정된 “토큰 비용”이 있는 것은 아닙니다. 서버, 활성화한 도구, prompt, 모델, 세션 history, 도구가 돌려준 결과에 따라 달라집니다. 다음 관찰을 구분하세요.

  • 작업에 필요하지 않은 많은 도구 schema가 처음부터 공개된다.
  • 한 번의 호출이 다음 turn에서 해석해야 할 긴 result를 돌려준다.
  • 너무 넓은 result 때문에 search나 file read를 반복한다.
  • 도구를 제거한 뒤 외부 validation이 사라져 agent가 추측한다.

이 중 하나만으로 모든 token의 원인을 증명할 수는 없습니다. repository 크기와 이전 history도 비교를 바꿉니다.

가장 작은 유용한 인터페이스 선택

상황먼저 선택할 것이유
티켓을 여러 번 읽고 갱신범위가 좁은 tracker MCP외부 객체 모델을 반복해서 다뤄야 한다.
로컬 프로세스 상태를 한 번 확인로컬 command 또는 status file필요한 fact가 workspace 안에 있다.
많은 작업에서 내부 API 읽기작은 scope의 read-only MCP반복 가능하고 검토 가능한 접근이 된다.
repository 문서 하나 열기search와 file read외부 도구 목록이 필요 없다.
외부 시스템 변경manual 또는 read-only check부터authorization, idempotency, 결과 검증이 필요하다.

서버의 인기보다 작업 빈도와 데이터 경계가 중요합니다. Git 상태를 한 번 보는 일이라면 command가 더 작을 수 있습니다. 반면 스키마가 있는 외부 데이터에 대해 여러 관련 작업을 해야 할 때 command는 안전한 인터페이스를 대체하지 못합니다.

같은 작업으로 작은 비교 실행

변경된 파일의 담당자 찾기, 로컬 status 확인, 테스트 프로젝트의 열린 항목 읽기처럼 외부 부작용이 없는 작업을 고릅니다. 서로 다른 작업을 비교하거나 유난히 긴 세션 하나로 일반 결론을 내리지 마세요.

  1. 짧은 prompt, 작업 디렉터리, 기대 결과를 적습니다. 예: “변경된 파일을 보여 주고 repository를 바꾸지 않는 다음 단계 하나를 제안해 줘.”
  2. 현재 MCP profile로 실행합니다. turn 수, 사용한 tool, 결과, 시각만 안전하게 기록합니다. API key, .env, 민감한 전체 출력은 메모에 넣지 않습니다.
  3. /mcp에서 server 하나만 비활성화합니다. 설정은 보존되고 server는 disabled로 표시됩니다. 세션을 닫고 fresh session을 연 뒤 /mcp에서 해당 server가 목록에는 남아 있지만 연결되지 않았는지 확인하고 동일한 prompt를 반복합니다.
  4. 먼저 얻은 fact를 비교합니다. agent가 같은 필수 정보를 얻었는지, 유용한 tool call을 추측으로 바꾸지는 않았는지 확인합니다.
  5. /mcp에서 server를 다시 켜고 새로운 session에서 상태를 확인합니다. 없앴더니 사람이 데이터를 복사해야 하거나 중요한 validation이 사라진다면 되돌립니다. 결과가 유지되고 불필요한 호출이 줄면 작은 구성을 남깁니다.

fresh session이 필요한 이유는 이전 history에 이미 tool result가 있기 때문입니다. 이 테스트는 Claude Code 전체의 성능을 측정하는 것이 아니라, 평소 workflow의 결정을 돕습니다.

실제로 비교 가능한 command

MCP를 임의의 command로 바꾸지 마세요. 같은 로컬 fact라면 다음 read-only command가 비교 대상이 될 수 있습니다.

git status --short

두 조건 모두에서 변경된 파일 목록과 쓰기 없는 다음 단계만 요청합니다. prompt와 기대 목록은 같아야 합니다. 먼저 목록을, 그 다음 turn, call, token을 비교합니다. MCP가 git status에 없는 외부 fact를 제공했다면 동등한 대체가 아닙니다. 좁은 read-only MCP를 유지하거나 같은 system을 향하는 문서화된 command를 사용하세요.

제거하기 전에 도구 표면 줄이기

하나의 server가 많은 command를 제공해도 project가 정기적으로 쓰는 것은 한두 개일 수 있습니다. 먼저 표면을 줄입니다.

  • 첫 비교에서는 read-only tool만 활성화합니다.
  • 이 repository에서 쓰지 않는 integration을 끕니다.
  • development, support, administration profile을 분리합니다.
  • tool description에 secret, 긴 log, 대화 history를 넣지 않습니다.
  • 드문 작업은 기대 결과가 분명한 짧은 문서화 command로 남깁니다.

MCP는 외부 데이터를 읽거나 작업을 시작할 수 있습니다. 설정 자체가 scope 확인이나 호출 결과 검증을 대신하지 않습니다. model의 텍스트 응답은 외부 작업이 올바르게 끝났다는 증거가 아닙니다.

usage와 비용을 올바르게 비교

API 비교에서는 자신의 BetterToken API Key로 Claude Code를 설정할 수 있습니다. 현재 설정은 Claude Code 가이드에서 확인하세요. BetterToken은 Claude subscription이 아닌 별도 API access입니다. Key는 사용자의 account에서 만들고 관리하며 repository, handoff, 실험 기록에 넣지 않습니다.

BetterToken Dashboard에서는 시각, model, status, input, output, cache token과 해당 사용량을 볼 수 있습니다. 각 run에 model, 날짜와 시각, input, output, cache, 표시 비용, turn 수를 한 줄로 기록합니다. 두 run은 같은 model과 같은 prompt를 써야 합니다.

Dashboard에 비용이 보이면 관찰 차이 = MCP 사용 비용 − MCP 미사용 비용으로 계산합니다. token만 보이면 먼저 현재 가격 페이지를 열어 날짜, model, cache 규칙을 기록합니다. cache 가격이 별도로 표시될 때만 비용 = input/1,000,000 × Pinput + output/1,000,000 × Poutput + cache/1,000,000 × Pcache를 사용합니다. 빈 값이나 모호한 값은 zero가 아니며, 오래된 가격을 재사용하지 않습니다. 이 차이는 두 run의 관찰일 뿐 고정 MCP 요금이 아닙니다.

올바른 순서로 결정 검증

  1. 필수 외부 fact. 대체 수단이 ticket, status, API record, document를 실제로 가져오고 추측하지 않는지 확인합니다.
  2. 정확성과 접근 경계. 기대 결과와 비교하고 새 secret이나 더 넓은 scope 없이 테스트를 read-only로 유지합니다.
  3. validation 보존. 대체 수단이 tool이 하던 검증을 없애지 않았는지 확인합니다. model response는 외부 결과의 증거가 아닙니다.
  4. 그 다음 비용. 같은 prompt의 fresh session에서 turn, call, input/output/cache token, Dashboard 비용을 비교합니다.

처음 세 항목 중 하나라도 실패하면 token을 덜 써도 workflow가 나아진 것이 아닙니다. 작업이 더 이상 같지 않거나 사람이 잃어버린 검증을 맡은 것입니다.

선택을 다시 봐야 할 때

server를 제거해 필수 외부 fact를 얻지 못하거나, 검증되지 않은 제안이 생기거나, 사람이 매번 같은 data를 prompt로 복사해야 한다면 다시 켭니다. 필요한 결과가 검증된 채로 불필요한 call이 줄면 작은 profile을 유지합니다. 좋은 MCP profile은 대체로 조용합니다. 활성 tool마다 반복하는 일이 있고, 나머지에는 짧은 command, document, manual check가 있습니다.

출처

LLM 워크플로를 최적화할 준비가 되셨나요?

하나의 API로 모델을 연결하고 키와 AI 비용을 관리하세요.

무료로 시작하기