Perplexity Ask MCP Server

resmi

Konektor 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_tokens dan max_tokens_per_page untuk alat tanya dan penalaran.

Dokumentasi

Server MCP Platform Perplexity API

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

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

  1. Dapatkan Kunci API Perplexity Anda dari Portal API
  2. Ganti your_key_here dalam konfigurasi di bawah dengan kunci API Anda
  3. (Opsional) Atur batas waktu: PERPLEXITY_TIMEOUT_MS=600000 (default: 5 menit)
  4. (Opsional) Atur URL dasar kustom: PERPLEXITY_BASE_URL=https://your-custom-url.com (default: https://api.perplexity.ai)
  5. (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:

KlienFile Konfigurasi
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"
      }
    }
  }
}

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 menyertakan https://. Port umum adalah 8080, 3128, dan 80.

Mode HTTP Hosting Mandiri

Untuk deployment cloud atau bersama, jalankan server dalam mode HTTP.

Variabel Lingkungan

VariabelDeskripsiDefault
PERPLEXITY_API_KEYKunci API Perplexity AndaWajib
PERPLEXITY_BASE_URLURL dasar kustom untuk permintaan APIhttps://api.perplexity.ai
PORTPort server HTTP8080
BIND_ADDRESSAntarmuka jaringan untuk diikat. Default ke loopback. Atur ke 0.0.0.0 untuk mengekspos di semua antarmuka.127.0.0.1
ALLOWED_ORIGINSOrigin 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_HOSTSNilai 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 lamaTotal tokenToken per halaman
low2000512
medium40001024
high80002048

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, dan sonar-deep-research dan menerima parameter strip_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_KEY diatur 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_MS ke nilai yang lebih tinggi
  • Masalah Proksi: Verifikasi pengaturan PERPLEXITY_PROXY atau HTTPS_PROXY Anda dan pastikan api.perplexity.ai tidak diblokir oleh firewall Anda.
  • Kesalahan EOF / Inisialisasi: Beberapa klien MCP yang ketat gagal karena npx menulis pesan instalasi ke stdout. Gunakan npx -yq alih-alih npx -y untuk menekan output ini.

Untuk dukungan, kunjungi community.perplexity.ai atau ajukan masalah.