Perplexity Ask MCP Server

Server MCP Platform API Perplexity

     

Implementasi server MCP resmi untuk Platform API Perplexity, menyediakan kemampuan pencarian web real-time, penalaran, dan riset bagi asisten AI 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 lainnya.

Server MCP Lokal

Dapatkan Kunci API Anda

1. Dapatkan Kunci API Perplexity Anda dari Portal API
2. Ganti your_key_here pada 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

Klien MCP Lainnya

Sebagian besar klien dapat dikonfigurasi secara manual menggunakan pembungkus mcpServers yang sama pada 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 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

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 pada 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

Pencarian web langsung menggunakan Perplexity Search API. Mengembalikan hasil pencarian berperingkat dengan metadata, sempurna untuk menemukan informasi terkini. Mendukung filter kebaruan (search_recency_filter) dan pembatasan domain (search_domain_filter).

perplexity_ask

AI percakapan serba guna dengan pencarian web real-time, didukung oleh preset Agent API fast. Sangat baik untuk pertanyaan cepat dan pencarian sehari-hari.

perplexity_research

Riset mendalam dan komprehensif yang didukung oleh preset Agent API high. Ideal untuk analisis menyeluruh dan laporan terperinci. Proses dapat memakan waktu beberapa menit; server mengalirkan proses dan melaporkan kemajuan ke klien yang memintanya.

perplexity_reason

Penalaran lanjutan dan pemecahan masalah yang didukung oleh preset Agent API medium. Sempurna untuk tugas analitis yang kompleks.

[!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 serta 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 Waktu Habis: 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 keluaran ini.

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

---