Perplexity Ask MCP Server

Perplexity API Platform MCP Server

     

Официальная реализация 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 Portal
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 или создайте обращение.

---