Perplexity Ask MCP Server
официальныйКоннектор для Perplexity API, обеспечивающий веб-поиск в экосистеме MCP.
Что можно делать с Perplexity Ask MCP?
- Веб-поиск в реальном времени — Запрашивайте актуальные ранжированные результаты поиска с фильтрами по дате, ограничениями по доменам или быстрым режимом через
perplexity_search. - Диалоговые вопросы и ответы — Получайте быстрые ответы на повседневные вопросы, основанные на веб-данных, с помощью инструмента
perplexity_ask. - Глубокие исследовательские отчёты — Запрашивайте комплексный многоэтапный анализ для тщательных расследований через
perplexity_research. - Продвинутые рассуждения — Решайте сложные аналитические задачи с пошаговым подходом через
perplexity_reason. - Настраиваемая глубина поиска — Управляйте объёмом получаемого поискового контекста, задавая лимиты
max_tokensиmax_tokens_per_pageдля инструментов ask и reason.
Документация
MCP-сервер платформы Perplexity API
Официальная реализация MCP-сервера для платформы Perplexity API, предоставляющая AI-ассистентам возможности поиска в реальном времени, рассуждений и исследований через Agent API и Search API.
Удалённый MCP-сервер
Удалённый MCP-сервер размещён компанией Perplexity и является самым простым способом начать работу: те же инструменты, ничего не нужно устанавливать или обновлять. Кнопки Cursor и VS Code в верхней части этой страницы подключаются к нему одним кликом. Если ваш MCP-клиент ещё не поддерживает удалённые серверы, перейдите к настройке локального сервера ниже. Подключение через Streamable HTTP с вашим ключом Perplexity API:
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
- Получите ключ Perplexity API на портале API
- Замените
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
Плагины агентов
Этот репозиторий упакован как Agent Plugin, поэтому клиенты, поддерживающие стандарт, могут установить его напрямую из этого репозитория. Формат Agent Plugins не передаёт секреты, поэтому установите переменную окружения PERPLEXITY_API_KEY через настройки плагина или MCP вашего клиента.
Другие 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 | Ваш ключ Perplexity API | Обязательно |
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) и Fast Search (search_type: "fast") для снижения задержки и стоимости.
perplexity_ask
Универсальный диалоговый ИИ с веб-поиском в реальном времени на основе пресета Agent API fast. Отлично подходит для быстрых вопросов и повседневных запросов.
perplexity_research
Глубокие и всесторонние исследования на основе пресета Agent API high. Идеально для тщательного анализа и подробных отчётов. Выполнение может занять несколько минут; сервер транслирует выполнение и сообщает о прогрессе клиентам, которые это запрашивают.
perplexity_reason
Продвинутые рассуждения и решение задач на основе пресета Agent API medium. Идеально для сложных аналитических задач.
perplexity_ask и perplexity_reason принимают необязательные положительные целые значения max_tokens (общий контекст поиска, до 120 000) и max_tokens_per_page (контекст на страницу результатов, до 20 000). Эти бюджеты Agent API контролируют объём полученного поискового контента, а не длину сгенерированного ответа. Если они не указаны, действует конфигурация поиска пресета.
Устаревший аргумент search_context_size по-прежнему принимается, но преобразуется локально в явные бюджеты, а не отправляется в Agent API:
| Устаревший размер | Всего токенов | Токенов на страницу |
|---|---|---|
low | 2000 | 512 |
medium | 4000 | 1024 |
high | 8000 | 2048 |
Эта политика совместимости не является точным эквивалентом именованных размеров Sonar; в руководстве по миграции Agent API нет эквивалента именованных размеров. Каждый явный бюджет переопределяет соответствующий устаревший размер по умолчанию.
[!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 или создайте обращение.