Сколько токенов расходуют MCP-серверы и как это сократить?
По умолчанию Claude Code кладёт в контекст только названия MCP-инструментов и инструкции серверов, а полное определение инструмента загружает при использовании, поэтому несколько лишних серверов стоят мало. В Codex каждый MCP-сервер добавляет контекст к каждому сообщению. Решение в обоих случаях одно: отключите то, чем не пользуетесь.
Codex
Каждый MCP-сервер добавляет контекст к каждому сообщению и тратит больше лимита. OpenAI советует подключать их меньше и отключать, когда они не нужны.
Введите /mcp в CLI, чтобы увидеть серверы этой сессии, или выполните codex mcp list, чтобы увидеть всё, что у вас настроено. Чтобы перестать платить за сервер, удалять его не обязательно: в его записи [mcp_servers.<name>] в ~/.codex/config.toml напишите enabled = false, а когда понадобится — верните обратно. Если с сервера вам нужны только один-два инструмента, перечислите их в enabled_tools; остальные модели не передаются. Загружает ли Codex определения инструментов по требованию, OpenAI не документирует.
Что сказано в официальной документации
Limit the number of MCP servers you use. Every MCP server adds more context to your messages and uses more of your limit. Disable MCP servers when you don't need them.enabled (optional): Set false to disable a server without deleting it.enabled_tools (optional): Tool allow list.Claude
По умолчанию очень мало: в контекст идут только названия инструментов и инструкции серверов. Проверьте через /context и отключите ненужные серверы в /mcp.
В Claude Code по умолчанию включён tool search: полные определения инструментов не попадают в контекст, пока Claude не воспользуется инструментом, — поэтому Anthropic и говорит, что лишние серверы влияют минимально. Вторая статья расхода — то, что инструменты возвращают. Claude Code предупреждает, когда один вывод MCP превышает 10 000 токенов, и по умолчанию ограничивает его 25 000; всё, что больше, сохраняется в файл, а в разговоре остаётся только путь. Сервер, отключённый в /mcp, отключён только для текущего проекта, а его настройки сохраняются.
Что сказано в официальной документации
MCP tool definitions are deferred by default, so only tool names and server instructions enter context until Claude uses a specific tool. Run /context to see what's consuming space.Only tool names and server instructions load at session start, so adding more MCP servers has minimal impact on your context window.Output warning threshold: Claude Code displays a warning when any MCP tool output exceeds 10,000 tokensDefault limit: the default maximum is 25,000 tokensPrefer CLI tools when available: Tools like gh, aws, gcloud, and sentry-cli are still more context-efficient than MCP servers because they don't add any per-tool listing.On a Pro, Max, Team, or Enterprise plan, /usage also shows a breakdown of what counts against your plan limits: Attribution: recent usage attributed to skills, subagents, plugins, and individual MCP servers, each shown as a percentage of the total.If you've logged into Claude Code with a claude.ai account, MCP servers you've added in claude.ai, known as connectors, are automatically available in Claude CodeYou can also run /mcp to toggle any connector Claude Code fetches on or off for the current project only.Через сторонний прокси загружаются все определения инструментов
У поведения по умолчанию есть одно исключение. Когда ANTHROPIC_BASE_URL указывает на хост, не принадлежащий Anthropic, — например, на ретранслятор или шлюз, — Claude Code отключает tool search, потому что большинство прокси не пересылают блоки, от которых он зависит.
С этого момента определения всех MCP-инструментов сразу идут в контекст, и число установленных серверов начинает иметь значение. Если вы работаете через прокси, сначала введите /context, чтобы увидеть, сколько занимает MCP, а затем отключите серверы, которые этому проекту не нужны.
Что сказано в официальной документации
Tool search is enabled by default: MCP tools are deferred and discovered on demand. Claude Code disables it when ANTHROPIC_BASE_URL points to a non-first-party host, since most proxies don't forward tool_reference blocks.Частые заблуждения
- MCP-сервер, который вы не вызываете, ничего не стоит
Неверно. В Codex каждый включённый сервер добавляет контекст к каждому сообщению, пользуетесь вы им или нет. Claude Code по умолчанию несёт только названия инструментов — это мало, но не ноль; через сторонний прокси или с настройкой alwaysLoad он несёт определения всех инструментов. Отключите то, чем не пользуетесь.
- В Claude Code больше MCP-серверов — всегда больше токенов
По умолчанию — нет. Claude Code откладывает загрузку определений инструментов, и Anthropic говорит, что добавление MCP-серверов влияет на контекст минимально. Дорого обходятся две вещи: отключённый tool search, что часто бывает за прокси, и инструмент, который за один вызов возвращает много содержимого.
- Токены тратит именно список инструментов
Не только. Список инструментов — постоянная плата; то, что инструменты возвращают, обычно больше. Каждый результат остаётся в разговоре и отправляется снова с каждым следующим сообщением. Один вывод MCP по умолчанию может достигать 25 000 токенов, а это перевешивает множество определений инструментов.
Советы
- Claude Code: введите /context, чтобы увидеть, сколько контекста занимают MCP-инструменты.
- Claude Code: введите /mcp и отключите серверы, которые этому проекту не нужны. Понадобятся — включите снова.
- Claude Code: введите /usage, чтобы увидеть, какая доля недавнего расхода приходится на каждый MCP-сервер. Начните с тех, у кого доля высокая, а нужны они редко.
- Если есть инструмент командной строки (gh, aws, gcloud, sentry-cli), пусть агент выполняет команду, вместо того чтобы подключать соответствующий MCP-сервер.
- Claude Code: не задавайте серверу alwaysLoad: true, если его инструменты не нужны на каждом ходу. С этой настройкой все инструменты сервера загружаются в начале сессии.
- Claude Code: если вы входите под аккаунтом claude.ai, коннекторы, добавленные на claude.ai, появляются в Claude Code автоматически. Отключите в /mcp те, что этому проекту не нужны, или задайте в настройках "disableClaudeAiConnectors": true, чтобы отключить все.
- Codex: в ~/.codex/config.toml напишите enabled = false для серверов, которыми не пользуетесь, и enabled_tools для серверов, с которых нужны лишь несколько инструментов.
- Просите меньше: ограничивайте диапазон и число строк в запросе и не вытягивайте целую таблицу или целую страницу.