Perplexity Ask MCP Server

Perplexity API Platform MCP Sunucusu

     

Perplexity API Platformu 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ğlanmanızı sağlar. MCP istemciniz henüz uzak 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 bilgi almak üzere MCP entegrasyon belgelerine bakın.

Yerel MCP Sunucusu

API Anahtarınızı Alın

1. Perplexity API Anahtarınızı API Portalı üzerinden 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

Diğer MCP İstemcileri

Çoğu istemci, istemci yapılandırmaları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, programın internet trafiğini ağınızın proxy'si üzerinden nasıl göndereceğini belirtmeniz gerekebilir. Şu adımları izleyin:

1. Proxy bilgilerinizi alın

• BT departmanınızdan HTTPS proxy adresinizi ve bağlantı noktanızı isteyin.
• Ayrıca bir kullanıcı adı ve şifre 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 desteklenmektedir.

[!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 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ş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üdür. Tüm arayüzlerde kullanıma 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ştur (ç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 * değerine 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 değerine 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

Kullanılabilir Araçlar

perplexity_search

Perplexity Search API'yi 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) ve alan kısıtlamalarını (search_domain_filter) destekler.

perplexity_ask

Agent API fast ön ayarıyla desteklenen, gerçek zamanlı web aramalı genel amaçlı konuşma yapay zekası. Hızlı sorular ve günlük aramalar için harikadır.

perplexity_research

Agent API high ön ayarıyla 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

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

[!NOTE] Ö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 ayar 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 bir parçası değildir ve gönderilirse yok sayılır; Agent API <think> etiketleri üretmez.

Kitaplık Olarak Kullanım

Paket ayrıca sunucu fabrikasını kendi Node sürecinize gömmek için 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 değerinin doğru ayarlandığından emin olun
• Bağlantı Hataları: İnternet bağlantınızı ve API anahtarı geçerliliğinizi 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 değerini daha yüksek bir değere ayarlayın
• Proxy Sorunları: PERPLEXITY_PROXY veya HTTPS_PROXY kurulumunuzu doğrulayın ve api.perplexity.ai değerinin güvenlik duvarınız tarafından engellenmediğinden emin olun.
• EOF / Başlatma Hataları: Bazı katı MCP istemcileri, npx stdout'a kurulum mesajları yazdığı için başarısız olur. Bu çıktıyı bastırmak için npx -yq yerine npx -y kullanın.

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

---