Aller au contenu principal
DocumentationAPI ReferenceVideo Tutorials

Serveurs MCP

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.

Disponible sur tous les plans

Les serveurs MCP sont disponibles sur tous les plans, y compris Free. Aucun frais par serveur — vous ne payez que les minutes d'appel utilisées par votre agent lors de l'invocation des outils.

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. Ouvrir la page Intégrations​

Dans la barre latérale du tableau de bord, allez dans Intégration. Faites défiler jusqu'à la section Serveurs MCP.

2. Cliquez sur « Connecter un serveur MCP »​

Une fenêtre s'ouvre. Remplissez :

ChampDescription
LibelléUn nom court pour cette connexion (par ex. "Outils Vente", "CRM Interne"). Le libellé est affiché dans le sélecteur d'outils de l'agent et préfixe les noms d'outils présentés à l'IA, gardez-le donc court et significatif.
URLL'URL HTTPS de votre serveur MCP. Doit être une adresse publiquement accessible — http:// et les adresses privées/internes sont rejetées.
AuthentificationAucune si votre serveur est ouvert, ou Bearer token s'il attend un en-tête Authorization: Bearer ….
Token(Bearer uniquement) Votre token d'authentification. Stocké chiffré — seul votre compte plateforme peut le déchiffrer pour usage.

Cliquez sur Enregistrer. Hanc.AI vérifie le format de l'URL et stocke la connexion. La connexion est maintenant disponible à chaque agent de votre espace.

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.

3. Modifier, désactiver ou supprimer​

La liste des serveurs MCP affiche le libellé, l'URL, le type d'auth et le statut de chaque connexion ajoutée. Utilisez les actions de ligne pour :

  • Modifier — changer libellé, URL, type d'auth ou token
  • Supprimer — retirer la connexion entièrement

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. Ouvrir l'onglet Actions de l'agent​

Choisissez l'agent. Ouvrez l'onglet Actions. Cliquez sur Ajouter une action.

2. Choisir « Serveurs MCP » dans le groupe Live-call​

Le menu déroulant montre trois groupes : Pre fetch, Live call, Post call. Cherchez dans le groupe Live-call — c'est là que Serveurs MCP appartient, car l'agent invoque les outils MCP pendant la conversation, pas avant ou après.

3. Activer les connexions à utiliser​

La fenêtre liste chaque connexion MCP de votre espace de travail, chacune avec un toggle on/off. Activez celles que cet agent doit utiliser. Vous pouvez aussi rédiger une courte instruction dans le champ « Quand l'utiliser » — c'est ce que l'agent lit pour décider quand utiliser ces outils pendant une conversation.

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.

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 MCPLe transport HTTP MCP actuel sur un seul endpoint. Les transports SSE-only et stdio ne sont pas pris en charge dans cette intégration.
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 au repos. Seule l'infrastructure d'appel de Hanc.AI peut les déchiffrer, et seulement au moment où un appel commence et que l'agent a besoin de se connecter à votre serveur.

Les appels d'outils circulent agent → Hanc.AI → votre serveur MCP → retour. Nous ne loggons pas les payloads d'appel d'outils. 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.

Disponibilité par plan​

PlanServeurs MCP
FreeDisponible
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 »​

  • Assurez-vous que l'URL commence par https:// et non http://.
  • Assurez-vous que l'hôte est publiquement accessible — localhost, 127.0.0.1 et les adresses internes sont bloquées par conception.
  • Revérifiez le bearer token si vous en avez défini un — un espace ou un guillemet en trop cassera la sauvegarde.

« L'agent ne voit pas les outils »​

  • Vérifiez que l'entrée serveur MCP dans l'onglet Actions de l'agent a au moins une connexion activée on et que l'entrée est enregistrée.
  • Assurez-vous que votre serveur MCP répond à une requête tools/list et ne nécessite pas de flux d'auth interactif.
  • Regardez dans le journal d'appel de l'agent les messages de la connexion MCP juste au début de l'appel.

« 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.

Lié​