Perplexity API-Plattform MCP-Server

Die offizielle MCP-Server-Implementierung für die Perplexity API-Plattform, die KI-Assistenten durch Sonar-Modelle und die Search API mit Echtzeit-Websuche, Schlussfolgerungen und Recherchefähigkeiten ausstattet.

Verfügbare Tools

perplexity_search

Direkte Websuche über die Perplexity Search API. Liefert bewertete Suchergebnisse mit Metadaten, ideal zum Finden aktueller Informationen.

perplexity_ask

Allgemeine Konversations-KI mit Echtzeit-Websuche unter Verwendung des sonar-pro-Modells. Großartig für schnelle Fragen und alltägliche Suchanfragen.

perplexity_research

Tiefgreifende, umfassende Recherche unter Verwendung des sonar-deep-research-Modells. Ideal für gründliche Analysen und detaillierte Berichte.

perplexity_reason

Fortgeschrittene Schlussfolgerungen und Problemlösung unter Verwendung des sonar-reasoning-pro-Modells. Perfekt für komplexe analytische Aufgaben.

TIP

Als optionaler Parameter fürperplexity_reason und perplexity_research verfügbar: strip_thinking

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

Konfiguration

API-Schlüssel abrufen

Holen Sie sich Ihren Perplexity API-Schlüssel aus dem API-Portal
Ersetzen Sie your_key_here in den unten stehenden Konfigurationen durch Ihren API-Schlüssel
(Optional) Timeout festlegen: PERPLEXITY_TIMEOUT_MS=600000 (Standard: 5 Minuten)
(Optional) Benutzerdefinierte Basis-URL festlegen: PERPLEXITY_BASE_URL=https://your-custom-url.com (Standard: https://api.perplexity.ai)
(Optional) Log-Level festlegen: 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 über denselben mcpServers-Wrapper in ihrer Client-Konfiguration konfiguriert werden (wie für Cursor gezeigt). Wenn ein Client ein anderes Schema verwendet, prüfen Sie dessen Dokumentation für das genaue Wrapper-Format.

Für die manuelle Einrichtung verwenden diese Clients alle 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 am Arbeitsplatz 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 abrufen

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 festlegen

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

Wenn Ihr Proxy einen Benutzernamen und ein Passwort erfordert, verwenden Sie:

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

3. Alternative: Standard-Umgebungsvariablen

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

NOTE

Der Server prüft die Proxy-Einstellungen in dieser Reihenfolge:PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Wenn keine festgelegt 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 Shared-Deployments führen Sie den Server im HTTP-Modus aus.

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`	Zu bindende Netzwerkschnittstelle	`0.0.0.0`
`ALLOWED_ORIGINS`	CORS-Ursprünge (durch Kommas getrennt)	`*`

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: Stellen Sie sicher, dass PERPLEXITY_API_KEY korrekt festgelegt ist
Verbindungsfehler: Überprüfen Sie Ihre Internetverbindung und die Gültigkeit des API-Schlüssels
Tool nicht gefunden: Stellen Sie sicher, dass das Paket installiert ist und der Befehlspfad korrekt ist
Timeout-Fehler: Setzen Sie bei sehr langen Rechercheanfragen PERPLEXITY_TIMEOUT_MS auf einen höheren Wert
Proxy-Probleme: Überprüfen Sie Ihre PERPLEXITY_PROXY- oder HTTPS_PROXY-Einrichtung und stellen Sie sicher, dass api.perplexity.ai nicht durch Ihre 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.

Perplexity API MCP Server