Perplexity Ask MCP Server

Perplexity API Platform MCP Server

     

Die offizielle MCP-Server-Implementierung für die Perplexity API Platform, die KI-Assistenten Echtzeit-Websuche, Reasoning- und Recherchefunktionen über die Agent API und die Search API bereitstellt.

Remote-MCP-Server

Der Remote-MCP-Server wird von Perplexity gehostet und ist der einfachste Weg, um loszulegen: gleiche Tools, nichts zu installieren oder zu aktualisieren. Die Cursor- und VS-Code-Buttons oben auf dieser Seite verbinden sich mit einem Klick damit. Wenn Ihr MCP-Client Remote-Server noch nicht unterstützt, fahren Sie mit der lokalen Server-Einrichtung unten fort. Verbinden Sie sich über Streamable HTTP mit Ihrem Perplexity-API-Schlüssel:

https://api.perplexity.ai/mcp

Für Claude Code:

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

Siehe die MCP-Integrationsdokumentation für die manuelle Cursor/VS-Code-Konfiguration, die Nutzung über die Anthropic API und die Einrichtung für andere Clients.

Lokaler MCP-Server

API-Schlüssel abrufen

1. Holen Sie sich Ihren Perplexity-API-Schlüssel vom API-Portal
2. Ersetzen Sie your_key_here in den folgenden Konfigurationen durch Ihren API-Schlüssel
3. (Optional) Timeout festlegen: PERPLEXITY_TIMEOUT_MS=600000 (Standard: 5 Minuten)
4. (Optional) Benutzerdefinierte Basis-URL festlegen: PERPLEXITY_BASE_URL=https://your-custom-url.com (Standard: https://api.perplexity.ai)
5. (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 über 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

Andere MCP-Clients

Die meisten Clients können manuell mit demselben mcpServers-Wrapper in ihrer Client-Konfiguration konfiguriert werden (wie für Cursor gezeigt). Wenn 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 ausführen – 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 benötigt, 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 gesetzt sind, verbindet er sich direkt mit dem Internet. URLs müssen https:// enthalten. Typische Ports sind 8080, 3128 und 80.

Selbstgehosteter HTTP-Modus

Für Cloud- oder gemeinsame Bereitstellungen 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	Netzwerkschnittstelle, an die gebunden wird. Standardmäßig Loopback. Setzen Sie auf 0.0.0.0, um auf allen Schnittstellen verfügbar zu sein.	127.0.0.1
ALLOWED_ORIGINS	CORS-Ursprünge (kommagetrennt). Standardmäßig leer (keine Cross-Origin-Browseranfragen). Setzen Sie eine explizite Whitelist (z. B. https://app.example.com) oder *, um jeden Ursprung zuzulassen.	(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 Sie an 0.0.0.0 binden.	(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 erreichbar unter http://localhost:8080/mcp

Verfügbare Tools

perplexity_search

Direkte Websuche über die Perplexity Search API. Gibt sortierte Suchergebnisse mit Metadaten zurück – perfekt, um aktuelle Informationen zu finden. Unterstützt Aktualitätsfilter (search_recency_filter) und Domain-Einschränkungen (search_domain_filter).

perplexity_ask

Allzweck-Konversations-KI mit Echtzeit-Websuche, unterstützt durch die Agent API fast-Voreinstellung. Ideal für schnelle Fragen und alltägliche Suchen.

perplexity_research

Tiefgehende, umfassende Recherche, unterstützt durch die Agent API high-Voreinstellung. Ideal für gründliche Analysen und detaillierte Berichte. Läufe können Minuten dauern; der Server streamt den Lauf und meldet Fortschritte an Clients, die dies anfordern.

perplexity_reason

Fortschrittliches Reasoning und Problemlösung, unterstützt durch die Agent API medium-Voreinstellung. Perfekt für komplexe analytische Aufgaben.

[!NOTE] Voreinstellungen sind verwaltete Konfigurationen (Modell, Such-Setup, Schrittbudget), die Perplexity im Laufe der Zeit optimiert; siehe den Voreinstellungs-Leitfaden. Frühere Versionen dieses Servers nannten die veralteten sonar-pro-, sonar-reasoning-pro- und sonar-deep-research-Modelle und akzeptierten strip_thinking / reasoning_effort-Parameter. Diese Parameter sind nicht mehr Teil der Tool-Schemas und werden ignoriert, wenn sie gesendet werden; die Agent API erzeugt keine <think>-Tags.

Als Bibliothek verwenden

Das Paket exportiert auch die Server-Factory zum Einbetten in Ihren eigenen Node-Prozess:

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,
});

Mounten Sie den zurückgegebenen Server auf einem beliebigen MCP-Transport (stdio, streamable HTTP, In-Memory).

Fehlerbehebung

• API-Schlüssel-Probleme: Stellen Sie sicher, dass PERPLEXITY_API_KEY korrekt gesetzt 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 Befehlsweg korrekt ist
• Timeout-Fehler: Für sehr lange Rechercheanfragen setzen Sie 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 von Ihrer Firewall blockiert wird.
• EOF-/Initialisierungsfehler: Einige strenge MCP-Clients schlagen fehl, weil npx Installationsmeldungen auf stdout schreibt. Verwenden Sie npx -yq anstelle von npx -y, um diese Ausgabe zu unterdrücken.

Für Unterstützung besuchen Sie community.perplexity.ai oder melden Sie ein Problem.

---