Perplexity Ask MCP Server

Serveur MCP de la plateforme API Perplexity

     

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'API Agent et l'API Search.

Serveur MCP distant

Le serveur MCP distant est hébergé par Perplexity et constitue le moyen le plus simple de commencer : 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. (Facultatif) Définissez le délai d'expiration : PERPLEXITY_TIMEOUT_MS=600000 (par défaut : 5 minutes)
4. (Facultatif) Définissez une URL de base personnalisée : PERPLEXITY_BASE_URL=https://your-custom-url.com (par défaut : https://api.perplexity.ai)
5. (Facultatif) Définissez le niveau de journalisation : PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (par 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

Autres clients MCP

La plupart des clients peuvent être configurés manuellement en utilisant le même wrapper mcpServers dans leur fichier de configuration client (comme indiqué 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 :

Client	Fichier de configuration
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"
      }
    }
  }
}

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 envoyer 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 du 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

Variable	Description	Défaut
PERPLEXITY_API_KEY	Votre clé API Perplexity	Requis
PERPLEXITY_BASE_URL	URL de base personnalisée pour les requêtes API	https://api.perplexity.ai
PORT	Port du serveur HTTP	8080
BIND_ADDRESS	Interface réseau à laquelle se lier. Par défaut, boucle locale. Définissez sur 0.0.0.0 pour exposer sur toutes les interfaces.	127.0.0.1
ALLOWED_ORIGINS	Origines 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_HOSTS	Valeurs d'en-tête Host supplémentaires à accepter (séparées par des virgules). Les hôtes de boucle locale sur PORT sont toujours autorisés. Ajoutez le nom d'hôte public lors de la liaison à 0.0.0.0.	(boucle locale 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

Recherche web directe via l'API Search 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) et les restrictions de domaine (search_domain_filter).

perplexity_ask

IA conversationnelle à usage général avec recherche web en temps réel, propulsée par le préréglage fast de l'API Agent. Idéale pour les questions rapides et les recherches quotidiennes.

perplexity_research

Recherche approfondie et complète propulsée par le préréglage high de l'API Agent. Idéale pour les analyses approfondies et les 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 medium de l'API Agent. Parfait pour les tâches analytiques complexes.

[!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'API Agent ne produit aucune balise <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.

---