MCP-сервер для поиска: подключение Brave и проверка вызова

MCP-сервер для поиска даёт ИИ-клиенту отдельный инструмент, который возвращает результаты из поискового API. Для публичного веб-поиска можно подключить официальный Brave Search MCP и проверить вызов brave_web_search. Понадобятся совместимый клиент, доступ к Brave Search API и ключ; сам факт подключения не доказывает правильность ответа или прочтение найденных страниц.

Какой именно поиск вы подключаете

Здесь нужен поиск по публичным страницам интернета. Поиск внутри закрытой папки, корпоративных документов или базы товаров требует другого сервера и другого доступа. Официальный пакет принадлежит организации Brave: его репозиторий находится в brave/brave-search-mcp-server. Не путайте его с похожими сторонними проектами.

MCP определяет способ подключения инструментов, а источник выдачи здесь Brave Search API. Устройство протокола разобрано в объяснении MCP-сервера. Эта инструкция заканчивается проверкой подключения и реального поиска. Подготовка содержательного отчёта по найденным страницам является следующей задачей, описанной в разборе поискового агента.

Принимайте подключение по цепочке «инструмент, параметры, ответ сервиса, открывающиеся ссылки». Уверенная фраза модели о поиске не заменяет ни одного звена.

Что проверить до настройки

Сначала убедитесь, что нужный клиент вообще запускает локальные MCP-серверы. Ниже дан конкретный пример для VS Code с Copilot Chat в локальной сессии Extension Host. Переносить его без изменений в другие приложения нельзя: у них отличаются схема настроек и способ передачи секретов.

• Клиент уже доступен с вашей учётной записью, а политика организации разрешает MCP.
• Есть установленный Node.js и команда npx; требования окружения сверены в официальном репозитории пакета.
• Кабинет Brave Search API открывается, план активирован, ключ создан для этой интеграции.
• Вы понимаете, какие сведения попадут в поисковую строку, и исключили закрытые рабочие данные.
• Вы знаете, где остановить сервер и где отозвать либо заменить ключ у поставщика.

Brave описывает получение ключа после активации плана в официальном быстром старте API. Не обещайте себе бесплатный запуск по старому обзору: условия API и доступ к модели проверяются отдельно. Эта статья не подтверждает оплату, регистрацию или доступность для конкретного аккаунта из России. Если кабинет недоступен, остановитесь на этом этапе, не приобретайте чужие ключи.

Как сохранить настройку без ключа в проекте

Откройте палитру команд VS Code и выполните MCP: Open User Configuration. Сохраните прежнее содержимое файла перед изменением. В пользовательской конфигурации добавьте сервер и поле ввода ключа, объединив их с уже существующими servers и inputs. Не заменяйте весь файл, если там уже есть другие инструменты. Команды и защищённые input-переменные описаны в справке VS Code.

{
  "inputs": [
    {
      "id": "brave-api-key",
      "type": "promptString",
      "description": "Brave Search API key",
      "password": true
    }
  ],
  "servers": {
    "brave-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "@brave/brave-search-mcp-server@2.1.4",
        "--transport", "stdio"
      ],
      "env": {
        "BRAVE_API_KEY": "${input:brave-api-key}",
        "BRAVE_MCP_ENABLED_TOOLS": "brave_web_search"
      }
    }
  }
}

В примере зафиксирован выпуск 2.1.4, указанный в официальном манифесте Brave на момент проверки. Параметры stdio, BRAVE_API_KEY и список разрешённых инструментов BRAVE_MCP_ENABLED_TOOLS описаны в README поставщика. Здесь оставлен один поисковый инструмент, чтобы проще проверить первый вызов.

Запуск пакета означает выполнение программы на вашем компьютере. Просмотрите издателя и конфигурацию до доверия серверу. VS Code предупреждает об этом в инструкции управления MCP. В примере ключ вводится через отдельное поле клиента, а не вставляется в JSON, исходники, сообщение модели или снимок экрана.

Важная граница: текущая документация VS Code говорит, что конфигурации с интерактивными input-переменными не передаются в Agent Host. Поэтому этот пример относится к локальной Extension Host сессии. Если ваша сессия работает через Agent Host, выберите поддерживаемую им настройку секретов по справке конфигурации, а не заменяйте поле ввода открытым ключом в общем проекте.

Как доказать, что поиск действительно работает

Запустите MCP: List Servers, выберите brave-search, выполните запуск и откройте вывод сервера. При запросе клиента введите свой ключ. В перечне доступных инструментов должен появиться brave_web_search. Наличие сервера в списке без инструмента ещё не является успешным подключением.

1. В новом чате оставьте включённым только нужный поисковый инструмент и задайте нейтральную задачу без личных данных.
2. Попросите вызвать brave_web_search для поиска официальной документации MCP и показать использованные ссылки.
3. Раскройте вызов: проверьте имя инструмента и фактическую строку в query.
4. Проверьте ответ самого инструмента: присутствуют результаты с адресами страниц либо понятная ошибка.
5. Откройте подходящий официальный адрес самостоятельно. Сопоставьте домен и заголовок с ответом модели.
6. Запишите итог: подключение, вызов и источник проверены отдельно. Не принимайте вывод только потому, что текст выглядит правдоподобно.

У brave_web_search предусмотрены параметры языка поиска и страны; они перечислены в справке Brave MCP. Если проверяете русскоязычную выдачу, попросите инструмент использовать search_lang=ru и убедитесь в параметрах вызова. Язык итогового текста модели не доказывает, что язык самого поиска выбран правильно.

Сохраните небольшую карточку приёмки: «сервер; выпуск; инструмент; параметры; успешный ответ; открытая ссылка». Это позволяет повторить проверку после обновления. Не сохраняйте туда значение ключа. Результат поиска может содержать выдержку страницы: не выдавайте её за прочтение полного документа и не цитируйте сведения, которых в проверенном источнике нет.

По теме: MCP-сервер для API: как подключить один безопасный метод

Как найти причину сбоя по этапу

Диагностируйте первый неудачный этап, а не меняйте все настройки одновременно. Если процесс не появился, проверьте журнал запуска, наличие npx и правильность имени пакета. При удалённом рабочем окружении команда должна существовать там, где клиент реально запускает сервер. Общая проверка процесса описана в инструкции локального MCP.

• Сервер стартовал, инструмент не появился: сверяйте транспорт, список разрешённых tools и конфигурацию именно текущей сессии.
• Инструмент появился, API отказал: проверьте ключ, активный план и сообщение API в кабинете. Не публикуйте полный секрет ради диагностики.
• API сообщил о лимите: прекратите автоматические повторы, сверьте ограничения своего плана и возобновите после разрешённого интервала.
• Модель ответила без вызова: откройте выбор инструментов и явно попросите использовать brave_web_search.
• Вызов успешен, вывод неточен: это уже проверка источника и ответа, а не доказательство поломки MCP.

Как отключить и когда выбрать другой способ

Через MCP: List Servers отключите сервер и убедитесь, что его инструменты исключены из чата. Простая остановка процесса может быть временной, если клиент настроен запускать его снова. VS Code отдельно описывает отключение и автоматический запуск в руководстве управления серверами. Если ключ раскрыт, отключения клиента недостаточно: замените его у поставщика.

Для разового публичного поиска встроенного инструмента клиента может быть достаточно. MCP имеет смысл, если нужен именно выбранный поставщик и проверяемый вызов его API. Для закрытых документов этот способ не подходит: нужен поиск внутри разрешённого контура. Не отправляйте в публичную строку имена клиентов, закрытые номера договоров или текст внутренней переписки.

Частые вопросы

Нужен ли отдельный VPS?

Для описанного локального запуска stdio отдельный сервер в интернете не нужен. Поиск при этом обращается к внешнему Brave API.

MCP-пакет делает поиск бесплатным?

Нет. Условия поискового API и доступа к модели проверяются отдельно от установки пакета.

Можно подключить этот JSON к любому клиенту?

Нет. Здесь схема VS Code для конкретной локальной сессии. В другом клиенте нужны его формат и способ хранения секретов.

Почему поиск сработал, а ссылка не подтверждает ответ?

Успешный API-вызов подтверждает получение выдачи. Достоверность утверждения проверяется по содержанию выбранного источника отдельно.