MCP Tool Call 최소화 전략

한 줄 정의

CLAUDE.md에 코드표 + 쿼리 패턴을 두면 탐색 과정(삽질)을 LLM이 건너뛰고 1회 호출로 처리.

핵심 내용

MCP 아키텍처: Host(Claude Code) → Client → Server → 외부 API

• LLM은 직접 API 호출 안 함. “이 tool을 이 파라미터로 호출해줘”만 요청.
• Tool Description = 성능의 핵심. 모호하면 LLM이 추측 → 틀림.

최적화 전략:

• 공식 MCP (범용): “유형=운영 이슈 조회” → 3회 tool call
• CLAUDE.md에 코드표 + 쿼리 패턴 → 1회 tool call

도구 수 제한 중요: 100개 기준 tool 선택 정확도 10%+ 하락.

권장 조합: 쿼리 패턴 + enum 코드표

• 코드표만 → Notion filter 문법 틀릴 수 있음
• 실행 코드 → 쿼리 종류마다 다 정의해서 프롬프트 비대
• 쿼리 패턴 + enum → 구조 고정 + 값 정확 + 프롬프트 적당

적용 맥락

MCP 서버 설정/최적화 시. 같은 작업에 tool call이 3회 이상 필요하면 커스텀 MCP 고려.