Perplexity Ask MCP Server

resmi

MCP ekosistemi içinde web aramasını etkinleştirmek için Perplexity API'sine yönelik bir bağlayıcı.

Perplexity Ask MCP ile neler yapabilirsiniz?

  • Gerçek zamanlı web araması — perplexity_search ile güncel, sıralanmış arama sonuçlarını; yenilik filtreleri, alan kısıtlamaları veya hızlı mod ile isteyin.
  • Konuşma tarzı soru-cevap — perplexity_ask aracını kullanarak günlük sorulara hızlı, web destekli yanıtlar alın.
  • Derin araştırma raporları — perplexity_research ile kapsamlı, çok adımlı analizler gerektiren detaylı incelemeler talep edin.
  • İleri düzey akıl yürütme — perplexity_reason ile adım adım problem çözme yöntemini kullanarak karmaşık analitik sorunların üstesinden gelin.
  • Özelleştirilebilir arama derinliği — ask ve reason araçları için max_tokens ve max_tokens_per_page bütçelerini ayarlayarak alınan arama bağlamını kontrol edin.

Dokümantasyon

Perplexity API Platform MCP Sunucusu

Install in Cursor   Install in VS Code   Add to Kiro   npm version

Perplexity API Platform için resmi MCP sunucu uygulaması; yapay zeka asistanlarına Agent API ve Search API üzerinden gerçek zamanlı web arama, akıl yürütme ve araştırma yetenekleri sağlar.

Uzaktan MCP Sunucusu

Uzaktan MCP sunucusu Perplexity tarafından barındırılır ve başlamanın en kolay yoludur: aynı araçlar, kurulum veya güncelleme gerektirmez. Bu sayfanın üst kısmındaki Cursor ve VS Code butonları tek tıkla bağlanır. MCP istemciniz henüz uzaktan sunucuları desteklemiyorsa, aşağıdaki yerel sunucu kurulumuna geçin. Perplexity API anahtarınızla Streamable HTTP üzerinden bağlanın:

https://api.perplexity.ai/mcp

Claude Code için:

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

Manuel Cursor/VS Code yapılandırması, Anthropic API'den kullanım ve diğer istemciler için kurulum hakkında MCP entegrasyon belgelerine bakın.

Yerel MCP Sunucusu

API Anahtarınızı Alın

  1. Perplexity API Anahtarınızı API Portalından alın
  2. Aşağıdaki yapılandırmalarda your_key_here yerine API anahtarınızı yazın
  3. (İsteğe bağlı) Zaman aşımını ayarlayın: PERPLEXITY_TIMEOUT_MS=600000 (varsayılan: 5 dakika)
  4. (İsteğe bağlı) Özel temel URL ayarlayın: PERPLEXITY_BASE_URL=https://your-custom-url.com (varsayılan: https://api.perplexity.ai)
  5. (İsteğe bağlı) Günlük düzeyini ayarlayın: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (varsayılan: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Veya eklenti aracılığıyla kurun:

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

Aracı Eklentileri

Bu depo bir Aracı Eklentisi olarak paketlenmiştir; bu nedenle standardı destekleyen istemciler doğrudan bu depodan kurabilir. Aracı Eklentileri formatı sırlar taşımaz, bu nedenle PERPLEXITY_API_KEY ortam değişkenini istemcinizin eklenti veya MCP ayarları üzerinden ayarlayın.

Diğer MCP İstemcileri

Çoğu istemci, istemci yapılandırmasında aynı mcpServers sarmalayıcısını kullanarak manuel olarak yapılandırılabilir (Cursor için gösterildiği gibi). Bir istemcinin farklı bir şeması varsa, tam sarmalayıcı formatı için belgelerine bakın.

Manuel kurulum için bu istemcilerin tümü aynı mcpServers yapısını kullanır:

İstemciYapılandırma Dosyası
Cursor~/.cursor/mcp.json
Claude Desktopclaude_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"
      }
    }
  }
}

Proxy Kurulumu (Kurumsal Ağlar İçin)

Bu sunucuyu iş yerinde—özellikle şirket güvenlik duvarı veya proxy arkasında—çalıştırıyorsanız, programa internet trafiğini ağınızın proxy'si üzerinden nasıl göndereceğini söylemeniz gerekebilir. Şu adımları izleyin:

1. Proxy bilgilerinizi alın

  • BT departmanınızdan HTTPS proxy adresinizi ve bağlantı noktanızı isteyin.
  • Bir kullanıcı adı ve şifre de gerekebilir.

2. Proxy ortam değişkenini ayarlayın

Perplexity MCP için en kolay ve en güvenilir yol PERPLEXITY_PROXY kullanmaktır. Örneğin:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Proxy'niz kullanıcı adı ve şifre gerektiriyorsa şunu kullanın:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Alternatif: Standart ortam değişkenleri

Standart değişkenleri kullanmayı tercih ederseniz, HTTPS_PROXY ve HTTP_PROXY desteklenir.

[!NOT] Sunucu proxy ayarlarını şu sırayla kontrol eder: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Hiçbiri ayarlanmamışsa, doğrudan internete bağlanır. URL'ler https:// içermelidir. Tipik bağlantı noktaları 8080, 3128 ve 80'dir.

Kendi Kendine Barındırılan HTTP Modu

Bulut veya paylaşımlı dağıtımlar için sunucuyu HTTP modunda çalıştırın.

Ortam Değişkenleri

DeğişkenAçıklamaVarsayılan
PERPLEXITY_API_KEYPerplexity API anahtarınızZorunlu
PERPLEXITY_BASE_URLAPI istekleri için özel temel URLhttps://api.perplexity.ai
PORTHTTP sunucu bağlantı noktası8080
BIND_ADDRESSBağlanılacak ağ arayüzü. Varsayılan olarak geri döngü. Tüm arayüzlerde açmak için 0.0.0.0 olarak ayarlayın.127.0.0.1
ALLOWED_ORIGINSCORS kaynakları (virgülle ayrılmış). Varsayılan olarak boş (çapraz kaynaklı tarayıcı istekleri yok). Açık bir izin listesine (örn. https://app.example.com) veya herhangi bir kaynağa izin vermek için * olarak ayarlayın.(boş)
ALLOWED_HOSTSKabul edilecek ek Host başlık değerleri (virgülle ayrılmış). PORT üzerindeki geri döngü ana bilgisayarlarına her zaman izin verilir. 0.0.0.0 öğesine bağlanırken genel ana bilgisayar adını ekleyin.(yalnızca geri döngü)

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

Sunucu http://localhost:8080/mcp adresinde erişilebilir olacaktır.

Kullanılabilir Araçlar

perplexity_search

Arama sonuçları, mevcut olduğunda yayın ve son güncelleme tarihlerini içerir. Eksik veya boş tarihler biçimlendirilmiş çıktıdan çıkarılır.

Perplexity Search API kullanan doğrudan web araması. Güncel bilgileri bulmak için mükemmel olan meta verilerle sıralanmış arama sonuçları döndürür. Güncellik filtrelerini (search_recency_filter), alan kısıtlamalarını (search_domain_filter) ve daha düşük gecikme ve maliyet için Hızlı Arama (search_type: "fast") destekler.

perplexity_ask

Gerçek zamanlı web aramalı genel amaçlı konuşma yapay zekası, fast ön ayarıyla Agent API tarafından desteklenir. Hızlı sorular ve günlük aramalar için idealdir.

perplexity_research

high ön ayarıyla Agent API tarafından desteklenen derin, kapsamlı araştırma. Kapsamlı analiz ve ayrıntılı raporlar için idealdir. Çalıştırmalar dakikalar sürebilir; sunucu çalıştırmayı akış olarak iletir ve isteyen istemcilere ilerlemeyi bildirir.

perplexity_reason

medium ön ayarıyla Agent API tarafından desteklenen ileri düzey akıl yürütme ve problem çözme. Karmaşık analitik görevler için mükemmeldir.

perplexity_ask ve perplexity_reason isteğe bağlı pozitif tam sayı max_tokens (toplam arama bağlamı, en fazla 120.000) ve max_tokens_per_page (sonuç sayfası başına bağlam, en fazla 20.000) kabul eder. Bu Agent API bütçeleri, alınan arama içeriğini kontrol eder, üretilen yanıt uzunluğunu değil. Belirtilmediğinde, ön ayarın arama yapılandırması yürürlükte kalır.

Eski search_context_size bağımsız değişkeni hâlâ kabul edilir, ancak Agent API'ye gönderilmek yerine yerel olarak açık bütçelere çevrilir:

Eski boyutToplam belirteçSayfa başına belirteç
low2000512
medium40001024
high80002048

Bu uyumluluk politikası, Sonar'ın adlandırılmış boyutlarının tam bir karşılığı değildir; Agent API geçiş kılavuzunda adlandırılmış boyut karşılığı yoktur. Her açık bütçe, karşılık gelen eski varsayılanı geçersiz kılar.

[!NOT] Ön ayarlar, Perplexity'nin zaman içinde ayarlı tuttuğu yönetilen yapılandırmalardır (model, arama kurulumu, adım bütçesi); ön ayarlar kılavuzuna bakın. Bu sunucunun önceki sürümleri eski sonar-pro, sonar-reasoning-pro ve sonar-deep-research modellerini çağırıyor ve strip_thinking / reasoning_effort parametrelerini kabul ediyordu. Bu parametreler artık araç şemalarının parçası değildir ve gönderilirse yok sayılır; Agent API <think> etiketleri üretmez.

Kitaplık Olarak Kullanım

Paket ayrıca kendi Node sürecinize gömmek için sunucu fabrikasını da dışa aktarır:

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,
});

Döndürülen sunucuyu herhangi bir MCP taşıyıcısına (stdio, akışlı HTTP, bellek içi) bağlayın.

Sorun Giderme

  • API Anahtarı Sorunları: PERPLEXITY_API_KEY öğesinin doğru ayarlandığından emin olun
  • Bağlantı Hataları: İnternet bağlantınızı ve API anahtarı geçerliliğini kontrol edin
  • Araç Bulunamadı: Paketin kurulu olduğundan ve komut yolunun doğru olduğundan emin olun
  • Zaman Aşımı Hataları: Çok uzun araştırma sorguları için PERPLEXITY_TIMEOUT_MS öğesini daha yüksek bir değere ayarlayın
  • Proxy Sorunları: PERPLEXITY_PROXY veya HTTPS_PROXY kurulumunuzu doğrulayın ve api.perplexity.ai öğesinin güvenlik duvarınız tarafından engellenmediğinden emin olun.
  • EOF / Başlatma Hataları: Bazı katı MCP istemcileri, npx kurulum mesajlarını stdout'a yazdığı için başarısız olur. Bu çıktıyı bastırmak için npx -y yerine npx -yq kullanın.

Destek için community.perplexity.ai adresini ziyaret edin veya bir sorun bildirin.