Perplexity MCP: поиск Perplexity в Claude, Codex и Cursor

perplexityai/modelcontextprotocol· Проверено 12.11.2026· 2,6 тыс.на GitHub

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

2 реализации:

Сервер на стороне Perplexity: ставить и обновлять ничего не нужно, инструменты те же, что в локальном.

Как подключить

Что сделать до подключения

Authorization

ключ API из console.perplexity.ai в заголовке Authorization: Bearer <ключ>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp \
  --header 'Authorization: Bearer <ключ API Perplexity>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.perplexity]
url = "https://api.perplexity.ai/mcp"
http_headers = { "Authorization" = "Bearer <ключ API Perplexity>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "perplexity": {
      "url": "https://api.perplexity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <ключ API Perplexity>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "perplexity": {
      "type": "http",
      "url": "https://api.perplexity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <ключ API Perplexity>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "perplexity": {
      "httpUrl": "https://api.perplexity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <ключ API Perplexity>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "perplexity": {
      "httpUrl": "https://api.perplexity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <ключ API Perplexity>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "perplexity": {
        "type": "remote",
        "url": "https://api.perplexity.ai/mcp",
        "headers": {
          "Authorization": "Bearer <ключ API Perplexity>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://api.perplexity.ai/mcp
Request headers: Authorization: Bearer <ключ API Perplexity>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "perplexity": {
      "url": "https://api.perplexity.ai/mcp",
      "headers": {
        "Authorization": "Bearer <ключ API Perplexity>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

perplexity_searchищет в интернете с фильтрами

perplexity_askотвечает на вопрос с поиском

perplexity_reasonрешает аналитическую задачу

perplexity_researchготовит подробное исследование

Пакет npm для клиентов без поддержки удалённых серверов; умеет ходить через корпоративный прокси и подниматься как свой HTTP-сервер; лицензия MIT.

Как подключить

Что сделать до подключения

Node.js с npx

PERPLEXITY_API_KEY

ключ из API-портала console.perplexity.ai

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PERPLEXITY_API_KEY=<ключ API Perplexity>' --transport stdio modelcontextprotocol \
  -- npx -y @perplexity-ai/mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.modelcontextprotocol]
command = "npx"
args = ["-y", "@perplexity-ai/mcp-server"]

[mcp_servers.modelcontextprotocol.env]
PERPLEXITY_API_KEY = "<ключ API Perplexity>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "modelcontextprotocol": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "modelcontextprotocol": {
        "type": "local",
        "command": ["npx", "-y", "@perplexity-ai/mcp-server"],
        "environment": {
          "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "modelcontextprotocol": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "<ключ API Perplexity>"
      }
    }
  }
}

Инструменты сервера

perplexity_searchищет в интернете с фильтрами

perplexity_askотвечает на вопрос с поиском

perplexity_reasonрешает аналитическую задачу

perplexity_researchготовит подробное исследование

Что попросить агента

«Найди новости про <тема> за последнюю неделю и дай ссылки»Агент вызовет perplexity_search с фильтром search_recency_filter

«Найди в документации <библиотека> на <домен>, как настроить <функция>»Агент вызовет perplexity_search с search_domain_filter по нужному сайту

«Коротко: что нового в <технология> в последней версии?»Агент вызовет perplexity_ask

«Сравни <вариант A> и <вариант B> для <задача> и объясни выбор»Агент вызовет perplexity_reason

«Сделай подробный обзор рынка <ниша> с источниками»Агент вызовет perplexity_research и дождётся окончания исследования

Для каких задач

Найти свежие новости и публикации с датами, ограничив выдачу по давности

Искать только на выбранных сайтах, например в документации библиотеки

Быстро ответить на вопрос по текущим данным из интернета

Собрать подробный отчёт по теме с поиском в несколько шагов

Разобрать сложную аналитическую задачу с опорой на найденные источники

Ограничения

Без ключа API Perplexity сервер не работает, все запросы уходят в API Perplexity и в локальном варианте

perplexity_research идёт минутами, а таймаут локального сервера по умолчанию 5 минут: для долгих исследований поднимите PERPLEXITY_TIMEOUT_MS

Модель и настройки поиска задают пресеты, которые Perplexity меняет сама; старые параметры strip_thinking и reasoning_effort сервер игнорирует

Если не работает

Строгий клиент падает с ошибкой EOF или initialize

npx пишет сообщения об установке в stdout. Замените в args -y на -yq.

perplexity_research обрывается по таймауту

Поднимите PERPLEXITY_TIMEOUT_MS, например до 600000; по умолчанию стоит 5 минут.

Ошибки ключа API

Проверьте, что PERPLEXITY_API_KEY задан правильно и ключ действует.

Сервер не достучится до API в офисной сети

Проверьте PERPLEXITY_PROXY или HTTPS_PROXY и что файрвол не блокирует api.perplexity.ai.

Клиент пишет, что инструмент не найден

Проверьте, что пакет установлен и путь к команде в конфиге верный.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Perplexity MCP (удалённый)разработчик сервиса	Perplexity	2,6 тыс.	HTTP	токен	4	21 октября 2026
Perplexity MCP (локальный)разработчик сервиса	Perplexity	2,6 тыс.	локально	токен	4	21 октября 2026

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

Чем отличаются четыре инструмента?

perplexity_search отдаёт ранжированную выдачу Search API. perplexity_ask работает на пресете fast для быстрых вопросов, perplexity_reason — на medium для аналитики, perplexity_research — на high для подробных отчётов.

Что выбрать: удалённый или локальный сервер?

Удалённый адрес https://api.perplexity.ai/mcp проще: ставить ничего не нужно, инструменты те же. Локальный пакет @perplexity-ai/mcp-server нужен клиентам, которые пока не умеют подключать удалённые серверы.

Как работать через корпоративный прокси?

Задайте PERPLEXITY_PROXY с адресом прокси, при необходимости с логином и паролем в адресе. Сервер проверяет PERPLEXITY_PROXY, затем HTTPS_PROXY и HTTP_PROXY; адрес должен начинаться с https://.

Можно ли поднять свой HTTP-сервер для команды?

Да: соберите образ Docker или запустите npm run start:http, сервер ответит на http://localhost:8080/mcp. По умолчанию он слушает только 127.0.0.1; для внешнего доступа задайте BIND_ADDRESS=0.0.0.0 и добавьте имя хоста в ALLOWED_HOSTS.

Как ограничить объём найденного текста?

У perplexity_ask и perplexity_reason есть параметры max_tokens до 120 000 и max_tokens_per_page до 20 000. Они ограничивают найденный контент, длину ответа они не задают.

Как подключить Perplexity MCP к Claude?

В Claude Code к удалённому серверу: claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer <ключ>". Локальный вариант: claude mcp add perplexity --env PERPLEXITY_API_KEY="<ключ>" -- npx -y @perplexity-ai/mcp-server. Есть и плагин: /plugin marketplace add perplexityai/modelcontextprotocol, затем /plugin install perplexity.

Как подключить Perplexity MCP к Claude Desktop?

Добавьте в claude_desktop_config.json запись mcpServers с командой npx, аргументами -y @perplexity-ai/mcp-server и переменной PERPLEXITY_API_KEY. Для локального варианта блок есть во вкладке Claude Desktop.

Как добавить Perplexity MCP в Codex?

Командой codex mcp add perplexity --env PERPLEXITY_API_KEY="<ключ>" -- npx -y @perplexity-ai/mcp-server.

Работает ли сервер из России?

Все запросы обрабатывает API Perplexity, поэтому нужны ключ с console.perplexity.ai и доступ к api.perplexity.ai из вашей сети.

Perplexity MCP: поиск Perplexity в Claude, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

Похожие серверы