Perplexity Ask MCP Server

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

Плагины агентов

Этот репозиторий упакован как плагин агента, поэтому клиенты, поддерживающие стандарт, могут установить его напрямую из этого репозитория. Формат плагинов агентов не передаёт секреты, поэтому задайте переменную окружения 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	Ваш ключ 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) и быстрый поиск (search_type: "fast") для снижения задержки и стоимости.

perplexity_ask

Универсальный разговорный ИИ с веб-поиском в реальном времени на основе пресета 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 или создайте issue.

---