Perplexity MCP-сервер

Официальный MCP-сервер платформы Perplexity API. Предоставляет AI-ассистентам доступ к веб-поиску в реальном времени, углублённому исследованию и решению сложных задач через модели Sonar и Search API.

Инструменты

Сервер предоставляет четыре инструмента:

• perplexity_search — прямой поиск через Perplexity Search API. Возвращает ранжированные результаты с метаданными. Идеален для поиска актуальной информации.
• perplexity_ask — разговорный AI c веб-поиском на модели sonar-pro. Подходит для быстрых вопросов и повседневных запросов.
• perplexity_research — глубокое исследование на модели sonar-deep-research. Для всестороннего анализа и подробных отчётов.
• perplexity_reason — продвинутые рассуждения и решение проблем на модели sonar-reasoning-pro. Для сложных аналитических задач.

Дополнительный параметр: у инструментов perplexity_reason и perplexity_research есть опция strip_thinking. Установите true, чтобы убрать из ответа теги \<thinking>...\</thinking> — это экономит токены контекста. По умолчанию false.

Конфигурация

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

1. Получите API-ключ в портале Perplexity API.

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

   export PERPLEXITY_API_KEY=ваш_ключ
   

3. (Опционально) Настройте таймаут запросов:

   export PERPLEXITY_TIMEOUT_MS=600000
   

   По умолчанию — 5 минут.

Установка в IDE

Claude Code

Способ 1 (рекомендуемый): через плагин

В терминале Claude Code последовательно выполните:

/plugin marketplace add perplexityai/modelcontextprotocol
/plugin install perplexity

Затем задайте ключ:

export PERPLEXITY_API_KEY=ваш_ключ

Способ 2: вручную

claude mcp add perplexity --transport stdio --env PERPLEXITY_API_KEY=ваш_ключ -- npx -y perplexity-mcp

Или добавьте в claude.json:

{
  "mcpServers": {
    "perplexity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "perplexity-mcp"],
      "env": {
        "PERPLEXITY_API_KEY": "ваш_ключ",
        "PERPLEXITY_TIMEOUT_MS": "600000"
      }
    }
  }
}

Cursor / VS Code

Добавьте в mcp.json (Cursor) или .vscode/mcp.json (VS Code):

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "ваш_ключ",
        "PERPLEXITY_TIMEOUT_MS": "600000"
      }
    }
  }
}

Также можно воспользоваться кнопками быстрой установки в начале оригинального README.

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY=ваш_ключ -- npx -y @perplexity-ai/mcp-server

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "ваш_ключ",
        "PERPLEXITY_TIMEOUT_MS": "600000"
      }
    }
  }
}

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

Для любого совместимого клиента:

npx @perplexity-ai/mcp-server

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

Если сервер работает за корпоративным прокси/файрволом:

1. Узнайте у IT-отдела адрес HTTPS-прокси и порт (возможно, потребуются логин и пароль).

2. Самый надёжный способ — переменная 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.

Порядок приоритета: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Если ничего не задано, соединение идёт напрямую. URL обязательно должен начинаться с https://. Типичные порты: 8080, 3128, 80.

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

• Проблемы с API-ключом: проверьте, что PERPLEXITY_API_KEY установлен правильно.
• Ошибки подключения: проверьте интернет и валидность ключа.
• Инструмент не найден: убедитесь, что пакет установлен и путь указан верно.
• Таймаут: для долгих исследовательских запросов увеличьте PERPLEXITY_TIMEOUT_MS.
• Прокси: проверьте настройки PERPLEXITY_PROXY или HTTPS_PROXY и убедитесь, что api.perplexity.ai не блокируется файрволом.

Поддержка: community.perplexity.ai или GitHub Issues.