Как подключить Parallel Search MCP к агенту: поиск без ключа, чтение страниц и границы расходов

Parallel Search MCP можно добавить к уже настроенному агенту, не поднимая SearXNG и не получая отдельный поисковый API Key. У сервиса есть удалённый Streamable HTTP endpoint https://search.parallel.ai/mcp, который показывает агенту два инструмента: web_search и web_fetch.

Главная проверка — не наличие строки в конфиге, а фактический вызов инструмента. Нужно увидеть состояние подключения, оба имени в списке tools, запись о вызове в текущем диалоге и URL, которые действительно открываются. Ниже — порядок действий по официальной документации, открытой 11 октября 2026 года. Это не отчёт о тесте в вашей среде: окончательный результат подтверждают только логи клиента и данные ваших аккаунтов.

Сначала выберите endpoint и способ авторизации

Задача	Endpoint	Авторизация	Когда использовать
Быстро проверить поиск и чтение страниц	https://search.parallel.ai/mcp	Не нужна	Лёгкие задачи, анонимный режим с более низкими лимитами
Привязать трафик к аккаунту и поднять лимиты	https://search.parallel.ai/mcp	Bearer API Key	Регулярная или производственная нагрузка
Войти через браузер из клиента	https://search.parallel.ai/mcp-oauth	OAuth или Bearer API Key	Когда ключ не должен лежать в общем конфиге

У этих адресов разное поведение. Обычный /mcp не объявляет OAuth, поэтому клиент может подключиться анонимно и не открыть окно входа. /mcp-oauth, наоборот, требует авторизации: анонимный запрос получает 401. Отсутствие браузерного окна на /mcp само по себе не означает ошибку.

Разделите клиент, веб-поиск и модель

В одном ответе участвуют три независимых слоя:

1. Клиент агента хранит диалог, разрешения и выбирает инструменты.
2. Parallel Search MCP выполняет web_search и web_fetch.
3. Провайдер модели обрабатывает контекст и считает входные, выходные и связанные с tool results токены.

Подключение MCP не меняет модельный Base URL. И наоборот: сторонний model provider не добавляет веб-поиск автоматически. При сбое проверяйте отдельно, подключился ли MCP, был ли вызван нужный tool и кто списал деньги за модельный запрос.

Claude Code: минимальное анонимное подключение

Запустите команды в проекте, где работаете с Claude Code:

claude mcp add --transport http "Parallel-Search-MCP" https://search.parallel.ai/mcp
claude mcp get "Parallel-Search-MCP"
claude mcp list

По умолчанию сервер сохраняется в local scope. Если он нужен во всех проектах, добавьте --scope user. Для общего project scope проверяйте .mcp.json перед коммитом и не сохраняйте там постоянный Bearer token.

Внутри Claude Code откройте менеджер MCP:

/mcp

Сообщение Added означает, что конфиг записан. Для проверки соединения нужен статус Connected в claude mcp list или /mcp. Если нужен OAuth, используйте тот же порядок, но адрес:

https://search.parallel.ai/mcp-oauth

После этого завершите авторизацию из /mcp. Не смешивайте ошибки обычного и OAuth endpoint в одной диагностике.

Codex CLI: анонимный режим, ключ из окружения или OAuth

Анонимное подключение:

codex mcp add parallel-search --url https://search.parallel.ai/mcp
codex mcp list

Для аккаунтных лимитов сначала безопасно сохраните PARALLEL_API_KEY средствами ОС или менеджера секретов. Затем передайте Codex только имя переменной — реальный ключ не должен попасть в историю shell или общий файл:

codex mcp add parallel-search --url https://search.parallel.ai/mcp \
  --bearer-token-env-var PARALLEL_API_KEY
codex mcp list

Вариант с OAuth:

codex mcp add parallel-search --url https://search.parallel.ai/mcp-oauth
codex mcp list

После добавления начните новую сессию Codex. Не переносите JSON между клиентами вслепую: VS Code использует верхний объект servers, Cursor обычно — mcpServers, а некоторые клиенты требуют type: "streamable-http".

Как доказать, что агент вызвал именно Parallel

Состояние Connected говорит только о доступности сервера. Для проверки конкретного ответа дайте prompt, который оставляет наблюдаемые следы:

В этой проверке обязательно используй Parallel-Search-MCP и не отвечай по памяти.
1. Вызови web_search и найди официальную документацию Parallel Search MCP и текущую страницу тарифов.
2. Покажи URL источников из результата web_search.
3. Выбери два официальных URL и вызови web_fetch, чтобы прочитать исходный текст.
4. Для каждого источника укажи имя инструмента, URL и короткий фрагмент подтверждения.
Если tool call завершился ошибкой, остановись и сообщи имя инструмента, endpoint и HTTP status.

После ответа проверьте четыре вещи:

• в журнале tool calls есть web_search;
• затем есть отдельный вызов web_fetch, а не только пересказ сниппетов;
• результат инструмента содержит настоящие URL;
• утверждение в ответе находится на странице, которую вернул web_fetch.

Фраза модели «я поискал в интернете» ничего не доказывает. Если клиент позволяет временно отключить встроенный web search, сделайте это только на время проверки — так проще не перепутать два похожих инструмента.

Рабочая схема: поиск, выбор URL, чтение оригинала

Разделение инструментов простое:

• web_search ищет актуальные данные и несколько источников. Ему нужны objective и search_queries.
• web_fetch читает известные страницы или проверяет выбранные результаты. За один запрос он принимает до 20 URL.

Если клиент даёт управлять аргументами, придерживайтесь такого порядка:

1. В objective оставляйте одну цель: например, «проверить официальные правила анонимного доступа и оплаты».
2. Для search_queries используйте два-три коротких разных запроса, а не весь prompt целиком.
3. Внутри одного диалога сохраняйте один session_id; для нового диалога создавайте новый.
4. Начинайте с full_content: false. Полный текст страницы может занять десятки тысяч модельных токенов и не поместиться в вывод клиента.
5. Сначала выбирайте документацию, спецификации и первичные объявления. Сообщения сообщества называйте пользовательскими отчётами, а не доказательством общего поведения сервиса.

Такой процесс «поиск → выбор URL → чтение оригинала → сверка цитаты» легче проверять, чем общий запрос «поищи в сети».

Границы расходов: четыре разные статьи

Цены ниже сверены с официальной страницей Parallel 11 октября 2026 года. Таблица объясняет структуру расходов, а не обещает, что один вариант всегда дешевле.

Статья	Подписка или членство	Минимальное пополнение	Бонус первого месяца	Оплата по использованию
Анонимный Search MCP	Для документированного анонимного входа аккаунтная подписка не нужна	Для старта без авторизации пополнение не требуется	Фиксированное число вызовов не опубликовано	Описан как бесплатный для знакомства и лёгких задач, но с более низкими лимитами
Search/Extract с аккаунтом Parallel	На публичной странице цен отдельная абонентская плата не указана	На публичной странице цен не указано	Фиксированный стартовый кредит не указан	Базовая цена Search (10 результатов включены в каждый запрос): fast/turbo — US$1 за 1 000 запросов; basic/advanced — US$5; дополнительные результаты страниц и выдержки — US$1 за 1 000 результатов; Extract — US$1 за 1 000 URL
Клиент агента	Зависит от Claude Code, Codex или другого продукта	Условия клиента	Условия клиента	Права по плану клиента не являются кредитами Parallel
Модельный API	Условия model provider	Условия provider	Условия provider	Входные, выходные, cache-токены и контекст tool results оплачиваются отдельно от Search MCP

Для анонимного MCP официальный текст не даёт фиксированного числа запросов. Поэтому нельзя превращать фразу «lower rate limits» в собственное обещание вроде «N бесплатных поисков в день». Общая таблица API rate limits также не является гарантией для анонимного MCP.

Если авторизованный вызов возвращает 402, документация Parallel связывает его с недостатком credits. Сначала проверьте баланс и режим подключения, а не запускайте бесконечный retry.

BetterToken как model provider не заменяет Search MCP

Если Claude Code или Codex уже отправляет модельные запросы через BetterToken, текущий клиент можно оставить и добавить Parallel отдельным инструментальным слоем:

• для Claude Code модельный Base URL — https://bettertoken.ai; клиент сам добавляет /v1/messages, поэтому /v1 вручную не нужен;
• для Codex модельный Base URL — https://www.bettertoken.ai/v1, а wire_api = "responses";
• URL инструмента остаётся https://search.parallel.ai/mcp или https://search.parallel.ai/mcp-oauth.

Эти адреса нельзя подменять друг другом. BetterToken отвечает за модельный API и его token usage, Parallel — за веб-инструменты. Анонимный лимит, credits, доступность и политика данных остаются правилами стороннего сервиса. Сверяйте отдельно настройку Claude Code, настройку Codex и документацию Parallel Search MCP.

Типовые сбои и короткая повторная проверка

Симптом	Что проверить первым	Как перепроверить
Сервер добавлен, tools не видны	Полностью перезапустить клиент; проверить синтаксис и точный URL; открыть MCP logs	В списке появились web_search и web_fetch
401	Используется ли /mcp-oauth; завершён ли OAuth; действителен ли Bearer	Повторное подключение больше не просит авторизацию
402	Credits авторизованного аккаунта	Пополнить счёт или вернуться на анонимный /mcp, затем выполнить один узкий поиск
Соединение есть, вызовов нет	Агент выбрал встроенный поиск или ответил по памяти	Повторить принудительный prompt и проверить tool trace
Результат слишком большой или обрезан	full_content, число URL и ширина objective	Отключить полный текст и читать только самые нужные страницы
В разных проектах разный результат	Scope Claude Code, approval проекта или старая сессия Codex	Снова вывести серверы в нужном проекте и повторить вызов

Стоит ли оставлять интеграцию надолго

Схема подходит, если нужен готовый поиск и чтение страниц без обслуживания собственной инфраструктуры, клиент показывает tool calls и источники, а анонимного режима хватает для лёгкой нагрузки или вы готовы учитывать авторизованные расходы.

Не переводите такую интеграцию сразу в production, если нужен публично гарантированный фиксированный бесплатный лимит, организационный аудит или Zero Data Retention без авторизации, невозможно увидеть реальные вызовы tools либо требуется полный контроль над индексом, crawler и размещением данных.

Рациональный порядок простой: сначала прогоните типичные задачи через анонимный /mcp, сохраните tool trace и URL, оцените ограничения и рост модельных токенов. Только когда анонимный режим действительно станет узким местом, переходите на Bearer или /mcp-oauth. Так качество поиска, доступность, расходы Parallel и модельный счёт остаются разными проверяемыми величинами.