Vectara MCP : brancher des agents sur Trusted RAG

Pour qui

Si vous voulez qu’une application agent se branche sur le Trusted RAG de Vectara—rapide, stable, avec moins d’hallucinations grâce à l’augmentation par recherche—ce service correspond. Le texte officiel décrit cette capacité via le protocole MCP.

Il convient à qui peut déjà installer avec pip et détient une clé API Vectara. Le démarrage par défaut est un transport HTTP authentifié. Sans clé, l’outil de configuration de session ne passe pas la validation.

La première fois, ne faites que valider la clé. Ne traitez pas comme des fonctions connues des outils de requête non nommés. La recherche sort quand même et envoie aussi votre question à Vectara.

Réussir le premier essai en 3 minutes

Le chemin officiel recommandé est d’installer depuis PyPI et de démarrer avec le transport HTTP sécurisé par défaut. Prérequis : une clé API Vectara déjà en main.

Installation :

pip install vectara-mcp

Définissez la variable d’environnement VECTARA_API_KEY avec la vraie clé émise par la console. Les valeurs d’exemple officielles sont des substitutions ; ne les copiez pas. Puis démarrez :

python -m vectara_mcp

Le texte officiel dit que le service tourne par défaut sur :

http://127.0.0.1:8000

et que l’authentification est déjà active. Pointez le client MCP vers ce service HTTP. Le texte officiel n’écrit pas les champs d’en-tête complets à mettre dans le client ; ne les inventez pas. Connectez comme le client se connecte à un MCP HTTP authentifié.

Puis un appel : appelez setup_vectara_api_key. Le texte officiel dit qu’il configure et valide la clé API Vectara de la session ; c’est un réglage unique. Les champs de paramètres ne sont pas écrits ; saisissez la vraie clé selon la définition affichée par le client, n’écrivez pas de chaînes d’exemple.

Signal de succès : la validation passe et la session peut utiliser cette clé. En cas d’échec, vérifiez d’abord que la variable d’environnement et l’argument d’outil sont la vraie clé.

N’ajoutez pas --stdio. La première fois, restez sur HTTP par défaut.

Cas d’usage

Cas 1 : valider la clé dans la session. Appelez setup_vectara_api_key. La note officielle est Configure and validate your Vectara API key for the session. Elle n’écrit ni le format de clé ni si elle remplace la variable d’environnement. En cas de succès vous devez voir la validation passer. Ne le traitez pas comme un outil capable d’interroger un corpus.

Cas 2 : après validation, une requête Trusted RAG. Le texte officiel dit que ce serveur fournit Trusted RAG aux applications agent. Cette page ne nomme que l’outil de réglage ci-dessus et n’écrit pas de nom de fonction de requête ; ouvrez les outils que ce serveur montre dans le client et choisissez l’élément décrit comme recherche ou questions-réponses. N’inventez pas de noms de fonction absents. En cas de succès, des résultats de recherche Vectara. Les requêtes sortent et peuvent aussi exposer le texte de votre question.

Limites

Par défaut, HTTP authentifié. Il existe aussi python -m vectara_mcp --stdio, que le texte officiel marque comme moins sûr, uniquement pour le développement local ou Claude Desktop, pas le chemin du premier essai.

VECTARA_API_KEY est obligatoire. Le texte officiel n’écrit ni limite de débit ni annulation. Cette page ne nomme pas d’outils de requête ; ne lisez pas les mots Trusted RAG comme un nom de fonction. L’adresse de bouclage locale indique seulement l’écoute par défaut, pas que les données restent sur la machine—la recherche atteint quand même Vectara.