Perplexity API Platform MCP Server

Ovo je zvanična MCP server implementacija za Perplexity API platformu. Daje AI asistentima mogućnost pretrage weba u realnom vremenu, zaključivanja i istraživanja putem Sonar modela i Search API-ja.

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

Paket je dostupan na npm-u: @perplexity-ai/mcp-server

---

Dostupni alati

perplexity_search

Direktna pretraga weba putem Perplexity Search API-ja. Vraća rangirane rezultate pretrage sa metapodacima. Idealno za pronalaženje aktuelnih informacija.

perplexity_ask

Konverzacioni AI opšte namene sa pretragom weba u realnom vremenu, koristi model sonar-pro. Odlično za brza pitanja i svakodnevne pretrage.

perplexity_research

Dubinsko, sveobuhvatno istraživanje korišćenjem modela sonar-deep-research. Idealno za temeljnu analizu i detaljne izveštaje.

perplexity_reason

Napredno zaključivanje i rešavanje problema putem modela sonar-reasoning-pro. Savršeno za složene analitičke zadatke.

TIP: Opcioni parametar dostupan za perplexity_reason i perplexity_research: strip_thinking
Postavi na true da ukloniš <think>...</think> tagove iz odgovora i uštediš context tokene. Default: false

---

Konfiguracija

Nabavka API ključa

1. Nabavi Perplexity API ključ na API Portalu
2. Zameni your_key_here u konfiguracijama ispod sa svojim ključem
3. (Opciono) Podesi timeout: PERPLEXITY_TIMEOUT_MS=600000 (default: 5 minuta)
4. (Opciono) Podesi custom base URL: PERPLEXITY_BASE_URL=https://your-custom-url.com
5. (Opciono) Podesi log level: 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

Ili instaliraj putem plugina:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Zatim pokreni: /plugin marketplace add perplexityai/modelcontextprotocol
# Zatim pokreni: /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 i VS Code

Većina klijenata se može ručno konfigurisati koristeći isti mcpServers wrapper u konfiguracionom fajlu. Ako klijent ima drugačiju šemu, proveri njegovu dokumentaciju.

Klijent	Konfiguracioni fajl
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 podešavanja (korporativne mreže)

Ako server koristiš na poslu – posebno iza korporativnog firewall-a ili proxy-ja – možda ćeš morati da mu kažeš kako da usmerava internet saobraćaj.

1. Nabavi proxy detalje

Pitaj IT odeljenje za HTTPS proxy adresu i port. Možda će ti trebati i korisničko ime i lozinka.

2. Podesi proxy promenljivu okruženja

Najlakši način za Perplexity MCP je PERPLEXITY_PROXY:

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

Ako proxy zahteva autentifikaciju:

export PERPLEXITY_PROXY=https://korisnik:lozinka@your-proxy-host:8080

3. Alternativa: standardne env varijable

Podržane su i HTTPS_PROXY i HTTP_PROXY promenljive.

NAPOMENA: Server proverava proxy podešavanja ovim redom: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Ako ništa nije podešeno, direktno se povezuje na internet.
URL mora počinjati sa https://. Uobičajeni portovi su 8080, 3128 i 80.

---

HTTP Server Deployment

Za cloud ili deljene deployment scenarije, pokreni server u HTTP modu.

Promenljive okruženja

Promenljiva	Opis	Default
PERPLEXITY_API_KEY	Tvoj Perplexity API ključ	Obavezno
PERPLEXITY_BASE_URL	Custom base URL za API zahteve	https://api.perplexity.ai
PORT	HTTP server port	8080
BIND_ADDRESS	Network interface za vezivanje	0.0.0.0
ALLOWED_ORIGINS	CORS origins (odvojeni zarezom)	*

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 će biti dostupan na http://localhost:8080/mcp

---

Rešavanje problema

• API Key problemi: Proveri da li je PERPLEXITY_API_KEY ispravno postavljen
• Greške pri konekciji: Proveri internet konekciju i validnost API ključa
• Alat nije pronađen: Proveri da li je paket instaliran i da li je putanja komande ispravna
• Timeout greške: Za dugačke research upite, postavi PERPLEXITY_TIMEOUT_MS na veću vrednost
• Proxy problemi: Proveri PERPLEXITY_PROXY ili HTTPS_PROXY podešavanja i da li api.perplexity.ai nije blokiran firewall-om
• EOF / Initialize greške: Neki strogi MCP klijenti pucaju jer npx piše poruke instalacije na stdout. Koristi npx -yq umesto npx -y da suzbije ovaj output

Za podršku, poseti community.perplexity.ai ili prijavi problem na GitHub-u.