Ajouter Parallel Search MCP à un agent : recherche sans clé, lecture web et limites de coût

Parallel Search MCP peut être ajouté à un agent existant sans exploiter son propre moteur de recherche ni demander une API Key de recherche. Parallel fournit le endpoint Streamable HTTP https://search.parallel.ai/mcp, qui expose deux outils à l’agent : web_search et web_fetch.

Une configuration enregistrée ne prouve pas que l’intégration fonctionne. Il faut voir l’état de connexion, retrouver les deux outils, inspecter les appels réels dans la conversation et ouvrir les URL renvoyées. Les faits ci-dessous ont été vérifiés sur les pages officielles ouvertes le 11 octobre 2026 ; vos logs et pages de facturation restent la preuve finale.

Choisir d’abord le endpoint et le mode d’authentification

Objectif	Endpoint	Authentification	Usage conseillé
Tester recherche et lecture	https://search.parallel.ai/mcp	Aucune	Exploration légère avec des limites anonymes plus basses
Utiliser les crédits du compte et des limites supérieures	https://search.parallel.ai/mcp	Bearer API Key	Charge régulière ou de production
Laisser le client gérer la connexion navigateur	https://search.parallel.ai/mcp-oauth	OAuth ou Bearer API Key	Éviter une clé fixe dans une configuration partagée

Le endpoint /mcp n’annonce pas OAuth : un client compatible peut donc se connecter anonymement sans ouvrir le navigateur. /mcp-oauth exige une authentification et renvoie 401 aux requêtes anonymes. L’absence de fenêtre de connexion sur /mcp n’est pas un échec ; un 401 sur /mcp-oauth indique souvent que l’autorisation n’est pas terminée.

Séparer client, outil web et fournisseur de modèle

Une seule réponse peut emprunter trois connexions indépendantes :

1. Le client de l’agent gère la conversation, les permissions et le choix des outils.
2. Parallel Search MCP exécute web_search et web_fetch.
3. Le fournisseur de modèle effectue le raisonnement et compte les tokens d’entrée, de sortie et de résultats d’outils.

Ajouter MCP ne remplace pas le Base URL du modèle. Changer de fournisseur de modèle n’ajoute pas automatiquement la recherche web. Pour diagnostiquer, posez trois questions distinctes : le client est-il connecté au MCP, l’outil a-t-il réellement été appelé, et quel fournisseur a facturé la requête du modèle ?

Claude Code : commencer par le endpoint anonyme

Exécutez ces commandes dans le projet où vous utilisez Claude Code :

claude mcp add --transport http "Parallel-Search-MCP" https://search.parallel.ai/mcp
claude mcp get "Parallel-Search-MCP"
claude mcp list

Claude Code enregistre le serveur en local scope par défaut. Ajoutez --scope user uniquement si vous le voulez dans tous vos projets. Pour un .mcp.json partagé, relisez le fichier et n’y placez jamais de bearer token fixe.

Dans Claude Code, ouvrez le panneau :

/mcp

Le message Added indique seulement que la configuration a été écrite. Le signal utile est Connected, qui confirme que le client actuel atteint le serveur. Pour OAuth, utilisez plutôt :

https://search.parallel.ai/mcp-oauth

Terminez l’autorisation depuis /mcp. Ne mélangez pas les erreurs de /mcp et celles de /mcp-oauth.

Codex CLI : anonyme, bearer par variable ou OAuth

Configuration anonyme :

codex mcp add parallel-search --url https://search.parallel.ai/mcp
codex mcp list

Pour des limites liées au compte, stockez PARALLEL_API_KEY dans le système d’exploitation ou un gestionnaire de secrets. Donnez à Codex le nom de la variable, jamais la valeur réelle dans l’historique du shell ou un fichier partagé :

codex mcp add parallel-search --url https://search.parallel.ai/mcp \
  --bearer-token-env-var PARALLEL_API_KEY
codex mcp list

Avec OAuth :

codex mcp add parallel-search --url https://search.parallel.ai/mcp-oauth
codex mcp list

Démarrez une nouvelle session Codex après l’ajout. Les autres clients MCP peuvent utiliser le même endpoint, mais leur schéma varie : VS Code utilise l’objet supérieur servers, Cursor emploie souvent mcpServers, et certains demandent type: "streamable-http". Ne copiez pas le JSON d’un client dans un autre sans vérification.

Prouver quel outil a réellement été appelé

Un serveur connecté prouve seulement qu’il est joignable. Pour une réponse donnée, utilisez un prompt qui laisse des preuves observables :

Pour ce contrôle, utilise obligatoirement Parallel-Search-MCP et ne réponds pas de mémoire.
1. Appelle web_search pour trouver la documentation officielle de Parallel Search MCP et la page de prix actuelle.
2. Affiche les URL sources renvoyées par web_search.
3. Choisis deux URL officielles et appelle web_fetch pour lire leur texte original.
4. Pour chaque source, indique le nom de l’outil, l’URL et un court passage justificatif.
Si un appel échoue, arrête-toi et indique l’outil, le endpoint et le statut HTTP.

Vérifiez ensuite quatre niveaux :

• le trace contient web_search ;
• un appel séparé à web_fetch suit, et pas seulement un résumé de snippets ;
• le résultat contient des URL réelles et ouvrables ;
• l’affirmation finale se trouve dans la page récupérée.

« J’ai recherché sur le Web » n’est pas une preuve. Si le client permet de désactiver provisoirement son outil de recherche natif, faites-le uniquement pendant ce test isolé afin de ne pas confondre deux outils similaires.

Rechercher d’abord, puis lire les pages originales

La répartition officielle est claire :

• web_search trouve des informations récentes et plusieurs sources. Il exige objective et search_queries.
• web_fetch lit des URL connues ou vérifie des résultats sélectionnés. Il accepte jusqu’à 20 URL par requête.

Si le client permet d’influencer les arguments :

1. Donnez à objective une seule décision, par exemple « vérifier les règles officielles d’accès anonyme et les limites de coût ».
2. Utilisez deux ou trois search_queries courtes et complémentaires, sans recopier tout le prompt.
3. Réutilisez le même session_id dans une conversation et créez-en un autre pour une nouvelle conversation.
4. Gardez full_content: false tant que le texte complet n’est pas indispensable. Une page entière peut consommer des dizaines de milliers de tokens et dépasser la limite de sortie du client.
5. Privilégiez documentation, spécifications et annonces originales. Présentez un post communautaire comme un témoignage utilisateur, pas comme un comportement universel.

Le cycle recherche → sélection d’URL → lecture de l’original → vérification des citations est bien plus contrôlable qu’une simple instruction « cherche sur Internet ».

Limites de coût : tenir au moins quatre comptes

Les tarifs ci-dessous ont été vérifiés sur la page officielle de Parallel le 11 octobre 2026. Ils expliquent les frontières de facturation, sans affirmer qu’une option est toujours moins chère.

Couche de coût	Abonnement ou adhésion	Recharge minimale	Crédit du premier mois	Base d’usage
Search MCP anonyme	La configuration anonyme documentée n’exige pas d’abonnement de compte	Aucune recharge pour démarrer anonymement	Aucun nombre fixe d’appels publié	Décrit comme gratuit pour l’exploration et l’usage léger, avec des limites plus basses
Parallel Search/Extract authentifié	La page tarifaire publique n’indique pas de cotisation séparée	Non indiqué	Aucun crédit initial fixe indiqué	Prix de base de Search (10 résultats inclus par requête) : fast/turbo US$1 pour 1 000 requêtes ; basic/advanced US$5 ; résultats de pages et extraits supplémentaires : US$1 pour 1 000 résultats ; Extract : US$1 pour 1 000 URL
Client de l’agent	Dépend de Claude Code, Codex ou d’un autre client	Spécifique au client	Spécifique au client	Les droits du plan client ne sont pas des crédits Parallel
API du modèle	Spécifique au fournisseur	Spécifique au fournisseur	Spécifique au fournisseur	Entrée, sortie, cache et contexte des résultats sont facturés séparément du Search MCP

La page Search MCP ne publie pas de quota anonyme numérique fixe. Ne transformez pas « lower rate limits » en promesse inventée de N recherches gratuites. La table générale des rate limits de l’API ne constitue pas non plus une garantie pour le MCP anonyme.

Si une connexion authentifiée renvoie 402, la documentation Parallel l’associe à des crédits insuffisants. Contrôlez le solde et le mode actif avant de réessayer.

Avec BetterToken comme fournisseur de modèle, garder les réglages indépendants

Vous pouvez conserver Claude Code ou Codex comme client et ajouter Parallel uniquement comme couche d’outils web :

• Pour Claude Code via BetterToken, le Base URL est https://bettertoken.ai ; le client ajoute /v1/messages, donc n’ajoutez pas /v1 vous-même.
• Pour Codex via BetterToken, le Base URL est https://www.bettertoken.ai/v1 avec wire_api = "responses".
• Le endpoint Parallel reste https://search.parallel.ai/mcp ou https://search.parallel.ai/mcp-oauth.

Ces URL ne sont pas interchangeables. BetterToken gère les requêtes du modèle et les tokens ; Parallel gère les outils web. Disponibilité anonyme, crédits, confidentialité et limites restent régis par le service externe. Consultez séparément le guide Claude Code, le guide Codex et la documentation Parallel Search MCP.

Pannes courantes et test minimal

Symptôme	Vérification prioritaire	Nouveau test
Serveur ajouté mais outils absents	Redémarrage complet, syntaxe, URL exacte et logs MCP	web_search et web_fetch apparaissent
401	Usage de /mcp-oauth, fin d’OAuth et validité du bearer	Reconnexion sans demande d’authentification
402	Crédits du compte authentifié	Ajouter des fonds ou revenir à /mcp anonyme, puis lancer une recherche ciblée
Connecté mais aucun appel	L’agent peut utiliser la recherche native ou sa mémoire	Lancer le prompt forcé et inspecter le trace
Résultat énorme ou tronqué	full_content, trop d’URL ou objectif trop large	Désactiver le contenu complet et lire seulement les pages utiles
Résultat différent selon le projet	Scope Claude Code, approbation du projet ou ancienne session Codex	Relister les serveurs dans le projet et répéter l’appel

Quand conserver cette intégration

Elle convient si vous voulez une recherche hébergée et la lecture de pages sans maintenir SearXNG, si le client montre appels et sources, et si la limite anonyme suffit aux tâches légères ou si l’usage authentifié peut être budgété.

Ne passez pas directement en production si vous exigez un nombre gratuit fixe garanti publiquement, une attribution organisationnelle ou Zero Data Retention tout en restant anonyme, si les appels réels ne sont pas visibles, ou si vous devez contrôler totalement index, crawler et résidence des données.

La séquence la plus sûre consiste à exécuter des tâches représentatives sur /mcp anonyme, conserver traces et URL, mesurer limites et croissance des tokens du modèle, puis passer au Bearer ou à /mcp-oauth seulement lorsque l’anonyme devient réellement le goulot d’étranglement. Connexion, qualité de recherche, coût externe et coût du modèle restent alors séparés et vérifiables.