L’essentiel pour utiliser Perplexity MCP, le serveur MCP officiel de Perplexity : recherche web, réponses sourcées, raisonnement et recherche approfondie depuis Claude Code ou Codex, facturés à l’usage sur l’API Perplexity.

Installation

# Serveur hébergé par Perplexity (recommandé) : connexion OAuth au premier /mcp
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp
 
# Même serveur hébergé, avec une clé d'API au lieu d'OAuth
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
 
# Serveur local (stdio) : la clé est lue dans l'environnement qui lance Claude Code
claude mcp add perplexity --env 'PERPLEXITY_API_KEY=${PERPLEXITY_API_KEY}' -- npx -y @perplexity-ai/mcp-server
 
# Codex, serveur local
codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
 
# Ou en plugin Claude Code
claude plugin marketplace add perplexityai/modelcontextprotocol
claude plugin install perplexity@perplexity-mcp-server

La clé d’API se crée dans le portail de l’API, qui demande un moyen de paiement. La connexion OAuth demande d’être administrateur d’une organisation API qui peut payer ; elle ne permet ni de créer des clés, ni de voir le solde.

Autres clients (Cursor, Claude Desktop, VS Code, Windsurf, Kiro) : même bloc mcpServers avec "command": "npx", "args": ["-y", "@perplexity-ai/mcp-server"] et la clé dans "env".

Outils MCP

L’agent les appelle lui-même ; les nommer dans la demande aide à choisir le bon.

OutilCe qu’il faitÀ demander par exemple
perplexity_searchRésultats classés (titre, URL, extrait, dates) via la Search API.« Avec Perplexity, trouve les sources officielles sur … »
perplexity_askRéponse rédigée et sourcée (preset fast de l’Agent API).« Demande à Perplexity quelle est la dernière version de … »
perplexity_reasonRaisonnement en plusieurs étapes (preset medium).« Compare les deux approches avec Perplexity. »
perplexity_researchRecherche approfondie avec citations (preset high), plusieurs minutes.« Lance une recherche approfondie Perplexity sur … »

Paramètres utiles

ParamètreOutilEffet
search_recency_filterperplexity_searchLimite aux sources récentes.
search_domain_filterperplexity_searchRestreint à certains domaines.
search_type: "fast"perplexity_searchRecherche plus rapide et moins chère (serveur local 1.3.0 ou plus).
max_tokensperplexity_ask, perplexity_reasonBudget total de contexte de recherche, jusqu’à 120 000.
max_tokens_per_pageperplexity_ask, perplexity_reasonBudget par page de résultats, jusqu’à 20 000.

Ces budgets règlent le contenu récupéré, pas la longueur de la réponse. L’ancien paramètre search_context_size (low, medium, high) est encore accepté et converti en budgets.

Variables d’environnement (serveur local)

VariableRôleDéfaut
PERPLEXITY_API_KEYClé d’API.Obligatoire
PERPLEXITY_TIMEOUT_MSDélai maximal d’une requête.300 000 (5 minutes)
PERPLEXITY_BASE_URLAdresse de l’API.https://api.perplexity.ai
PERPLEXITY_LOG_LEVELDEBUG, INFO, WARN ou ERROR.ERROR
PERPLEXITY_PROXYProxy d’entreprise, puis HTTPS_PROXY et HTTP_PROXY.Connexion directe

Auto-hébergement en HTTP

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Ou, depuis le dépôt cloné : npm install && npm run build && npm run start:http. Le serveur répond sur http://localhost:8080/mcp. Il n’écoute que l’interface locale (BIND_ADDRESS=127.0.0.1) ; pour l’ouvrir, régler aussi ALLOWED_HOSTS et ALLOWED_ORIGINS.

Coûts (au 15 novembre 2026)

AppelTarif
perplexity_search5 pour 1 000 requêtes ; 1 en mode fast.
perplexity_ask, perplexity_reason, perplexity_researchAgent API : jetons au tarif du modèle, plus des frais d’outils (recherche web : 2,50 pour 1 000 ; 1 en mode rapide).

Conseils d’utilisation

  • Choisir l’outil le moins cher qui suffit : perplexity_search pour des sources, perplexity_ask pour un fait, perplexity_reason pour une analyse, perplexity_research seulement pour un vrai dossier.
  • Relever les délais pour la recherche approfondie : PERPLEXITY_TIMEOUT_MS côté serveur, et le délai du client MCP, souvent de 60 secondes.
  • Erreurs EOF ou d’initialisation avec un client strict : remplacer npx -y par npx -yq.
  • Ne jamais écrire la clé dans un fichier versionné : utiliser une variable d’environnement, comme dans 'PERPLEXITY_API_KEY=${PERPLEXITY_API_KEY}'.
  • Vérifier les sources primaires : perplexity_ask, perplexity_reason et perplexity_research renvoient une synthèse.
  • Traiter le contenu web comme non fiable : une page peut contenir des consignes destinées à l’agent.

Sources