Perplexity Ask MCP Server

официальный

Коннектор для Perplexity API, обеспечивающий веб-поиск в экосистеме MCP.

Документация

Perplexity API Platform MCP Server

Официальная реализация MCP-сервера для платформы Perplexity API, предоставляющая ИИ-ассистентам возможности поиска в реальном времени, рассуждений и исследований с помощью моделей Sonar и Search API.

Доступные инструменты

perplexity_search

Прямой веб-поиск с использованием Perplexity Search API. Возвращает ранжированные результаты поиска с метаданными — идеально для поиска актуальной информации.

perplexity_ask

Универсальный диалоговый ИИ с поиском в реальном времени на базе модели sonar-pro. Отлично подходит для быстрых вопросов и повседневных поисковых запросов.

perplexity_research

Глубокое всестороннее исследование с использованием модели sonar-deep-research. Идеально для тщательного анализа и подробных отчётов.

perplexity_reason

Продвинутые рассуждения и решение задач с помощью модели sonar-reasoning-pro. Идеально для сложных аналитических задач.

[!TIP] Доступен как опциональный параметр для perplexity_reason и perplexity_research: strip_thinking

Установите значение true, чтобы удалить теги <think>...</think> из ответа, экономя контекстные токены. По умолчанию: false

Настройка

Получение API-ключа

Получите API-ключ Perplexity в API Portal
Замените your_key_here в конфигурациях ниже на ваш API-ключ
(Опционально) Установите тайм-аут: PERPLEXITY_TIMEOUT_MS=600000 (по умолчанию: 5 минут)
(Опционально) Установите пользовательский базовый URL: PERPLEXITY_BASE_URL=https://your-custom-url.com (по умолчанию: https://api.perplexity.ai)
(Опционально) Установите уровень логирования: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (по умолчанию: ERROR)

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). Если у клиента другая схема, смотрите его документацию для точного формата обёртки.

При ручной настройке все эти клиенты используют одинаковую структуру mcpServers:

Клиент	Файл конфигурации
Cursor	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
Kiro	`.kiro/settings/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code	`.vscode/mcp.json`

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

Настройка прокси (для корпоративных сетей)

Если вы запускаете этот сервер на работе — особенно за корпоративным брандмауэром или прокси — вам может потребоваться указать программе, как направлять интернет-трафик через прокси вашей сети. Выполните следующие шаги:

1. Получите данные прокси

Запросите у ИТ-отдела адрес и порт HTTPS-прокси.
Также могут потребоваться имя пользователя и пароль.

2. Установите переменную окружения прокси

Самый простой и надёжный способ для Perplexity MCP — использовать PERPLEXITY_PROXY. Например:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Если ваш прокси требует имя пользователя и пароль, используйте:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Альтернатива: стандартные переменные окружения

Если вы предпочитаете использовать стандартные переменные, мы поддерживаем HTTPS_PROXY и HTTP_PROXY.

[!NOTE] Сервер проверяет настройки прокси в следующем порядке: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Если ни одна не задана, он подключается к интернету напрямую. URL-адреса должны включать https://. Типичные порты: 8080, 3128 и 80.

Развёртывание HTTP-сервера

Для облачных или общих развёртываний запускайте сервер в режиме HTTP.

Переменные окружения

Переменная	Описание	По умолчанию
`PERPLEXITY_API_KEY`	Ваш API-ключ Perplexity	Обязательно
`PERPLEXITY_BASE_URL`	Пользовательский базовый URL для API-запросов	`https://api.perplexity.ai`
`PORT`	Порт HTTP-сервера	`8080`
`BIND_ADDRESS`	Сетевой интерфейс для привязки. По умолчанию loopback. Установите `0.0.0.0`, чтобы открыть на всех интерфейсах.	`127.0.0.1`
`ALLOWED_ORIGINS`	Источники CORS (через запятую). По умолчанию пусто (нет кросс-доменных запросов из браузера). Установите явный список разрешённых (например, `https://app.example.com`) или `*`, чтобы разрешить любой источник.	(пусто)
`ALLOWED_HOSTS`	Дополнительные значения заголовка `Host` для приёма (через запятую). Хосты loopback на `PORT` всегда разрешены. Добавьте публичное имя хоста при привязке к `0.0.0.0`.	(только loopback)

Docker

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

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

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

Устранение неполадок

Проблемы с API-ключом: Убедитесь, что PERPLEXITY_API_KEY установлен правильно
Ошибки подключения: Проверьте интернет-соединение и действительность API-ключа
Инструмент не найден: Убедитесь, что пакет установлен и путь к команде указан верно
Ошибки тайм-аута: Для очень длинных исследовательских запросов установите PERPLEXITY_TIMEOUT_MS на более высокое значение
Проблемы с прокси: Проверьте настройки PERPLEXITY_PROXY или HTTPS_PROXY и убедитесь, что api.perplexity.ai не заблокирован брандмауэром.
Ошибки EOF / инициализации: Некоторые строгие MCP-клиенты выдают сбой, потому что npx записывает установочные сообщения в stdout. Используйте npx -yq вместо npx -y, чтобы подавить этот вывод.

Для поддержки посетите community.perplexity.ai или создайте обращение.