Perplexity Ask MCP Server

officiel

Un connecteur pour l'API Perplexity permettant d'effectuer des recherches web dans l'écosystème MCP.

Que pouvez-vous faire avec Perplexity Ask MCP ?

  • Recherche web en temps réel — Demandez des résultats de recherche actuels et classés avec des filtres de fraîcheur, des restrictions de domaine ou un mode rapide via perplexity_search.
  • Questions-réponses conversationnelles — Obtenez des réponses rapides et fondées sur le web aux questions courantes à l’aide de l’outil perplexity_ask.
  • Rapports de recherche approfondie — Demandez une analyse complète et multi-étapes pour des investigations approfondies via perplexity_research.
  • Raisonnement avancé — Résolvez des problèmes analytiques complexes avec une résolution pas à pas via perplexity_reason.
  • Profondeur de recherche personnalisable — Contrôlez le contexte de recherche récupéré en définissant les budgets max_tokens et max_tokens_per_page pour les outils ask et reason.

Documentation

Serveur MCP de la plateforme API Perplexity

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

L'implémentation officielle du serveur MCP pour la plateforme API Perplexity, offrant aux assistants IA des capacités de recherche web en temps réel, de raisonnement et de recherche approfondie via l'Agent API et la Search API.

Serveur MCP distant

Le serveur MCP distant est hébergé par Perplexity et constitue le moyen le plus simple de démarrer : mêmes outils, rien à installer ni à mettre à jour. Les boutons Cursor et VS Code en haut de cette page s'y connectent en un clic. Si votre client MCP ne prend pas encore en charge les serveurs distants, passez à la configuration du serveur local ci-dessous. Connectez-vous via Streamable HTTP avec votre clé API Perplexity :

https://api.perplexity.ai/mcp

Pour Claude Code :

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

Consultez la documentation d'intégration MCP pour la configuration manuelle de Cursor/VS Code, l'utilisation depuis l'API Anthropic et la configuration pour d'autres clients.

Serveur MCP local

Obtenir votre clé API

  1. Obtenez votre clé API Perplexity depuis le Portail API
  2. Remplacez your_key_here dans les configurations ci-dessous par votre clé API
  3. (Optionnel) Définissez le délai d'expiration : PERPLEXITY_TIMEOUT_MS=600000 (défaut : 5 minutes)
  4. (Optionnel) Définissez une URL de base personnalisée : PERPLEXITY_BASE_URL=https://your-custom-url.com (défaut : https://api.perplexity.ai)
  5. (Optionnel) Définissez le niveau de journalisation : PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (défaut : ERROR)

Claude Code

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

Ou installez via le plugin :

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

Plugins d'agent

Ce dépôt est empaqueté comme un Agent Plugin, de sorte que les clients prenant en charge la norme peuvent l'installer directement depuis ce dépôt. Le format Agent Plugins ne transporte pas de secrets, définissez donc la variable d'environnement PERPLEXITY_API_KEY via les paramètres de plugin ou MCP de votre client.

Autres clients MCP

La plupart des clients peuvent être configurés manuellement en utilisant le même wrapper mcpServers dans leur configuration client (comme illustré pour Cursor). Si un client a un schéma différent, consultez sa documentation pour connaître le format exact du wrapper.

Pour une configuration manuelle, ces clients utilisent tous la même structure mcpServers :

ClientFichier de configuration
Cursor~/.cursor/mcp.json
Claude Desktopclaude_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"
      }
    }
  }
}

Configuration du proxy (pour les réseaux d'entreprise)

Si vous exécutez ce serveur au travail—en particulier derrière un pare-feu ou un proxy d'entreprise—vous devrez peut-être indiquer au programme comment acheminer son trafic internet via le proxy de votre réseau. Suivez ces étapes :

1. Obtenez les détails de votre proxy

  • Demandez à votre service informatique l'adresse et le port de votre proxy HTTPS.
  • Vous aurez peut-être aussi besoin d'un nom d'utilisateur et d'un mot de passe.

2. Définissez la variable d'environnement du proxy

Le moyen le plus simple et le plus fiable pour Perplexity MCP est d'utiliser PERPLEXITY_PROXY. Par exemple :

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

Si votre proxy nécessite un nom d'utilisateur et un mot de passe, utilisez :

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

3. Alternative : variables d'environnement standard

Si vous préférez utiliser les variables standard, nous prenons en charge HTTPS_PROXY et HTTP_PROXY.

[!NOTE] Le serveur vérifie les paramètres de proxy dans cet ordre : PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Si aucun n'est défini, il se connecte directement à internet. Les URL doivent inclure https://. Les ports typiques sont 8080, 3128 et 80.

Mode HTTP auto-hébergé

Pour les déploiements cloud ou partagés, exécutez le serveur en mode HTTP.

Variables d'environnement

VariableDescriptionDéfaut
PERPLEXITY_API_KEYVotre clé API PerplexityRequis
PERPLEXITY_BASE_URLURL de base personnalisée pour les requêtes APIhttps://api.perplexity.ai
PORTPort du serveur HTTP8080
BIND_ADDRESSInterface réseau à laquelle se lier. Par défaut, bouclage. Définissez sur 0.0.0.0 pour exposer sur toutes les interfaces.127.0.0.1
ALLOWED_ORIGINSOrigines CORS (séparées par des virgules). Par défaut vide (aucune requête navigateur inter-origine). Définissez une liste d'autorisation explicite (par ex. https://app.example.com) ou * pour autoriser toute origine.(vide)
ALLOWED_HOSTSValeurs d'en-tête Host supplémentaires à accepter (séparées par des virgules). Les hôtes de bouclage sur PORT sont toujours autorisés. Ajoutez le nom d'hôte public lors de la liaison à 0.0.0.0.(bouclage uniquement)

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

Le serveur sera accessible à http://localhost:8080/mcp

Outils disponibles

perplexity_search

Les résultats de recherche incluent les dates de publication et de dernière mise à jour lorsqu'elles sont disponibles. Les dates manquantes ou nulles sont omises de la sortie formatée.

Recherche web directe utilisant la Search API Perplexity. Renvoie des résultats de recherche classés avec métadonnées, parfaits pour trouver des informations actuelles. Prend en charge les filtres de récence (search_recency_filter), les restrictions de domaine (search_domain_filter) et la Fast Search (search_type: "fast") pour une latence et un coût réduits.

perplexity_ask

IA conversationnelle polyvalente avec recherche web en temps réel, propulsée par le préréglage Agent API fast. Idéale pour les questions rapides et les recherches quotidiennes.

perplexity_research

Recherche approfondie et complète propulsée par le préréglage Agent API high. Idéale pour une analyse approfondie et des rapports détaillés. Les exécutions peuvent prendre plusieurs minutes ; le serveur diffuse l'exécution et signale la progression aux clients qui le demandent.

perplexity_reason

Raisonnement avancé et résolution de problèmes propulsés par le préréglage Agent API medium. Parfait pour les tâches analytiques complexes.

perplexity_ask et perplexity_reason acceptent un max_tokens optionnel en entier positif (contexte de recherche total, jusqu'à 120 000) et max_tokens_per_page (contexte par page de résultats, jusqu'à 20 000). Ces budgets Agent API contrôlent le contenu de recherche récupéré, pas la longueur de la réponse générée. Lorsqu'ils sont omis, la configuration de recherche du préréglage reste en vigueur.

L'argument hérité search_context_size est toujours accepté, mais est traduit localement en budgets explicites plutôt qu'envoyé à l'Agent API :

Taille héritéeTotal de jetonsJetons par page
low2000512
medium40001024
high80002048

Cette politique de compatibilité n'est pas un équivalent exact des tailles nommées de Sonar ; le guide de migration Agent API n'a pas d'équivalent de taille nommée. Chaque budget explicite remplace son défaut hérité correspondant.

[!NOTE] Les préréglages sont des configurations gérées (modèle, configuration de recherche, budget d'étapes) que Perplexity maintient optimisées au fil du temps ; voir le guide des préréglages. Les versions antérieures de ce serveur appelaient les modèles hérités sonar-pro, sonar-reasoning-pro et sonar-deep-research et acceptaient les paramètres strip_thinking / reasoning_effort. Ces paramètres ne font plus partie des schémas d'outils et sont ignorés s'ils sont envoyés ; l'Agent API ne produit pas de balises <think>.

Utilisation comme bibliothèque

Le package exporte également la fabrique de serveur pour l'intégration dans votre propre processus Node :

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

Montez le serveur renvoyé sur n'importe quel transport MCP (stdio, HTTP streamable, en mémoire).

Dépannage

  • Problèmes de clé API : Assurez-vous que PERPLEXITY_API_KEY est défini correctement
  • Erreurs de connexion : Vérifiez votre connexion internet et la validité de votre clé API
  • Outil introuvable : Assurez-vous que le package est installé et que le chemin de commande est correct
  • Erreurs de délai d'expiration : Pour les requêtes de recherche très longues, définissez PERPLEXITY_TIMEOUT_MS sur une valeur plus élevée
  • Problèmes de proxy : Vérifiez votre configuration PERPLEXITY_PROXY ou HTTPS_PROXY et assurez-vous que api.perplexity.ai n'est pas bloqué par votre pare-feu.
  • Erreurs EOF / d'initialisation : Certains clients MCP stricts échouent car npx écrit des messages d'installation sur stdout. Utilisez npx -yq au lieu de npx -y pour supprimer cette sortie.

Pour obtenir de l'aide, visitez community.perplexity.ai ou signalez un problème.