Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
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 sait tout faire sur votre site Dokos — et rien en dehors. Le MCP (Model Context Protocol) est la norme qui comble cet écart : un service tiers expose ses opérations sous forme d'outils, vous le déclarez dans Dokos, et l'assistant peut les employer au cours d'une conversation ou d'un flux automatisé, en même temps que les outils Dokos.

Exemple — Dokompany Un serveur MCP relié à la plateforme de transport expose une opération de suivi de colis. « 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 répond en une seule fois — sans que personne n'ouvre deux applications.

Déclarer un serveur

Un serveur se décrit par la façon de le joindre et par ce qu'on l'autorise à faire. Dokos joint un service distant en HTTPS, avec un jeton d'authentification et, si nécessaire, des en-têtes supplémentaires. Un délai d'attente maximal évite qu'un service lent ne bloque une conversation.

Une fois la connexion établie, Dokos interroge le serveur pour lister ses outils. Vous cochez ceux que vous autorisez : un serveur qui expose vingt opérations n'en donne que celles que vous avez retenues. Un outil ajouté plus tard par l'éditeur du service n'est pas utilisable tant que vous ne l'avez pas autorisé à votre tour.

Les serveurs de type commande locale ne sont pas joints par le réseau : ils exécutent un programme sur votre serveur Dokos. Cette possibilité est fermée par défaut et fait l'objet d'une autorisation distincte dans les paramètres de l'IA. Ne l'ouvrez que pour des commandes dont vous maîtrisez le contenu.

Restreindre l'usage

Deux garde-fous s'appliquent à chaque serveur, indépendamment des permissions Dokos habituelles.

La confirmation obligatoire. Les outils du serveur ne s'exécutent qu'après accord explicite de l'utilisateur. À réserver aux services qui agissent sur le monde réel — envoyer un message, déclencher une commande, débiter un compte.

La restriction par rôle. Seuls les porteurs d'un rôle donné peuvent employer ce serveur. Un connecteur vers l'outil de paie n'a pas à être accessible à l'ensemble des utilisateurs simplement parce qu'il est déclaré.

L'usage des serveurs MCP doit être activé globalement dans les paramètres de l'IA avant qu'un serveur déclaré ne devienne utilisable. Tant que cette activation n'est pas faite, aucun outil externe n'est proposé à l'assistant.

L'inverse : exposer Dokos à un assistant externe

Le MCP fonctionne dans les deux sens. Ici, Dokos consomme les outils d'un service tiers ; il peut aussi être le service consommé, et fournir vos données à Claude ou à un autre assistant. Voir Piloter Dokos depuis un assistant externe.

Voir aussi