Perplexity API Platform MCP Server

Что умеет сервер

Сервер выпускает сама Perplexity и открывает агенту поиск и исследование через свой API. Инструментов четыре. perplexity_search выполняет прямой веб-поиск и возвращает ранжированные результаты с метаданными и датами публикации; в нём есть фильтр свежести search_recency_filter, ограничение по доменам search_domain_filter и быстрый режим search_type: "fast" для меньшей задержки и стоимости. perplexity_ask отвечает на вопросы с поиском в реальном времени, perplexity_reason подходит для сложных аналитических задач с рассуждением, perplexity_research готовит подробные отчёты глубоким исследованием.

Последние три инструмента работают поверх Agent API с готовыми пресетами fast, medium и high. Для perplexity_ask и perplexity_reason можно задать бюджеты max_tokens и max_tokens_per_page: они ограничивают объём найденного контекста, а не длину ответа.

Когда использовать

Для быстрых фактологических вопросов берите perplexity_ask, для проверки ссылок и свежих данных perplexity_search, а perplexity_research оставьте для задач, где нужен развёрнутый отчёт: сравнение вариантов, обзор темы, разбор рынка. Рассуждающий режим уместен в аналитических заданиях, где важна цепочка выводов.

Для разового чтения известной страницы эти инструменты избыточны: достаточно сервера выборки страниц.

Ограничения и безопасность

Нужен ключ Perplexity API, он берётся в кабинете API. Глубокое исследование может идти несколько минут: сервер передаёт ход выполнения клиентам, которые об этом просят, а при очень длинных запросах таймаут увеличивают переменной PERPLEXITY_TIMEOUT_MS (по умолчанию пять минут). Если строгий клиент падает на старте с ошибкой инициализации, README советует запускать npx -yq вместо npx -y.

В самостоятельно размещённом HTTP-режиме сервер по умолчанию слушает только 127.0.0.1, кросс-доменные запросы браузеров выключены. Адрес 0.0.0.0 и список ALLOWED_ORIGINS задавайте только осознанно. Запросы и найденные материалы проходят через сервис Perplexity, поэтому конфиденциальные данные в них не включайте. Параметры strip_thinking и reasoning_effort старых версий больше не поддерживаются.

Размещённый сервер, Claude Code

Сервер размещает сама Perplexity, подключение по Streamable HTTP с вашим ключом API:

https://api.perplexity.ai/mcp

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

Локальный сервер, Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Либо через плагин:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Другие клиенты

Cursor, Claude Desktop, Kiro, Windsurf и VS Code настраиваются одним блоком mcpServers в своих файлах конфигурации: ~/.cursor/mcp.json, claude_desktop_config.json, .kiro/settings/mcp.json, ~/.codeium/windsurf/mcp_config.json и .vscode/mcp.json.

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Самостоятельный HTTP-режим

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Сервер будет доступен по адресу http://localhost:8080/mcp.