Perplexity Ask MCP Server
resmiKonektor untuk API Perplexity guna mengaktifkan pencarian web dalam ekosistem MCP.
Apa yang bisa Anda lakukan dengan Perplexity Ask MCP?
- Pencarian web real-time — Minta hasil pencarian terkini yang diberi peringkat dengan filter kebaruan, pembatasan domain, atau mode cepat melalui
perplexity_search. - Tanya jawab percakapan — Dapatkan jawaban cepat yang berbasis web untuk pertanyaan sehari-hari menggunakan alat
perplexity_ask. - Laporan riset mendalam — Minta analisis komprehensif multi-langkah untuk investigasi menyeluruh melalui
perplexity_research. - Penalaran tingkat lanjut — Tangani masalah analitis yang kompleks dengan pemecahan masalah langkah demi langkah melalui
perplexity_reason. - Kedalaman pencarian yang dapat disesuaikan — Kontrol konteks pencarian yang diambil dengan mengatur anggaran
max_tokensdanmax_tokens_per_pageuntuk alat tanya dan penalaran.
Dokumentasi
Server MCP Platform Perplexity API
Implementasi server MCP resmi untuk Platform API Perplexity, yang menyediakan asisten AI dengan pencarian web real-time, penalaran, dan kemampuan riset melalui Agent API dan Search API.
Server MCP Jarak Jauh
Server MCP jarak jauh dihosting oleh Perplexity dan merupakan cara termudah untuk memulai: alat yang sama, tanpa perlu menginstal atau memperbarui apa pun. Tombol Cursor dan VS Code di bagian atas halaman ini terhubung ke server tersebut dengan satu klik. Jika klien MCP Anda belum mendukung server jarak jauh, lanjutkan ke pengaturan server lokal di bawah. Hubungkan melalui Streamable HTTP dengan kunci API Perplexity Anda:
https://api.perplexity.ai/mcp
Untuk Claude Code:
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
Lihat dokumentasi integrasi MCP untuk konfigurasi manual Cursor/VS Code, penggunaan dari Anthropic API, dan pengaturan untuk klien lain.
Server MCP Lokal
Dapatkan Kunci API Anda
- Dapatkan Kunci API Perplexity Anda dari Portal API
- Ganti
your_key_heredalam konfigurasi di bawah dengan kunci API Anda - (Opsional) Atur batas waktu:
PERPLEXITY_TIMEOUT_MS=600000(default: 5 menit) - (Opsional) Atur URL dasar kustom:
PERPLEXITY_BASE_URL=https://your-custom-url.com(default: https://api.perplexity.ai) - (Opsional) Atur tingkat log:
PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR(default: ERROR)
Claude Code
claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
Atau instal melalui plugin:
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
Plugin Agen
Repositori ini dikemas sebagai Agent Plugin, sehingga klien yang mendukung standar tersebut dapat menginstalnya langsung dari repositori ini. Format Agent Plugins tidak membawa rahasia, jadi atur variabel lingkungan PERPLEXITY_API_KEY melalui pengaturan plugin atau MCP klien Anda.
Klien MCP Lainnya
Sebagian besar klien dapat dikonfigurasi secara manual menggunakan pembungkus mcpServers yang sama dalam konfigurasi klien mereka (seperti yang ditunjukkan untuk Cursor). Jika klien memiliki skema yang berbeda, periksa dokumentasinya untuk format pembungkus yang tepat.
Untuk pengaturan manual, klien-klien ini semuanya menggunakan struktur mcpServers yang sama:
| Klien | File Konfigurasi |
|---|---|
| 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"
}
}
}
}
Pengaturan Proksi (Untuk Jaringan Perusahaan)
Jika Anda menjalankan server ini di tempat kerja—terutama di belakang firewall atau proksi perusahaan—Anda mungkin perlu memberi tahu program cara mengirim lalu lintas internetnya melalui proksi jaringan Anda. Ikuti langkah-langkah berikut:
1. Dapatkan detail proksi Anda
- Tanyakan kepada departemen IT Anda untuk alamat dan port proksi HTTPS Anda.
- Anda mungkin juga memerlukan nama pengguna dan kata sandi.
2. Atur variabel lingkungan proksi
Cara termudah dan paling andal untuk Perplexity MCP adalah menggunakan PERPLEXITY_PROXY. Contohnya:
export PERPLEXITY_PROXY=https://your-proxy-host:8080
Jika proksi Anda memerlukan nama pengguna dan kata sandi, gunakan:
export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080
3. Alternatif: Variabel lingkungan standar
Jika Anda lebih suka menggunakan variabel standar, kami mendukung HTTPS_PROXY dan HTTP_PROXY.
[!CATATAN] Server memeriksa pengaturan proksi dalam urutan ini:
PERPLEXITY_PROXY→HTTPS_PROXY→HTTP_PROXY. Jika tidak ada yang diatur, server terhubung langsung ke internet. URL harus menyertakanhttps://. Port umum adalah8080,3128, dan80.
Mode HTTP Hosting Mandiri
Untuk deployment cloud atau bersama, jalankan server dalam mode HTTP.
Variabel Lingkungan
| Variabel | Deskripsi | Default |
|---|---|---|
PERPLEXITY_API_KEY | Kunci API Perplexity Anda | Wajib |
PERPLEXITY_BASE_URL | URL dasar kustom untuk permintaan API | https://api.perplexity.ai |
PORT | Port server HTTP | 8080 |
BIND_ADDRESS | Antarmuka jaringan untuk diikat. Default ke loopback. Atur ke 0.0.0.0 untuk mengekspos di semua antarmuka. | 127.0.0.1 |
ALLOWED_ORIGINS | Origin CORS (dipisahkan koma). Default kosong (tanpa permintaan browser lintas-origin). Atur ke daftar izin eksplisit (mis. https://app.example.com) atau ke * untuk mengizinkan origin apa pun. | (kosong) |
ALLOWED_HOSTS | Nilai header Host tambahan untuk diterima (dipisahkan koma). Host loopback di PORT selalu diizinkan. Tambahkan nama host publik saat mengikat ke 0.0.0.0. | (hanya loopback) |
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
Server akan dapat diakses di http://localhost:8080/mcp
Alat yang Tersedia
perplexity_search
Hasil pencarian menyertakan tanggal publikasi dan pembaruan terakhir jika tersedia. Tanggal yang hilang atau null dihilangkan dari output yang diformat.
Pencarian web langsung menggunakan Perplexity Search API. Mengembalikan hasil pencarian berperingkat dengan metadata, sempurna untuk menemukan informasi terkini. Mendukung filter kebaruan (search_recency_filter), pembatasan domain (search_domain_filter), dan Fast Search (search_type: "fast") untuk latensi dan biaya yang lebih rendah.
perplexity_ask
AI percakapan serbaguna dengan pencarian web real-time, didukung oleh preset Agent API fast. Cocok untuk pertanyaan cepat dan pencarian sehari-hari.
perplexity_research
Riset mendalam dan komprehensif didukung oleh preset Agent API high. Ideal untuk analisis menyeluruh dan laporan terperinci. Proses dapat memakan waktu beberapa menit; server melakukan streaming proses dan melaporkan kemajuan ke klien yang memintanya.
perplexity_reason
Penalaran lanjutan dan pemecahan masalah didukung oleh preset Agent API medium. Sempurna untuk tugas analitis yang kompleks.
perplexity_ask dan perplexity_reason menerima max_tokens bilangan bulat positif opsional (total konteks pencarian, hingga 120.000) dan max_tokens_per_page (konteks per halaman hasil, hingga 20.000). Anggaran Agent API ini mengontrol konten pencarian yang diambil, bukan panjang jawaban yang dihasilkan. Jika dihilangkan, konfigurasi pencarian preset tetap berlaku.
Argumen lama search_context_size masih diterima, tetapi diterjemahkan secara lokal menjadi anggaran eksplisit daripada dikirim ke Agent API:
| Ukuran lama | Total token | Token per halaman |
|---|---|---|
low | 2000 | 512 |
medium | 4000 | 1024 |
high | 8000 | 2048 |
Kebijakan kompatibilitas ini bukan padanan yang tepat dari ukuran bernama Sonar; panduan migrasi Agent API tidak memiliki padanan ukuran bernama. Setiap anggaran eksplisit menggantikan default lama yang sesuai.
[!CATATAN] Preset adalah konfigurasi terkelola (model, pengaturan pencarian, anggaran langkah) yang terus disesuaikan oleh Perplexity dari waktu ke waktu; lihat panduan preset. Versi sebelumnya dari server ini memanggil model lama
sonar-pro,sonar-reasoning-pro, dansonar-deep-researchdan menerima parameterstrip_thinking/reasoning_effort. Parameter tersebut tidak lagi menjadi bagian dari skema alat dan diabaikan jika dikirim; Agent API tidak menghasilkan tag<think>.
Gunakan sebagai Pustaka
Paket ini juga mengekspor pabrik server untuk disematkan dalam proses Node Anda sendiri:
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,
});
Pasang server yang dikembalikan pada transport MCP apa pun (stdio, streamable HTTP, in-memory).
Pemecahan Masalah
- Masalah Kunci API: Pastikan
PERPLEXITY_API_KEYdiatur dengan benar - Kesalahan Koneksi: Periksa koneksi internet dan validitas kunci API Anda
- Alat Tidak Ditemukan: Pastikan paket terinstal dan jalur perintah benar
- Kesalahan Batas Waktu: Untuk kueri riset yang sangat panjang, atur
PERPLEXITY_TIMEOUT_MSke nilai yang lebih tinggi - Masalah Proksi: Verifikasi pengaturan
PERPLEXITY_PROXYatauHTTPS_PROXYAnda dan pastikanapi.perplexity.aitidak diblokir oleh firewall Anda. - Kesalahan EOF / Inisialisasi: Beberapa klien MCP yang ketat gagal karena
npxmenulis pesan instalasi ke stdout. Gunakannpx -yqalih-alihnpx -yuntuk menekan output ini.
Untuk dukungan, kunjungi community.perplexity.ai atau ajukan masalah.