Perplexity

MCP-сервер платформы Perplexity API

     

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

Удаленный MCP-сервер

Удаленный MCP-сервер размещается компанией Perplexity и является самым простым способом начать работу: те же инструменты, ничего не нужно устанавливать или обновлять. Кнопки Cursor и VS Code в верхней части этой страницы подключаются к нему одним кликом. Если ваш MCP-клиент еще не поддерживает удаленные серверы, перейдите к настройке локального сервера ниже. Подключение через Streamable HTTP с вашим ключом API Perplexity:

https://api.perplexity.ai/mcp

Для Claude Code:

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

См. документацию по интеграции MCP для ручной настройки Cursor/VS Code, использования через Anthropic API и настройки для других клиентов.

Локальный MCP-сервер

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

1. Получите ключ API Perplexity на портале API
2. Замените your_key_here в приведенных ниже конфигурациях на ваш ключ API
3. (Необязательно) Установите тайм-аут: PERPLEXITY_TIMEOUT_MS=600000 (по умолчанию: 5 минут)
4. (Необязательно) Установите пользовательский базовый URL: PERPLEXITY_BASE_URL=https://your-custom-url.com (по умолчанию: https://api.perplexity.ai)
5. (Необязательно) Установите уровень журналирования: 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

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

Большинство клиентов можно настроить вручную, используя ту же обертку 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. Получите данные прокси

• Уточните у вашего IT-отдела адрес 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

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

perplexity_search

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

perplexity_ask

Универсальный диалоговый AI с веб-поиском в реальном времени на основе пресета Agent API fast. Отлично подходит для быстрых вопросов и повседневных поисков.

perplexity_research

Глубокие всесторонние исследования на основе пресета Agent API high. Идеально для тщательного анализа и подробных отчетов. Запуск может занять несколько минут; сервер транслирует выполнение и сообщает о прогрессе клиентам, которые это запрашивают.

perplexity_reason

Продвинутые рассуждения и решение задач на основе пресета Agent API medium. Идеально для сложных аналитических задач.

[!NOTE] Пресеты — это управляемые конфигурации (модель, настройки поиска, бюджет шагов), которые Perplexity поддерживает и обновляет со временем; см. руководство по пресетам. Более ранние версии этого сервера вызывали устаревшие модели sonar-pro, sonar-reasoning-pro и sonar-deep-research и принимали параметры strip_thinking / reasoning_effort. Эти параметры больше не являются частью схем инструментов и игнорируются при отправке; Agent API не создает тегов <think>.

Использование в качестве библиотеки

Пакет также экспортирует фабрику сервера для встраивания в ваш собственный процесс Node:

import { createPerplexityServer } from "@perplexity-ai/mcp-server";

// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");

// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
  apiKey: () => currentRequestApiKey,
});

Подключите возвращаемый сервер к любому MCP-транспорту (stdio, streamable HTTP, in-memory).

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

• Проблемы с ключом 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 или создайте обращение.

---