IA

Connecter des outils externes à l'assistant

Déclarer un serveur MCP pour donner à l'assistant et aux flux l'accès aux outils de vos autres applications, en choisissant les outils autorisés, le rôle qui y a droit et les actions à confirmer.

Connecter des outils externes à l'assistant

L'assistant travaille sur votre site Dokos. Le MCP (Model Context Protocol) lui donne aussi accès aux outils d'autres applications. Un service tiers expose ses opérations sous forme d'outils. Vous le déclarez dans Dokos, et l'assistant peut les utiliser dans une conversation ou un flux automatisé.

Exemple fictif — Dokompany Un serveur MCP relié à la plateforme de transport expose une opération de suivi de colis. Vous demandez : « Où en est la livraison de la commande SO-0142 ? ». L'assistant lit la commande dans Dokos, y trouve le numéro de suivi, interroge le transporteur et vous répond.

Prérequis

  • L'IA est activée. Voir Activer et paramétrer l'IA.
  • Dans les Paramètres de l'IA, la case Activer les outils MCP est cochée. Sans elle, aucun outil externe n'est proposé à l'assistant.
  • L'adresse du serveur MCP et, si le service l'exige, un jeton d'authentification.

Déclarer un serveur

  1. Ouvrez la liste Serveur MCP d'IA et cliquez sur Créer.
  2. Remplissez les champs :
ChampRôle
Nom du serveurLe nom affiché dans Dokos.
Transportstreamable-http (par défaut) ou sse, selon ce que le service propose.
URLL'adresse du serveur MCP. Dokos refuse une adresse interne au réseau du serveur.
Jeton d'authentificationLe jeton envoyé au service.
En-têtes supplémentaires (JSON)Des en-têtes HTTP en plus, sous forme d'objet JSON. Exemple : {"X-Account": "dokompany"}.
Délai d'attente (s)Temps maximal d'attente d'une réponse. 30 secondes par défaut.
  1. Enregistrez.
  2. Cliquez sur Actualiser les outils. Dokos interroge le serveur et liste ses outils dans le tableau Outils.
  3. Cochez les outils que vous autorisez, puis enregistrez.

Un serveur qui expose vingt opérations ne donne que celles que vous avez cochées. Un outil ajouté plus tard par l'éditeur du service reste inutilisable tant que vous ne l'avez pas coché.

Les serveurs de type commande locale (stdio) ne sont plus pris en charge : ils exécutaient un programme sur le serveur Dokos. La mise à jour a désactivé les serveurs existants de ce type. Supprimez-les, puis déclarez à nouveau le service en streamable-http ou sse.

Restreindre l'usage

Trois réglages s'appliquent à chaque serveur, en plus des permissions Dokos habituelles.

ChampEffet
Nécessite une confirmationLes outils du serveur ne s'exécutent qu'après l'accord de l'utilisateur. Utilisez-le pour un service qui agit hors de Dokos : envoyer un message, passer une commande, débiter un compte.
Restreindre au rôleSeuls les utilisateurs qui ont ce rôle peuvent utiliser le serveur. Exemple : un connecteur vers l'outil de paie, réservé au rôle RH.
Les outils sont en lecture seuleVous déclarez que les outils de ce serveur ne modifient rien. Un agent qui n'a qu'un accès en lecture ne reçoit que les outils des serveurs marqués ainsi.

L'inverse : exposer Dokos à un assistant externe

Le MCP fonctionne dans les deux sens. Ici, Dokos utilise les outils d'un service tiers. Dokos peut aussi fournir ses données à Claude ou à un autre assistant. Voir Piloter Dokos depuis un assistant externe et Dokos Connect.