Perplexity Ask MCP Server

Perplexity API Platform MCP Sunucusu

     

Perplexity API Platform için resmi MCP sunucu uygulaması; Sonar modelleri ve Arama API'si aracılığıyla yapay zeka asistanlarına gerçek zamanlı web araması, akıl yürütme ve araştırma yetenekleri sağlar.

Kullanılabilir Araçlar

perplexity_search

Perplexity Arama API'sini kullanarak doğrudan web araması. Güncel bilgileri bulmak için ideal, sıralanmış arama sonuçlarını meta verilerle birlikte döndürür.

perplexity_ask

sonar-pro modelini kullanan, gerçek zamanlı web aramasına sahip genel amaçlı konuşma yapay zekası. Hızlı sorular ve günlük aramalar için harikadır.

perplexity_research

sonar-deep-research modelini kullanan derin, kapsamlı araştırma. Kapsamlı analiz ve ayrıntılı raporlar için idealdir.

perplexity_reason

sonar-reasoning-pro modelini kullanan gelişmiş akıl yürütme ve problem çözme. Karmaşık analitik görevler için mükemmeldir.

[!TIP] perplexity_reason ve perplexity_research için isteğe bağlı bir parametre olarak kullanılabilir: strip_thinking

Yanıttan <think>...</think> etiketlerini kaldırmak ve bağlam token'larından tasarruf etmek için true olarak ayarlayın. Varsayılan: false

Yapılandırma

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 kısmını API anahtarınızla değiştirin
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 seviyesini 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 yükleyin:

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

Cursor, Claude Desktop, Kiro, Windsurf ve VS Code

Çoğu istemci, istemci yapılandırmalarında aynı mcpServers sarmalayıcısı kullanılarak 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:

İstemci	Yapılandırma Dosyası
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"
      }
    }
  }
}

Proxy Kurulumu (Kurumsal Ağlar İçin)

Bu sunucuyu iş yerinde çalıştırıyorsanız—özellikle bir şirket güvenlik duvarı veya proxy arkasındaysanı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 portunuzu isteyin.
• Ayrıca bir kullanıcı adı ve parolaya ihtiyacınız olabilir.

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 bir kullanıcı adı ve parola 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'i destekliyoruz.

[!NOTE] 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 portlar 8080, 3128 ve 80'dir.

HTTP Sunucu Dağıtımı

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

Ortam Değişkenleri

Değişken	Açıklama	Varsayılan
PERPLEXITY_API_KEY	Perplexity API anahtarınız	Gerekli
PERPLEXITY_BASE_URL	API istekleri için özel temel URL	https://api.perplexity.ai
PORT	HTTP sunucu portu	8080
BIND_ADDRESS	Bağlanılacak ağ arayüzü. Varsayılan olarak geri döngü. Tüm arayüzlere açmak için 0.0.0.0 olarak ayarlayın.	127.0.0.1
ALLOWED_ORIGINS	CORS kaynakları (virgülle ayrılmış). Varsayılan olarak boş (çapraz kaynak tarayıcı isteği 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_HOSTS	Kabul 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'e 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

Sunucuya http://localhost:8080/mcp adresinden erişilebilir olacaktır

Sorun Giderme

• API Anahtarı Sorunları: PERPLEXITY_API_KEY'in 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'i daha yüksek bir değere ayarlayın
• Proxy Sorunları: PERPLEXITY_PROXY veya HTTPS_PROXY kurulumunuzu doğrulayın ve api.perplexity.ai'in 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.

---