Гайды

Как подключить Perplexity через MCP

13 октября 2026 · 10 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 13 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Как подключить Perplexity через MCP: добавьте в свой агент-клиент официальный MCP-сервер Perplexity API Platform и работать с поиском прямо из интерфейса агента. В документации Perplexity указан адрес подключения: сервер доступен по https://api.perplexity.ai/mcp через Streamable HTTP. Дальше клиент авторизуется одним из двух способов — входом в аккаунт Perplexity по OAuth либо ключом API в заголовке.

Мы скачали подборку результатов веб-поиска по запросу «Как подключить Perplexity через MCP»: текст отдали 10 из 10 страниц, медиана объёма читаемого текста топа — 1381 слово, метку 2026 года несут 7 из 10 прочитанных страниц. Разбираем документированный маршрут целиком.

Что именно подключается и где проходят границы продукта

Речь идёт об официальном MCP-сервере Perplexity API Platform. В репозитории perplexityai/modelcontextprotocol он описан как официальная реализация MCP-сервера для платформы Perplexity API. Это отдельная сущность: сервер отдаёт агенту инструменты поиска и работы с моделями.

Второй момент — версии инструментов. В README репозитория отмечено, что ранние версии сервера обращались к устаревшим моделям sonar-pro, sonar-reasoning-pro и sonar-deep-research и принимали параметры strip_thinking и reasoning_effort; эти параметры больше не входят в схемы инструментов и игнорируются при отправке, а Agent API не порождает теги thinking. Практический вывод: конфигурации из старых инструкций могут содержать лишние поля, и это ожидаемо.

Третий момент — состав инструментов. В репозитории inde5media/PERPLEXITY-MCP перечислены perplexity_search, perplexity_ask, perplexity_research и perplexity_reason. Названия удобно использовать как ориентир при проверке: после подключения агент должен видеть набор инструментов.

Что сюда не входит. Плагин Perplexity для VS Code — отдельная история со своей установкой; про неё у нас есть разбор установки плагина в VSCode. Сторонние обёртки и кастомные коннекторы в Perplexity — тоже отдельный сценарий, о нём ниже.

Условия доступа: ключ API, OAuth и что требуется до старта

До настройки нужен доступ к API-платформе Perplexity. В документации описаны два способа авторизации, и выбор между ними определяет всю дальнейшую конфигурацию.

Первый способ — вход по OAuth. Формулировка из документации: «Sign in with Perplexity (OAuth): add the server without any credentials. On first use your client opens a browser where you sign in to your Perplexity account, choose the API organization to bill, and approve the connection». То есть сервер добавляется без учётных данных, а при первом использовании клиент открывает браузер, вы входите в аккаунт Perplexity, выбираете организацию для биллинга и подтверждаете подключение.

Второй способ — ключ API. Документация предлагает отправлять ключ как bearer-токен: «API key: send your key as a bearer token. Use this for clients that do not support OAuth, or for server-side setups such as the Anthropic API MCP connector. Authorization: Bearer YOUR_API_KEY». Этот вариант подходит клиентам без поддержки OAuth и серверным сценариям.

Что подготовить заранее:

• Аккаунт Perplexity с доступом к API-платформе.
• Понимание, на какую организацию пойдёт биллинг: при OAuth организация выбирается в браузере, при ключе — ключ уже привязан к ней.
• Клиент, который умеет работать с MCP: Claude Code, Codex, Cursor, Claude Desktop, Kiro, Windsurf, VS Code — эти клиенты перечислены в заголовках репозитория.
• Для корпоративных сетей — настройка прокси, она описана отдельным разделом в репозитории.

Отдельно про оплату. В документации Perplexity указано, что тарификация идёт по стандартным ценам API, а лимиты определяются организацией. В быстром старте API заявлена модель pay-as-you-go для всех API без обязательной подписки. Конкретные суммы зависят от вашего тарифа и объёма вызовов — их стоит смотреть в биллинге аккаунта.

Актуальные требования стоит сверять в двух местах: в документации Perplexity по интеграции MCP-сервера и в README репозитория perplexityai/modelcontextprotocol. Документация отвечает за адрес и способы авторизации, README — за команды установки и переменные окружения. Обе страницы обновляются, поэтому при расхождении с чужим гайдом ориентируйтесь на них.

Порядок действий: подключение в Claude Code и других клиентах

Документированный маршрут начинается с Claude Code. В документации Perplexity приведена команда добавления сервера: claude mcp add --transport http perplexity https://api.perplexity.ai/mcp. После этого нужно запустить /mcp внутри Claude Code и пройти приглашение ко входу для perplexity — так описывает процесс документация: «Run /mcp inside Claude Code and follow the sign-in prompt for perplexity».

Альтернативный маршрут — локальный сервер с ключом. В README репозитория дана команда: claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server. Здесь ключ передаётся переменной окружения, а сам сервер запускается через npx. В README отмечено, что для подавления лишнего вывода стоит использовать npx -yq вместо npx -y.

Пошаговый порядок для HTTP-подключения:

1. Убедитесь, что у вас есть доступ к API-платформе Perplexity и определена организация для биллинга.
2. Добавьте сервер командой claude mcp add --transport http perplexity https://api.perplexity.ai/mcp.
3. Запустите /mcp в Claude Code.
4. Пройдите приглашение ко входу: браузер откроется, вы войдёте в аккаунт Perplexity, выберете организацию и подтвердите подключение.
5. Проверьте, что агент видит инструменты сервера.
6. Выполните пробный поисковый запрос и убедитесь, что ответ приходит с цитатами.

Если вы работаете в редакторе кода, посмотрите также наш материал о плагине Perplexity в VSCode — это смежный, но отдельный маршрут.

Учебный пример: поиск с цитатами и критерии проверки

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

Задача: получить от агента короткую сводку по теме с указанием источников. Формулировка запроса к агенту после подключения:

Найди свежие материалы по теме [ваша тема] и дай краткую сводку: три ключевых тезиса, для каждого — ссылка на источник. Если по теме есть расхождения в данных, покажи их отдельно. Объём — кратко.

Что в нём менять под себя: [ваша тема] — предмет поиска; при необходимости добавьте требование к языку источников или к периоду публикаций. Числовых лимитов объёма в промпте нет намеренно — формулировка «кратко» оставляет длину на усмотрение агента.

Вариации той же задачи:

• Сравнение: «Сравни подходы к [тема] по материалам из поиска и сведи в таблицу: подход, аргумент, источник».
• Проверка факта: «Проверь утверждение: [утверждение]. Найди подтверждения и опровержения, дай ссылки».
• Обзор рынка: «Собери обзор по [отрасль]: основные игроки, свежие новости, ссылки на первоисточники».
• Глубокий разбор: «Разбери тему [тема] подробно: контекст, ключевые документы, спорные места, список источников».
• Мониторинг: «Найди публикации за последнюю неделю по [тема] и перечисли их с краткими аннотациями».

Если какой-то критерий не выполняется, переходите к диагностике из следующего раздела.

Смежные варианты: что выбирать под задачу

Официальный сервер — базовый вариант, но не единственный. Разберём, что выбирать в разных ситуациях.

Отдельно стоит сказать про сторонние реализации. В выдаче по запросу встречаются репозитории inde5media/PERPLEXITY-MCP и shoemoney/perplexity-mcp, а также страница mcpyet.com с пометкой об официальности сервера. В README репозитория helallao/perplexity-ai есть раздел с отличиями от официального MCP — полезно прочитать, если вы выбираете между реализациями. Общее правило: официальный сервер описан в документации Perplexity и в репозитории perplexityai/modelcontextprotocol, остальное — сторонние варианты со своими особенностями.

Ещё один смежный сюжет — использование Perplexity Computer для прикладных задач. В changelog Perplexity описаны обновления продукта, включая раздел про установку MCP-сервера Perplexity API в качестве плагина агента. Если вам нужны не только поисковые вызовы, но и рабочие сценарии вроде подготовки материалов, посмотрите наш разбор презентации в Perplexity — там про сборку слайдов.

Типичные проблемы и проверяемые способы диагностики

Проблемы при подключении укладываются в несколько групп, и каждую можно проверить по конкретному признаку.

Инструменты не появились. Проверьте, что сервер добавлен именно в тот клиент, где вы смотрите список. В Claude Code состояние видно по команде /mcp. Если сервер добавлен, но инструментов нет, перезапустите клиент и проверьте синтаксис команды добавления.

Ошибка авторизации при OAuth. При первом использовании клиент открывает браузер, где нужно войти в аккаунт Perplexity, выбрать организацию для биллинга и подтвердить подключение. Если браузер не открылся или вход не завершён, подключение не активируется. Проверьте, что вы вошли в тот аккаунт, у которого есть доступ к API-платформе.

Ошибка с ключом API. Ключ отправляется как bearer-токен в заголовке Authorization: Bearer YOUR_API_KEY. Проверьте, что ключ передан целиком, без лишних пробелов, и что он привязан к нужной организации. Для локального запуска ключ задаётся переменной PERPLEXITY_API_KEY.

Лишний вывод при запуске через npx. В README репозитория указано решение: использовать npx -yq вместо npx -y, чтобы подавить вывод.

Параметры из старых инструкций не работают. Параметры strip_thinking и reasoning_effort больше не входят в схемы инструментов и игнорируются при отправке. Если гайд требует их указать, ориентируйтесь на актуальный README.

Корпоративная сеть блокирует соединение. В репозитории есть отдельный раздел про настройку прокси. Проверьте, что прокси настроен для того клиента, через который идёт подключение.

Упёрлись в лимиты. Вызовы тарифицируются по стандартным ценам API на ключ или организацию, и действуют лимиты организации. Проверьте биллинг и лимиты в аккаунте.

Порядок диагностики простой: сначала проверьте видимость инструментов, затем авторизацию, затем сеть, затем лимиты. Так вы отсекаете большинство причин за несколько шагов.

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

Что такое Perplexity MCP?
Это официальный MCP-сервер Perplexity API Platform, описанный в репозитории perplexityai/modelcontextprotocol. Он даёт агенту-клиенту инструменты поиска и работы с моделями Perplexity. Подключение идёт по адресу https://api.perplexity.ai/mcp через Streamable HTTP.

Как подключить Perplexity MCP в Claude Code?
Добавьте сервер командой claude mcp add --transport http perplexity https://api.perplexity.ai/mcp, затем запустите /mcp и пройдите приглашение ко входу. Альтернатива — локальный запуск с ключом через npx и переменную PERPLEXITY_API_KEY. После подключения проверьте список инструментов и выполните пробный поиск.

Нужен ли ключ API, если есть вход по OAuth?
Нет. Документация описывает OAuth как способ добавить сервер без учётных данных: при первом использовании клиент открывает браузер, вы входите в аккаунт Perplexity, выбираете организацию для биллинга и подтверждаете подключение. Ключ API нужен клиентам без поддержки OAuth и серверным сценариям.

Почему не работают параметры strip_thinking и reasoning_effort?
Эти параметры остались от ранних версий сервера, которые обращались к устаревшим моделям. В текущих схемах инструментов их нет, и при отправке они игнорируются. Уберите их из конфигурации и сверьтесь с актуальным README репозитория.

Как проверить, что подключение работает?
Выполните поисковый запрос и посмотрите на ответ: агент должен вызвать инструмент поиска и вернуть ссылки на источники. Проверьте, что ссылки открываются и тезисы им соответствуют. Если ответ приходит без вызова инструмента, проверьте видимость инструментов и авторизацию.