Как устроен поиск в Claude Code и как подключить MCP-сервер?

Коротко

• Встроенный WebSearch в Claude Code возвращает только заголовки и адреса страниц, а поисковик заменить нельзя. Другой поиск подключается только через MCP-сервер, и работает он рядом со встроенным.
• С версии 2.1.212 действует лимит 200 вызовов WebSearch на сессию, включая субагентов. Отключить его нельзя, можно только поднять переменной окружения.
• Через Claude API поиск стоит $10 за 1000 запросов плюс токены. На Amazon Bedrock и, скорее всего, через сторонние шлюзы в ANTHROPIC_BASE_URL WebSearch не работает, и тогда MCP остаётся единственным способом искать.
• WebFetch отдаёт Claude не страницу, а её пересказ маленькой моделью. Перед каждой загрузкой он проверяет домен через api.anthropic.com, поэтому за фильтрующим прокси может не работать.
• MCP-сервер подключается одной командой claude mcp add. Scope (область действия) определяет, где хранится настройка и кому она видна; ключи лучше держать в переменных окружения.

Это первая статья из пяти в серии «Бесплатный поиск в интернете для Claude Code». В серии: встроенные WebSearch и WebFetch и подключение MCP (эта статья); сервисы с API и бесплатным тарифом; поиск без ключей и на своём сервере: SearXNG, DuckDuckGo, мультидвижковые серверы; браузеры, скрейперы, обходные пути и сервисы, которые перестали работать; поиск из России, безопасность, качество, расход токенов и шпаргалка «что выбрать». Все данные проверены 17 сентября 2026 года.

Claude Code — это консольный ИИ-агент Anthropic для разработки: он читает и правит код, запускает команды и может искать информацию в интернете. MCP (Model Context Protocol) — это открытый протокол, через который агент подключает внешние инструменты. MCP-сервер — это программа или удалённый сервис, который по этому протоколу предоставляет агенту набор инструментов: поиск, загрузку страниц, доступ к базе данных. Мы в SystemsLab подключаем такие серверы, когда внедряем ИИ-агентов в компаниях, и ниже собрали то, что важно знать до выбора поисковика.

Можно ли заменить поисковик во встроенном WebSearch?

Нет: поисковый бэкенд WebSearch не настраивается, другой поиск подключается только через MCP-сервер. Документация Claude Code говорит об этом прямо: «The search backend is not configurable. To search with a different provider, add an MCP server that exposes a search tool» (Tools reference).

WebSearch в Claude Code — тонкий клиент к серверному поисковому инструменту Anthropic. Серверный инструмент означает, что сам поиск выполняется на стороне Anthropic, а не на вашей машине. WebSearch возвращает только заголовки и URL результатов, сами страницы он не загружает. Чтобы прочитать найденную страницу, Claude отдельно вызывает WebFetch.

За один вызов инструмент может сделать до восьми поисковых запросов к бэкенду, уточняя их по ходу. Параметры allowed_domains (искать только на этих доменах) и blocked_domains (исключить эти домены) сужают выдачу, но в одном вызове их совмещать нельзя. Название поискового индекса, на котором работает бэкенд, Anthropic официально не раскрывает.

Сколько поисков можно сделать за одну сессию?

С версии 2.1.212 — не больше 200 вызовов WebSearch на сессию, причём в лимит входят вызовы всех субагентов. Субагент — это дочерний агент, которому основной агент поручает часть работы; его поиски расходуют общий счётчик (Tools reference).

Когда лимит исчерпан, вы этого не увидите: очередной вызов выглядит в диалоге как поиск, который ничего не дал, а Claude получает служебное указание работать с уже собранными данными. Счётчик сбрасывает команда /clear, но если после неё продолжает работать процесс, который может запускать субагентов, счёт сохраняется. Переменная окружения CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION поднимает лимит, но отключить его совсем нельзя (Env vars).

На практике это значит, что длинная исследовательская сессия с несколькими субагентами может упереться в потолок незаметно: агент просто перестанет получать результаты встроенного поиска. MCP-сервер с поиском на этот счётчик не влияет.

Параметр WebSearch	Значение на сентябрь 2026 года
Лимит на сессию	200 вызовов, с версии 2.1.212, включая субагентов
Запросов к бэкенду за один вызов	до 8
Как поднять лимит	CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION
Как сбросить счётчик	/clear
Отключить лимит	нельзя

Сколько стоит встроенный поиск?

Через Claude API встроенный поиск стоит $10 за 1000 запросов плюс токены, а для подписок Pro и Max использование входит в тариф. Запрос, завершившийся ошибкой, не оплачивается (Pricing; Costs).

Отдельной доплаты за поиск для подписчиков Pro и Max ни одна страница Anthropic не указывает, но и прямой фразы «поиск бесплатен» в документации тоже нет (не подтверждено первоисточником). Автор статьи на Хабре пересчитывает тариф встроенного поиска как «$0.01 за каждый запрос» («SearXNG + Claude Code: бесплатный веб-поиск вместо $10 за 1000 запросов»). Это совпадает с тарифом API — $10 за 1000 запросов, — но к подписке напрямую не относится.

Как вы работаете с Claude	Стоимость WebSearch
Claude API (оплата по использованию)	$10 за 1000 запросов + токены; запрос с ошибкой не оплачивается
Подписка Pro или Max	входит в тариф; явной оговорки «бесплатно» нет

Где WebSearch работает, а где нет?

Это зависит от провайдера, через которого подключена модель: на Claude API поиск работает, на Amazon Bedrock — нет (Tools reference; Bedrock). Провайдер здесь — площадка, через которую Claude Code обращается к модели: сама Anthropic, облака AWS, Google, Microsoft или сторонний шлюз.

Провайдер модели	WebSearch
Claude API, Claude Platform on AWS	работает
Google Cloud Agent Platform (Vertex)	работает для Claude 4 и новее
Amazon Bedrock	не работает
Microsoft Foundry, развёртывания от Anthropic	работает
Microsoft Foundry, размещённый в Azure	документация расходится, надёжнее считать нерабочим
Сторонний шлюз в ANTHROPIC_BASE_URL (OpenRouter, DeepSeek, GLM, Kimi, локальные модели)	скорее всего, не работает: вывод из устройства инструмента

По Foundry в Azure источники противоречат друг другу. Страница Claude Code говорит, что вызов WebSearch там завершается ошибкой, а страница API — что такие развёртывания поддерживают базовую версию инструмента (Web search tool). Пока противоречие не снято, закладываться на встроенный поиск в этой конфигурации мы бы не стали.

ANTHROPIC_BASE_URL — переменная окружения, которая направляет запросы Claude Code на другой адрес вместо API Anthropic. Так подключают сторонние шлюзы и модели других разработчиков. Для таких конфигураций поиск через MCP становится единственным способом искать. Прямого подтверждения в документации нет: это вывод из того, что WebSearch — серверный инструмент Anthropic, и чужой шлюз его не выполнит.

В старых версиях документации встречалось упоминание, что поиск доступен только в США («US-only»). На текущих публичных страницах найти его не удалось (не подтверждено первоисточником).

Что на самом деле возвращает WebFetch?

WebFetch возвращает Claude не саму страницу, а ответ «маленькой быстрой модели», которая прочитала страницу вместе с вашим промптом. Документация называет инструмент «lossy by design», то есть с потерями по замыслу, и за сырым содержимым советует идти через curl (Tools reference).

В отличие от WebSearch, WebFetch работает на вашей машине. Он скачивает страницу, превращает HTML в Markdown и передаёт результат маленькой модели. Claude получает ответ этой модели, а не текст страницы. Для большинства задач этого достаточно, но если нужна точная цитата, таблица целиком или фрагмент кода из документации, пересказ может что-то упустить.

Параметр WebFetch	По умолчанию	Как поменять
Кэш	15 минут	CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS
Таймаут загрузки	5 минут	CLAUDE_CODE_WEBFETCH_DEADLINE_MS
Редирект на другой хост	не выполняется, о нём сообщается Claude	не настраивается
User-Agent	начинается с Claude-User	не настраивается

User-Agent — это строка, которой программа представляется сайту. По префиксу Claude-User сайт может распознать запрос от агента и, например, ограничить его.

Почему WebFetch не работает за корпоративным прокси?

Потому что перед загрузкой WebFetch отправляет имя хоста на api.anthropic.com для проверки по блок-листу безопасности, и если этот адрес закрыт, загрузка не выполняется. Уходит только имя хоста, без полного URL и содержимого страницы; хост, прошедший проверку, Claude Code кэширует на пять минут. Проверка идёт при любом провайдере модели, в том числе через сторонний шлюз (Data usage; LLM gateway).

Отключать проверку стоит осознанно. Она сверяет домен с блок-листом безопасности, который ведёт Anthropic; без неё WebFetch загружает любой адрес, поэтому документация советует в этом случае ограничить домены правилами WebFetch. В компаниях, где исходящий трафик идёт через прокси, мы обычно согласуем с службой информационной безопасности отдельное правило для этого хоста, а не выключаем проверку на всех машинах.

Как разрешить или запретить поиск и загрузку страниц?

WebSearch разрешается или запрещается только целиком, правилом WebSearch, а для WebFetch правила пишутся по доменам. Пример правила: WebFetch(domain:*.example.com); маски доменов работают с версии 2.1.172. Сохранённые одобрения Claude Code записывает в .claude/settings.local.json (Permissions).

Разрешения в Claude Code — это правила allow (разрешить без вопроса) и deny (запретить), по которым агент решает, можно ли вызвать инструмент. У них есть две детали, которые важны для поиска.

1. Запрет WebFetch не мешает агенту зайти на тот же URL через curl в Bash, если Bash разрешён. Запрет одного инструмента не закрывает доступ в сеть целиком.
2. Правила для MCP-инструментов используют имена вида mcp__<server>__<tool>, где server — имя MCP-сервера, а tool — имя его инструмента (Permissions).

Когда подключён сторонний поиск, удобно убрать встроенный правилом "deny": ["WebSearch"]. Тогда Claude будет искать через MCP-инструмент и не станет выбирать между двумя поисковиками. Пример settings.json, где разрешены загрузка с поддоменов GitHub и все инструменты сервера searxng, а встроенный поиск запрещён:

{ "permissions": {
    "allow": ["WebFetch(domain:*.github.com)", "mcp__searxng"],
    "deny":  ["WebSearch"] } }

Как подключить MCP-сервер к Claude Code?

Одной командой claude mcp add: ей передают транспорт, область действия, переменные окружения и адрес сервера или команду его запуска. Общий синтаксис такой (MCP):

claude mcp add [--transport stdio|http|sse] [--scope local|project|user] [--env K=V] [--header "..."] <имя> <url | -- команда аргументы>

Транспорт — это способ, которым Claude Code общается с сервером. stdio — локальный сервер: Claude Code сам запускает его как процесс и обменивается данными через стандартные ввод и вывод. http — удалённый сервер по адресу в интернете; это рекомендуемый транспорт. SSE объявлен устаревшим, для новых подключений его лучше не выбирать.

Двойной дефис -- отделяет опции Claude Code от команды запуска сервера: всё, что после него, передаётся серверу без изменений.

Типовые команды для удалённого и локального сервера, проверки и управления:

# удалённый сервер
claude mcp add --transport http <имя> https://example.com/mcp --header "Authorization: Bearer <ключ>"
# локальный stdio-сервер с ключом
claude mcp add --scope user --transport stdio --env API_KEY=xxx <имя> -- npx -y <пакет>
# проверка и управление
claude mcp list        # статус ✔/✘
claude mcp get <имя>
claude mcp remove <имя>
# внутри сессии: /mcp — статус и OAuth-вход

Команда /mcp внутри сессии показывает, какие серверы подключились, и позволяет войти через OAuth — стандартный протокол авторизации, при котором вы подтверждаете доступ в браузере, а не вписываете ключ в команду.

Какой scope выбрать для MCP-сервера?

Scope local подходит для личных экспериментов в одном проекте, project — для общей настройки команды, user — для сервера, который нужен вам во всех проектах. Scope — это область действия настройки: он определяет, в каком файле хранится сервер и кто его видит (MCP; MCP quickstart).

Scope	Где хранится	Где действует
local (по умолчанию)	~/.claude.json (в Windows C:\Users\<Имя>\.claude.json)	только в текущем проекте, приватно
project	.mcp.json в корне проекта	у всех, кто работает с репозиторием; при загрузке Claude Code спрашивает подтверждение
user	~/.claude.json, ключ mcpServers	во всех ваших проектах

Если серверы с одним именем заданы в нескольких местах, побеждает local, затем project, user, плагины и коннекторы claude.ai. Чтобы сменить scope, сервер нужно удалить и добавить заново: переноса между областями нет.

В .mcp.json работают подстановки ${VAR} и ${VAR:-default}, где default — значение на случай, если переменная не задана. Поэтому ключ можно держать в переменной окружения, а не в файле, который попадает в git. Для командной настройки с платным поисковым API это обязательная практика: .mcp.json лежит в репозитории и виден всем, у кого есть к нему доступ.

Какие ещё настройки влияют на поиск через MCP?

Три: лимит размера ответа MCP-инструмента, режим tool search и особенности запуска на Windows. Каждая из них может незаметно сломать поиск.

• Вывод MCP-инструмента ограничен 25 000 токенов, а при выводе больше 10 000 токенов появляется предупреждение. Лимит поднимает переменная MAX_MCP_OUTPUT_TOKENS; всё, что сверх лимита, сохраняется в файл (MCP). Для поисковых серверов, которые возвращают полный текст страниц, это ограничение достигается быстро.
• Tool search — режим, в котором Claude Code откладывает загрузку описаний MCP-инструментов и подгружает их по мере надобности, экономя контекст. Он включён по умолчанию, но автоматически выключается, если ANTHROPIC_BASE_URL указывает на сторонний хост. Вернуть его можно переменной ENABLE_TOOL_SEARCH (MCP). Без tool search описания всех подключённых серверов сразу занимают место в контексте.
• Windows. На текущей странице документации нет требования оборачивать npx в cmd /c, а в версии 2.1.119 убрали ложное предупреждение об этом (CHANGELOG). Тем не менее если stdio-сервер падает с ошибкой «Connection closed», вариант -- cmd /c npx -y <пакет> по-прежнему часто помогает (не подтверждено актуальной документацией).

Где искать MCP-серверы?

В каталоге Anthropic Directory (claude.ai/directory) и в официальном реестре registry.modelcontextprotocol.io. Claude Code сам отсылает к Anthropic Directory: там собраны проверенные коннекторы, и любой удалённый сервер оттуда добавляется через claude mcp add (MCP).

Вендорно-нейтральный официальный реестр registry.modelcontextprotocol.io, то есть не привязанный к одному поставщику моделей, запущен в режиме preview 8 сентября 2025 года (блог MCP, «Introducing the MCP Registry»). Вышел ли он из preview к сентябрю 2026 года, установить не удалось.

Прежде чем подключать сервер из любого каталога, стоит посмотреть, кто его автор и какие разрешения он просит. Поисковый сервер приносит в контекст агента текст с чужих сайтов, и этот текст может содержать инструкции для модели. Подробно о таких атаках — prompt injection и tool poisoning — пойдёт речь в заключительной статье серии.

Зачем нужен эталонный сервер Fetch?

Fetch полезен как замена WebFetch, когда агенту нужен сырой текст страницы без пересказа. Это один из семи эталонных серверов в репозитории modelcontextprotocol/servers; разработчики подчёркивают, что эталонные серверы — учебные реализации, а не решения для продакшена (servers). Серверы Brave Search и Puppeteer из того же репозитория перенесены в архив.

Fetch работает без ключа. Он ничего не ищет, а только отдаёт страницу в Markdown кусками: параметр max_length задаёт размер куска (по умолчанию 5000 символов), start_index — с какого символа начать. По умолчанию сервер соблюдает robots.txt — файл, в котором сайт указывает, что роботам можно загружать, — если запрос инициировала модель (fetch README).

README предупреждает, что сервер может обращаться к локальным и внутренним IP-адресам. Если агент работает в корпоративной сети, Fetch теоретически может прочитать внутренние сервисы, поэтому такой сервер стоит запускать в изолированной среде — например, в отдельном контейнере на сервере компании с ограниченным сетевым доступом.

Fetch (эталонный)	Значение
Доступ	без ключа
Что делает	загружает страницу и отдаёт Markdown кусками, не ищет
Параметры	max_length, start_index
robots.txt	соблюдает по умолчанию
Риск	может обращаться к локальным и внутренним IP (по README проекта)

Подключение одной командой (нужен установленный uv, из которого берётся uvx):

claude mcp add fetch -- uvx mcp-server-fetch

Fetch закрывает задачу чтения страниц, но не поиска. Какие поисковые сервисы дают API с бесплатным тарифом, что у них пополняется каждый месяц, а что выдаётся разово, разберём в следующей статье серии. Если вы хотите подключить поиск к агентам в своей компании с учётом прав и сетевых ограничений, мы делаем это в рамках разработки и внедрения ИИ-агентов.

Источники

1. Tools reference: WebSearch tool behavior — code.claude.com, проверено 17.09.2026.
2. Tools reference: Session search limit — code.claude.com, проверено 17.09.2026.
3. Environment variables — code.claude.com, проверено 17.09.2026.
4. Pricing — platform.claude.com, проверено 17.09.2026.
5. Costs — code.claude.com, проверено 17.09.2026.
6. SearXNG + Claude Code: бесплатный веб-поиск вместо $10 за 1000 запросов — habr.com, проверено 17.09.2026.
7. Claude Code on Amazon Bedrock — code.claude.com, проверено 17.09.2026.
8. Web search tool — platform.claude.com, проверено 17.09.2026.
9. Tools reference: WebFetch tool behavior — code.claude.com, проверено 17.09.2026.
10. Data usage: WebFetch domain safety check — code.claude.com, проверено 17.09.2026.
11. LLM gateway protocol — code.claude.com, проверено 17.09.2026.
12. Permissions: WebFetch — code.claude.com, проверено 17.09.2026.
13. Permissions — code.claude.com, проверено 17.09.2026.
14. Connect Claude Code to tools via MCP — code.claude.com, проверено 17.09.2026.
15. MCP quickstart — code.claude.com, проверено 17.09.2026.
16. MCP: Configure tool search — code.claude.com, проверено 17.09.2026.
17. Claude Code CHANGELOG — github.com, проверено 17.09.2026.
18. Introducing the MCP Registry — blog.modelcontextprotocol.io, проверено 17.09.2026.
19. modelcontextprotocol/servers — github.com, проверено 17.09.2026.
20. Fetch MCP Server, README — github.com, проверено 17.09.2026.