Perplexity MCP Server

resmi

Server MCP yang terhubung ke API Sonar milik Perplexity, memungkinkan riset web secara real-time dalam AI percakapan.

Dokumentasi

Server MCP Platform API Perplexity

Implementasi server MCP resmi untuk Platform API Perplexity, menyediakan asisten AI dengan pencarian web waktu nyata, penalaran, dan kemampuan riset melalui model Sonar dan Search API.

Alat yang Tersedia

perplexity_search

Pencarian web langsung menggunakan Perplexity Search API. Mengembalikan hasil pencarian berperingkat dengan metadata, sempurna untuk menemukan informasi terkini.

perplexity_ask

AI percakapan serbaguna dengan pencarian web waktu nyata menggunakan model sonar-pro. Cocok untuk pertanyaan cepat dan pencarian sehari-hari.

perplexity_research

Riset mendalam dan komprehensif menggunakan model sonar-deep-research. Ideal untuk analisis menyeluruh dan laporan terperinci.

perplexity_reason

Penalaran dan pemecahan masalah tingkat lanjut menggunakan model sonar-reasoning-pro. Sempurna untuk tugas analitis yang kompleks.

[!TIP] Tersedia sebagai parameter opsional untuk perplexity_reason dan perplexity_research: strip_thinking

Atur ke true untuk menghapus tag <think>...</think> dari respons, menghemat token konteks. Default: false

Konfigurasi

Dapatkan Kunci API Anda

Dapatkan Kunci API Perplexity Anda dari Portal API
Ganti your_key_here dalam konfigurasi di bawah ini dengan kunci API Anda
(Opsional) Atur waktu tunggu: 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 level 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

Cursor, Claude Desktop, Kiro, Windsurf, dan VS Code

Sebagian besar klien dapat dikonfigurasi secara manual menggunakan pembungkus mcpServers yang sama di konfigurasi klien mereka (seperti yang ditunjukkan untuk Cursor). Jika klien memiliki skema yang berbeda, periksa dokumentasinya untuk format pembungkus yang tepat.

Untuk pengaturan manual, semua klien ini 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 Proxy (Untuk Jaringan Perusahaan)

Jika Anda menjalankan server ini di tempat kerja—terutama di belakang firewall atau proxy perusahaan—Anda mungkin perlu memberi tahu program cara mengirim lalu lintas internetnya melalui proxy jaringan Anda. Ikuti langkah-langkah berikut:

1. Dapatkan detail proxy Anda

Tanyakan kepada departemen TI Anda untuk alamat dan port proxy HTTPS Anda.
Anda mungkin juga memerlukan nama pengguna dan kata sandi.

2. Atur variabel lingkungan proxy

Cara termudah dan paling andal untuk Perplexity MCP adalah menggunakan PERPLEXITY_PROXY. Sebagai contoh:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Jika proxy 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.

[!NOTE] Server memeriksa pengaturan proxy dalam urutan ini: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Jika tidak ada yang diatur, ia terhubung langsung ke internet. URL harus menyertakan https://. Port umum adalah 8080, 3128, dan 80.

Deployment Server HTTP

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

Variabel Lingkungan

Variabel	Deskripsi	Default
`PERPLEXITY_API_KEY`	Kunci API Perplexity Anda	Diperlukan
`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`	Asal CORS (dipisahkan koma). Default kosong (tidak ada permintaan browser lintas asal). Atur ke daftar izin eksplisit (mis. `https://app.example.com`) atau ke `*` untuk mengizinkan asal mana 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

Pemecahan Masalah

Masalah Kunci API: Pastikan PERPLEXITY_API_KEY diatur dengan benar
Kesalahan Koneksi: Periksa koneksi internet Anda dan validitas kunci API
Alat Tidak Ditemukan: Pastikan paket terinstal dan jalur perintah benar
Kesalahan Waktu Tunggu: Untuk kueri riset yang sangat panjang, atur PERPLEXITY_TIMEOUT_MS ke nilai yang lebih tinggi
Masalah Proxy: 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.