Perplexity MCP Server

offiziell

An MCP server that connects to Perplexity's Sonar API, enabling real-time web-wide research in conversational AI.

Dokumentation

Perplexity API Platform MCP Server

Die offizielle MCP-Server-Implementierung für die Perplexity API Platform, die KI-Assistenten mit Echtzeit-Websuche, Reasoning- und Recherchefunktionen durch Sonar-Modelle und die Search API ausstattet.

Verfügbare Werkzeuge

perplexity_search

Direkte Websuche mit der Perplexity Search API. Liefert sortierte Suchergebnisse mit Metadaten, ideal zum Finden aktueller Informationen.

perplexity_ask

Allzweck-Konversations-KI mit Echtzeit-Websuche unter Verwendung des sonar-pro-Modells. Hervorragend für schnelle Fragen und alltägliche Suchen.

perplexity_research

Tiefgehende, umfassende Recherche mit dem sonar-deep-research-Modell. Ideal für gründliche Analysen und detaillierte Berichte.

perplexity_reason

Fortgeschrittenes Reasoning und Problemlösung mit dem sonar-reasoning-pro-Modell. Perfekt für komplexe analytische Aufgaben.

[!TIP] Verfügbar als optionaler Parameter für perplexity_reason und perplexity_research: strip_thinking

Auf true setzen, um <think>...</think>-Tags aus der Antwort zu entfernen und Kontext-Tokens zu sparen. Standard: false

Konfiguration

API-Schlüssel erhalten

Holen Sie sich Ihren Perplexity API-Schlüssel vom API-Portal
Ersetzen Sie your_key_here in den folgenden Konfigurationen durch Ihren API-Schlüssel
(Optional) Timeout setzen: PERPLEXITY_TIMEOUT_MS=600000 (Standard: 5 Minuten)
(Optional) Benutzerdefinierte Basis-URL setzen: PERPLEXITY_BASE_URL=https://your-custom-url.com (Standard: https://api.perplexity.ai)
(Optional) Log-Level setzen: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (Standard: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Oder per Plugin installieren:

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 und VS Code

Die meisten Clients können manuell mit demselben mcpServers-Wrapper in ihrer Client-Konfiguration konfiguriert werden (wie für Cursor gezeigt). Falls ein Client ein anderes Schema hat, prüfen Sie dessen Dokumentation für das genaue Wrapper-Format.

Für die manuelle Einrichtung verwenden alle diese Clients dieselbe mcpServers-Struktur:

Client	Konfigurationsdatei
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-Einrichtung (Für Unternehmensnetzwerke)

Wenn Sie diesen Server bei der Arbeit betreiben – insbesondere hinter einer Firmen-Firewall oder einem Proxy – müssen Sie dem Programm möglicherweise mitteilen, wie es seinen Internetverkehr über den Proxy Ihres Netzwerks senden soll. Befolgen Sie diese Schritte:

1. Proxy-Details ermitteln

Fragen Sie Ihre IT-Abteilung nach Ihrer HTTPS-Proxy-Adresse und dem Port.
Möglicherweise benötigen Sie auch einen Benutzernamen und ein Passwort.

2. Proxy-Umgebungsvariable setzen

Der einfachste und zuverlässigste Weg für Perplexity MCP ist die Verwendung von PERPLEXITY_PROXY. Zum Beispiel:

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

Falls Ihr Proxy einen Benutzernamen und ein Passwort benötigt, verwenden Sie:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Alternative: Standard-Umgebungsvariablen

Falls Sie lieber die Standardvariablen verwenden möchten, unterstützen wir HTTPS_PROXY und HTTP_PROXY.

[!NOTE] Der Server prüft Proxy-Einstellungen in dieser Reihenfolge: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Falls keine gesetzt sind, verbindet er sich direkt mit dem Internet. URLs müssen https:// enthalten. Typische Ports sind 8080, 3128 und 80.

HTTP-Server-Bereitstellung

Für Cloud- oder gemeinsam genutzte Bereitstellungen betreiben Sie den Server im HTTP-Modus.

Umgebungsvariablen

Variable	Beschreibung	Standard
`PERPLEXITY_API_KEY`	Ihr Perplexity API-Schlüssel	Erforderlich
`PERPLEXITY_BASE_URL`	Benutzerdefinierte Basis-URL für API-Anfragen	`https://api.perplexity.ai`
`PORT`	HTTP-Server-Port	`8080`
`BIND_ADDRESS`	Netzwerkschnittstelle, an die gebunden wird. Standardmäßig Loopback. Auf `0.0.0.0` setzen, um auf allen Schnittstellen verfügbar zu machen.	`127.0.0.1`
`ALLOWED_ORIGINS`	CORS-Ursprünge (kommagetrennt). Standardmäßig leer (keine browserübergreifenden Anfragen). Auf eine explizite Zulassungsliste (z. B. `https://app.example.com`) oder auf `*` setzen, um jeden Ursprung zu erlauben.	(leer)
`ALLOWED_HOSTS`	Zusätzliche `Host`-Header-Werte, die akzeptiert werden (kommagetrennt). Loopback-Hosts auf `PORT` sind immer erlaubt. Fügen Sie den öffentlichen Hostnamen hinzu, wenn an `0.0.0.0` gebunden wird.	(nur 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

Der Server ist unter http://localhost:8080/mcp erreichbar.

Fehlerbehebung

API-Schlüssel-Probleme: Sicherstellen, dass PERPLEXITY_API_KEY korrekt gesetzt ist
Verbindungsfehler: Internetverbindung und Gültigkeit des API-Schlüssels prüfen
Werkzeug nicht gefunden: Sicherstellen, dass das Paket installiert ist und der Befehlspfad korrekt ist
Timeout-Fehler: Für sehr lange Rechercheanfragen PERPLEXITY_TIMEOUT_MS auf einen höheren Wert setzen
Proxy-Probleme: PERPLEXITY_PROXY- oder HTTPS_PROXY-Einrichtung überprüfen und sicherstellen, dass api.perplexity.ai nicht von Ihrer Firewall blockiert wird.
EOF- / Initialisierungsfehler: Einige strikte MCP-Clients schlagen fehl, weil npx Installationsmeldungen nach stdout schreibt. Verwenden Sie npx -yq anstelle von npx -y, um diese Ausgabe zu unterdrücken.

Für Support besuchen Sie community.perplexity.ai oder erstellen Sie ein Issue.