Perplexity Ask MCP Server
resmiMCP 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_searchile 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_askaracını kullanarak günlük sorulara hızlı, web destekli yanıtlar alın. - Derin araştırma raporları —
perplexity_researchile kapsamlı, çok adımlı analizler gerektiren detaylı incelemeler talep edin. - İleri düzey akıl yürütme —
perplexity_reasonile adım adım problem çözme yöntemini kullanarak karmaşık analitik sorunların üstesinden gelin. - Özelleştirilebilir arama derinliği —
askvereasonaraçları içinmax_tokensvemax_tokens_per_pagebütçelerini ayarlayarak alınan arama bağlamını kontrol edin.
Dokümantasyon
Perplexity API Platform MCP Sunucusu
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
- Perplexity API Anahtarınızı API Portalından alın
- Aşağıdaki yapılandırmalarda
your_key_hereyerine API anahtarınızı yazın - (İsteğe bağlı) Zaman aşımını ayarlayın:
PERPLEXITY_TIMEOUT_MS=600000(varsayılan: 5 dakika) - (İsteğe bağlı) Özel temel URL ayarlayın:
PERPLEXITY_BASE_URL=https://your-custom-url.com(varsayılan: https://api.perplexity.ai) - (İ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:
| İ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—ö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'lerhttps://içermelidir. Tipik bağlantı noktaları8080,3128ve80'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şken | Açıklama | Varsayılan |
|---|---|---|
PERPLEXITY_API_KEY | Perplexity API anahtarınız | Zorunlu |
PERPLEXITY_BASE_URL | API istekleri için özel temel URL | https://api.perplexity.ai |
PORT | HTTP sunucu bağlantı noktası | 8080 |
BIND_ADDRESS | Bağ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_ORIGINS | CORS 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_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 öğ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 boyut | Toplam belirteç | Sayfa başına belirteç |
|---|---|---|
low | 2000 | 512 |
medium | 4000 | 1024 |
high | 8000 | 2048 |
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-provesonar-deep-researchmodellerini çağırıyor vestrip_thinking/reasoning_effortparametrelerini 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_PROXYveyaHTTPS_PROXYkurulumunuzu doğrulayın veapi.perplexity.aiöğesinin güvenlik duvarınız tarafından engellenmediğinden emin olun. - EOF / Başlatma Hataları: Bazı katı MCP istemcileri,
npxkurulum mesajlarını stdout'a yazdığı için başarısız olur. Bu çıktıyı bastırmak içinnpx -yyerinenpx -yqkullanın.
Destek için community.perplexity.ai adresini ziyaret edin veya bir sorun bildirin.