Aller au contenu principal
Logo Model Context Protocol

Serveurs MCP

Connectez une fois n'importe quel serveur compatible MCP — vos agents vocaux reçoivent ses outils au début de l'appel et les appellent en pleine conversation.

Forfaits payantsVotre propre serveur

MCP — le Model Context Protocol — est un standard ouvert qui permet aux assistants IA de découvrir et d'appeler des outils externes. Si vous exploitez un serveur compatible MCP (le vôtre ou l'un des nombreux serveurs communautaires), vous pouvez le brancher dans Hanc.AI et vos agents recevront les outils du serveur au moment où un appel commence.

Une fois connecté, l'agent peut appeler ces outils en cours de conversation — récupérer des données en direct, faire des calculs, lancer des workflows backend — exactement comme les intégrations Calendar, HubSpot ou API Tool intégrées.

Forfaits payants

Les serveurs MCP sont disponibles avec tous les forfaits payants, à partir de Starter — ni pendant l'essai gratuit ni sur Free ; la carte MCP y affiche « La connexion de serveurs MCP est disponible avec les offres payantes ». Aucuns frais par serveur — vous ne payez que les minutes d'appel utilisées par votre agent lorsqu'il appelle les outils.


Ce que votre agent peut faire​

  • Appeler vos outils en pleine conversation — récupérer des données en direct, faire des calculs, lancer des workflows backend, exactement comme les intégrations intégrées.
  • Recevoir les outils à jour à chaque appel — les outils sont découverts au début de l'appel, donc les changements sur votre serveur apparaissent dès l'appel suivant.
  • Utiliser plusieurs serveurs sans conflit — chaque nom d'outil est préfixé par l'étiquette de sa connexion.

Quand utiliser MCP​

ScénarioPourquoi MCP est adapté
Vous exploitez déjà un serveur d'outils interneUne connexion, tous vos outils disponibles à chaque agent
Vous voulez partager des outils entre agentsConnectez une fois, attachez à autant d'agents que vous voulez
Vous utilisez des serveurs MCP communautairesBranchez des serveurs MCP open-source populaires sans code personnalisé
Votre surface d'outils change fréquemmentL'agent re-découvre les outils à chaque appel — ajoutez/supprimez côté serveur sans toucher au tableau de bord

Si vous avez un endpoint unique ponctuel, l'outil API est plus simple. Si vous avez un ensemble d'outils liés, ou si vous maintenez déjà un serveur MCP, c'est la bonne intégration.


Connecter un serveur MCP​

  1. Ouvrez la page Intégrations

    Dans la barre latérale du tableau de bord, allez dans Intégrations et ouvrez l'onglet Développeurs : la section Serveurs MCP se trouve en haut.

    L'onglet Développeurs de la page Intégrations : Serveurs MCP et Gestion des clés API
  2. Cliquez sur Connecter un serveur MCP

    Le panneau Serveurs MCP liste vos connexions. Cliquez sur Connecter un serveur MCP.

    Le panneau Serveurs MCP : la liste des connexions avec étiquette, URL, authentification et statut, et le bouton Connecter un serveur MCP

    Une fenêtre s'ouvre. Renseignez :

    ChampDescription
    NomUn nom court pour cette connexion (p. ex. Sales Tools, Internal CRM). Il apparaît dans la liste des connexions et dans la liste des serveurs MCP de l'agent, et il préfixe les noms d'outils présentés à l'IA : gardez-le court et parlant.
    URL du serveurL'adresse HTTPS du endpoint Streamable HTTP de votre serveur MCP, chemin compris (souvent /mcp). http:// et les adresses privées ou internes sont refusés.
    AuthentificationAucune si votre serveur est ouvert, ou Jeton Bearer s'il attend un en-tête Authorization: Bearer ….
    Jeton Bearer(Bearer uniquement) Votre jeton, envoyé en Authorization: Bearer …. Il est stocké chiffré ; Hanc.AI ne le déchiffre que pour se connecter à votre serveur en votre nom. Lorsque vous modifiez la connexion, laissez le champ vide pour conserver le jeton actuel.
    La boîte de dialogue Connecter un serveur MCP : étiquette, URL du serveur et authentification

    Cliquez sur Connecter. Hanc.AI n'accepte que les adresses https:// et refuse les hôtes privés et internes. Il ne vérifie pas si votre serveur MCP répond à cette adresse : un mauvais chemin ou un serveur arrêté ne se remarque que lorsque l'agent ne voit pas les outils.

    La connexion est désormais disponible pour tous les agents de votre espace de travail.

Les libellés comptent

Les noms d'outils de chaque serveur MCP sont préfixés du libellé de connexion, donc un serveur MCP avec un outil lookup_order connecté comme "Shop API" apparaîtra à l'agent comme Shop_API_lookup_order. Cela évite les collisions quand vous connectez plusieurs serveurs MCP qui ont des outils aux noms similaires.

Modifier ou supprimer​

La liste Serveurs MCP affiche, pour chaque connexion, le nom, l'URL, l'authentification et le statut (actif / inactif). Les boutons de chaque ligne :

  • Modifier — changer le nom, l'URL, l'authentification ou le jeton, puis cliquer sur Enregistrer
  • Supprimer — retirer complètement la connexion

Retirer une connexion la désactive pour chaque agent qui l'avait attachée — ces agents perdent simplement l'accès à ses outils au prochain appel.


Attacher des outils MCP à un agent​

Une connexion dans votre espace de travail est disponible pour vos agents — mais chaque agent décide individuellement lesquelles de vos connexions exposer. Cela signifie que vous pouvez avoir des agents Vente et Support distincts qui puisent dans différents serveurs MCP.

  1. Ouvrez l'onglet Actions de l'agent

    Choisissez l'agent, ouvrez l'onglet Actions et cliquez sur Ajouter un outil.

  2. Choisissez Serveurs MCP

    Le menu regroupe les entrées par phase : Pre fetch, Live call, Post call. Serveurs MCP se trouve dans la colonne Live call, sous CRM et services — l'agent appelle les outils MCP pendant la conversation, ni avant ni après.

  3. Remplissez l'outil
    ChampDescription
    Nom de l'outilUn nom pour cette entrée dans l'onglet Actions de l'agent (p. ex. Outils MCP externes). Obligatoire.
    Quand l'utiliserUne courte consigne que l'agent lit pour décider quand recourir à ces outils pendant la conversation. Obligatoire.
    Serveurs MCPToutes les connexions MCP de votre espace de travail, chacune avec un interrupteur. Activez celles que cet agent doit utiliser — tous les outils de ces serveurs deviennent appelables. Une connexion qui n'est pas active est marquée inactif.
    La boîte de dialogue Ajouter l'outil Serveurs MCP : nom de l'outil, quand l'utiliser et un interrupteur par connexion MCP

    Cliquez sur Enregistrer. L'agent a maintenant accès aux outils de chaque connexion MCP activée.

Mélange et assemblage

Vous pouvez avoir une connexion MCP activée sur cinq agents et une autre activée sur un seul — chaque agent a son propre outil Serveurs MCP avec son propre ensemble de toggles.


Exemples de scénarios​

Consulter une commande sur votre propre serveur L'appelant demande où en est sa commande → l'agent appelle l'outil lookup_order de votre serveur MCP, connecté sous « Shop API » (Shop_API_lookup_order) → il répond d'après ce que renvoie votre serveur.

Des outils différents pour des agents différents Votre agent commercial a la connexion Sales Tools activée, votre agent support la connexion Internal CRM → chaque agent ne voit que les outils de ses propres connexions.

Un nouvel outil sans toucher au tableau de bord Vous ajoutez un outil sur votre serveur MCP → l'appel suivant le découvre → l'agent peut l'utiliser immédiatement.


Comment ça fonctionne au moment de l'appel​

Quand un appel commence, l'agent se connecte à chacun de ses serveurs MCP activés et demande « quels outils proposez-vous ? ». Ce que le serveur retourne est exposé à l'IA comme outil qu'elle peut appeler pendant la conversation.

Quelques points à savoir :

  • Les outils sont découverts au démarrage de l'appel. Si vous ajoutez ou retirez des outils sur votre serveur MCP, le changement apparaît au tout prochain appel — pas besoin de mettre à jour quoi que ce soit dans Hanc.AI.
  • Les noms d'outils sont préfixés du libellé de connexion (donc "Shop API" + outil search_products → Shop_API_search_products). Les outils d'agent intégrés et les autres outils MCP n'entreront pas en collision.
  • Les descriptions d'outils et schémas de paramètres viennent de votre serveur MCP. Rédigez de bonnes descriptions là-bas — c'est ce que l'IA utilise pour décider quand et comment appeler l'outil.
  • Les erreurs sont remontées à l'agent. Si un appel d'outil échoue, l'agent voit le message d'erreur et peut décider de réessayer, s'excuser ou essayer un autre outil.

Exigences pour votre serveur MCP​

Pour fonctionner avec Hanc.AI, votre serveur doit :

ExigenceDétail
HTTPShttp:// simple n'est pas accepté. Utilisez un vrai certificat TLS.
URL publiqueL'URL doit résoudre vers une adresse publique — Hanc.AI ne peut pas atteindre des serveurs sur un réseau privé ou localhost.
Transport HTTP Streamable MCPVotre serveur doit parler le transport Streamable HTTP sur un seul endpoint (souvent /mcp). Les serveurs qui ne proposent que l'ancien transport SSE (un endpoint /sse) et les serveurs stdio ne sont pas pris en charge.
Auth Bearer (optionnelle)Si votre serveur requiert une authentification, il doit accepter un en-tête Authorization: Bearer <token> standard.

Si vous hébergez votre propre serveur derrière un pare-feu, exposez-le via un tunnel ou un reverse proxy avec un endpoint HTTPS public.


Sécurité et confidentialité​

Vos bearer tokens sont stockés chiffrés. Hanc.AI ne déchiffre un jeton que pour se connecter à votre serveur en votre nom.

Les appels d'outils circulent agent → Hanc.AI → votre serveur MCP → retour. Pour le dépannage, Hanc.AI journalise les arguments des outils et les 2 000 premiers caractères de chaque résultat. Votre serveur logge ce que vous choisissez de logger de votre côté.

Si vous changez ou faites tourner votre token, modifiez la connexion dans le tableau de bord — la nouvelle valeur prend effet au prochain appel.

Pour que votre serveur sache quel utilisateur connecté de votre site appelle, faites émettre par votre serveur un jeton de courte durée pour cet utilisateur et transmettez-le via le widget du site. Il arrive à chaque connexion MCP de l'agent dans l'en-tête X-Hanc-Support-Token — voir Identifier un utilisateur connecté.


Disponibilité par plan​

PlanServeurs MCP
Essai gratuit, FreeNon disponible
Starter / Pro / Business / EnterpriseDisponible

Aucun frais par connexion — vous ne payez que les minutes d'appel pendant lesquelles l'agent invoque les outils.


Dépannage​

« La connexion ne s'enregistre pas »​

Le tableau de bord affiche Impossible d'enregistrer la connexion. Vérifiez les valeurs et réessayez. Vérifiez que :

  • L'URL commence par https://, et non http://.
  • Vérifiez l'adresse, elle contient peut-être une faute de frappe ; les hôtes privés et internes sont refusés.
  • L'hôte est public — localhost, 127.0.0.1 et les adresses internes sont bloqués volontairement.

« L'agent ne voit pas les outils »​

  • Vérifiez l'adresse : Hanc.AI ne vérifie pas que votre serveur MCP y répond. Assurez-vous que l'URL pointe vers le endpoint Streamable HTTP de votre serveur, chemin compris (souvent /mcp), et que le serveur fonctionne.
  • Vérifiez que l'outil Serveurs MCP de l'agent a au moins une connexion activée, que la connexion est actif et que l'outil est enregistré.
  • Assurez-vous que votre serveur MCP répond à une requête tools/list sans connexion interactive.
  • Revérifiez le jeton Bearer — des espaces ou des guillemets en trop font que votre serveur le refuse.

« L'outil échoue en cours d'appel »​

  • L'agent verra l'erreur que votre serveur retourne. Consultez les logs de votre serveur.
  • Les outils de longue durée peuvent expirer — gardez l'exécution des outils MCP sous quelques secondes par appel pour que le visiteur ne reste pas dans le silence.

« J'ai changé les outils sur mon serveur mais l'agent utilise encore les anciens »​

  • Les outils sont re-découverts au début de chaque appel, pas mis en cache entre les appels. Le tout prochain nouvel appel voit l'ensemble d'outils mis à jour. Les appels en cours gardent les outils qu'ils ont reçus au démarrage.