Skip to main content
L’outil MCP (mcp) expose à votre agent les outils d’un serveur MCP externe (Model Context Protocol). Bookivox se connecte au serveur en streamable HTTP, récupère son catalogue d’outils et les rend disponibles au modèle, exactement comme les autres outils. C’est la façon la plus rapide de brancher un ensemble de fonctions métier déjà implémentées ailleurs (CRM, ERP, base de connaissances) sans réécrire une API HTTP pour chacune.

​
Quand l’utiliser

Vous avez déjà un serveur MCP (interne ou éditeur) et vous voulez exposer ses outils à l’agent sans dupliquer sa logique.
Un seul serveur MCP peut exposer plusieurs outils : vous les branchez tous en une seule intégration, puis vous filtrez si nécessaire.
Le serveur ajoute des outils au fil du temps : un clic sur Rafraîchir le catalogue met à jour la liste sans recréer l’intégration.

​
Créer un outil MCP

1

Ouvrir les intégrations

Allez dans Intégrations, repérez la carte MCP puis cliquez sur Utiliser. Une page de création dédiée s’ouvre (/integrations/mcp/new), comme pour les autres intégrations.
2

Renseigner les réglages

La page de création affiche la même carte à trois onglets que la page de configuration d’un outil (Réglages, Authentification, Outils). Dans Réglages : le nom est prérempli (suffixe unique) et reste modifiable, la description aide le modèle à décider quand invoquer l’outil, l’URL streamable HTTP est obligatoire, et les délais (timeout_secs, sse_read_timeout_secs) sont ajustables dès la création. À droite, le panneau Récapitulatif (identique à celui des autres outils) reflète en direct le nom, le type, l’URL et l’état du catalogue. Voir Onglet Réglages.
3

Onglet Authentification (facultatif)

Sélectionnez un identifiant existant ou créez-en un si le serveur MCP exige un secret. Voir Onglet Authentification.
4

Onglet Outils (facultatif)

Saisissez une liste d’outils à autoriser. Le catalogue distant n’est synchronisé qu’après la création de l’outil, depuis la page de configuration. Voir Onglet Outils.
5

Créer l'outil

Le bouton Enregistrer reste désactivé tant que l’URL est vide : un outil MCP sans URL valide est refusé par le serveur. Une fois créé, la page de configuration de l’outil s’ouvre pour la suite.
6

Comprendre l'outil

Le bouton Comment ça marche (en haut de la page) ouvre un rappel en six points : ce qu’est un serveur MCP, où et quand il intervient, comment le brancher, ce qu’il expose et pourquoi l’utiliser. Le même bouton existe sur la page de configuration de chaque outil.
7

Attacher à un agent

Dans l’éditeur, ouvrez un nœud Étape agent → onglet Intégrations → cochez l’outil. Voir Onglet Intégrations du nœud.

​
Onglet Réglages

Le transport stdio et l’ancien transport SSE ne sont pas supportés. Le serveur doit exposer un endpoint streamable HTTP accessible depuis Internet (ou depuis votre réseau, selon votre déploiement).

​
Onglet Authentification

Un identifiant (credential) est un objet réutilisable qui stocke un secret et le transforme en en-tête HTTP. Il est facultatif : laissez vide pour un serveur MCP ouvert.
Les secrets sont stockés côté serveur et ne sont jamais réexposés dans l’interface. Un même identifiant peut être partagé par plusieurs outils MCP et API HTTP.
Appliquer le moindre privilège : créez un jeton dédié à cet outil, avec uniquement les droits nécessaires sur le serveur MCP, et faites-le tourner régulièrement.

​
Onglet Outils

Cet onglet contrôle ce que l’agent voit du serveur MCP.

​
Rafraîchir le catalogue

Le bouton Rafraîchir le catalogue interroge le serveur MCP et met à jour la liste des outils découverts.
  • La synchronisation est limitée (10 rafraîchissements par minute et par utilisateur).
  • Si le serveur est injoignable, la requête réussit quand même et affiche un message d’erreur : le catalogue précédemment en cache est conservé.
  • Le bouton est désactivé tant qu’aucune URL n’est renseignée.
Rafraîchissez le catalogue après avoir changé l’URL, les identifiants ou la configuration du serveur. Le filtre d’outils, lui, s’applique immédiatement sans rafraîchissement.
Le champ Filtre d’outils est une liste d’autorisation : si vous y placez des noms, seuls ces outils sont exposés au modèle. Utilisez les noms exacts du catalogue distant, avec la même casse.

​
Sécurité

En environnement hébergé, l’URL du serveur MCP est validée à l’enregistrement et lors du rafraîchissement. Les adresses internes (localhost, plages privées, loopback, link-local, CGNAT, multicast, réservées) sont rejetées pour éviter les attaques SSRF. Utilisez une URL publique, ou un passerelle exposée explicitement.
En déploiement auto-hébergé (OSS), cette restriction réseau est désactivée afin de permettre la connexion à des serveurs MCP internes.

​
Cas d’usage

​
Aller plus loin

Intégrations

Vue d’ensemble des catégories d’outils et de leur anatomie.

Appel HTTP

Alternative quand vous ne disposez pas d’un serveur MCP.

Serveur MCP Bookivox

Exposer vos agents Bookivox à des clients MCP externes.

Onglet Intégrations du nœud

Attacher un outil à une étape agent.
Last modified on November 3, 2026