Aller au contenu
membre du groupeApertiaDraivix

01IA et intégrations · module

MCP pour les agents IA externes

Connectez Claude Code, Codex et d’autres agents à votre ERP avec des droits utilisateur précis

DisponibleRéserver une consultation
  • Clé API
  • Jeton d’accès personnel
  • Jeton MCP
  • Conversation IA
13
fonctionnalités
4
types d’enregistrements
3
automatisations
12
intégrations et outils IA

02Ce que fait le module

Moins de routine. Plus de valeur.

Le protocole MCP (Model Context Protocol) permet à des agents IA externes tels que Claude Code ou Codex d’interagir avec les données dans Draivix. L’agent reçoit le même catalogue d’outils que l’assistant intégré, et chaque appel s’exécute avec les droits et la clé API d’un utilisateur spécifique. Votre entreprise peut ainsi connecter ses propres agents sans contourner les contrôles d’accès ni les journaux d’audit.

  • L’agent sait ce qu’il peut appelerUn agent IA externe télécharge un catalogue d’outils complet avec la description des entrées et des sorties. Vos agents manipulent les données via une interface documentée plutôt qu’à tâtons.
  • 85 outils sur un point de terminaison uniqueVia un seul point de terminaison, un agent peut accéder aux 85 outils autorisés de l’assistant intégré, ce qui simplifie l’intégration d’agents sur mesure.
  • Garde-fou intégré pour les propositions de modificationLes écritures passant par la passerelle de capacités renvoient par défaut une proposition. L’agent ou un utilisateur la confirme avec mutation_confirm ou l’annule avec mutation_cancel.
  • Clés restreintes à une sélection d’outilsLa clé API utilisée par un agent pour se connecter peut être limitée à une liste nominative d’outils. L’agent dispose uniquement de ce que votre entreprise autorise, et rien de plus.
  • Clé verrouillée en permanence en mode salle blancheUne clé API peut être verrouillée de façon permanente en mode salle blanche pour les données sensibles. Une telle clé ne voit que les outils compatibles avec ce mode dans le catalogue.
  • Les agents ne dépassent jamais les droits de l’utilisateurL’accès effectif d’un agent correspond à l’intersection des droits de l’utilisateur et du plafond de la clé API. L’agent ne peut faire que ce que les deux autorisent, et la clé seule ne déverrouille jamais aucun enregistrement.
  • Un serveur dédié pour vos agentsLe serveur MCP (Model Context Protocol) autonome newerp-agents-mcp propose 53 outils construits au-dessus de l’API REST. Ses écritures s’exécutent immédiatement selon les droits de l’utilisateur, sans passer par des propositions de validation.
  • Une authentification adaptée à l’agentUn agent se connecte avec un jeton transmis, un jeton d’accès personnel ou en signant un défi (challenge) avec une clé SSH — cette dernière option étant idéale pour les agents en ligne de commande.
  • Travail de l’agent traçable sur la tâche12 outils relient le travail de l’agent aux tâches et aux commits de code dans GitLab, afin que vous puissiez voir exactement ce qu’il a fait directement sur la fiche de la tâche.
  • Outils de chat et d’analyse documentaire à la demandeLe serveur peut être complété par des outils optionnels pour Mattermost et pour l’analyse de documents propulsée par Gemini (qui nécessite une clé API Gemini). N’activez que ce que vous utilisez réellement.
  • Chaque appel consigné dans le journal d’auditChaque appel d’agent est inscrit dans le journal d’audit avec la source mcp, ce qui vous permet de toujours distinguer les actions d’un agent externe de celles effectuées par une personne dans l’application.
  • Plafonné à 600 appels par minuteLa passerelle de capacités — l’interface pour agents directement intégrée à Draivix — est limitée à 600 appels par minute, maintenant la charge induite par les agents dans des limites claires.
  • Transfert de conversation vers HermesUne conversation issue de l’assistant peut être transférée au service d’agents Hermes avec un identifiant éphémère valable 300 secondes. Elle s’exécute avec les droits de l’utilisateur qui l’a initiée et est tracée dans le journal d’audit.

03Comment ça marche

Comment ça marche étape par étape.

  1. Deux voies d’accès pour les agents

    La première voie est la passerelle de capacités (capability bridge) directement intégrée à Draivix. Un agent télécharge le catalogue d’outils et appelle ces derniers via un point de terminaison unique. Le catalogue comprend les outils autorisés de l’assistant intégré (85 sur environ 100 outils enregistrés) ainsi que neuf actions : confirmer ou annuler une proposition de modification, modifier les éléments d’une proposition en masse, envoyer un e-mail et fermer un canevas affiché. Le catalogue est versionné ; si rien n’a changé, le serveur indique qu’il est à jour afin que l’agent n’ait pas à le télécharger de nouveau.

    Lire en détail

    La seconde voie est le serveur MCP autonome newerp-agents-mcp, qui encapsule l’API REST générale pour les agents de développement et d’exploitation. Il fournit 53 outils : gestion des enregistrements et des métadonnées, relations, pièces jointes, e-mails, tâches, activités et rapports, recherche globale, calendrier, 12 outils pour lier le travail de l’agent aux tâches et commits GitLab, et en option 7 outils pour Mattermost. L’outil d’analyse de documents nécessite une clé API Gemini. Le serveur fonctionne via stdio ou HTTP et tronque les réponses pour qu’elles tiennent dans la fenêtre de contexte du modèle.

  2. Permissions et clés API

    Un agent agit toujours au nom d’un utilisateur spécifique. L’autorisation d’accès à la passerelle de capacités permet uniquement à la clé d’accéder à l’interface : à elle seule, elle n’accorde l’accès à aucun enregistrement. L’accès effectif correspond à l’intersection des droits de l’utilisateur et du plafond défini pour la clé API. Une clé peut être restreinte à une liste précise d’outils et verrouillée de façon permanente en mode salle blanche ; une telle clé ne voit alors que les outils compatibles avec ce mode dans le catalogue.

    Lire en détail

    Le serveur newerp-agents-mcp ne possède aucune permission propre : chaque appel transporte un jeton utilisateur et passe par l’API REST standard. Les agents peuvent s’authentifier à l’aide d’un jeton porteur (bearer token) transmis, d’un jeton d’accès personnel ou en signant un défi (challenge) avec une clé SSH — ce qui est idéal pour les agents en ligne de commande.

    La passerelle de capacités est limitée à 600 appels par minute. Chaque appel s’exécute dans un contexte d’audit marqué avec la source mcp et un identifiant de trace. Le fait qu’un outil modifie ou non des données est transmis à l’agent sous forme d’indication MCP standard (lecture seule ou modification).

  3. Contrôle des modifications

    La passerelle de capacités suit la même règle que l’assistant intégré : les outils de création, de modification et de suppression renvoient par défaut une proposition. L’agent ou une personne la confirme via mutation_confirm ou l’annule via mutation_cancel. La confirmation relance l’opération réelle avec les droits de l’utilisateur.

    Lire en détail

    Le serveur newerp-agents-mcp n’utilise ni propositions ni mode salle blanche. Ses écritures sont exécutées immédiatement, toujours dans le cadre des droits de l’utilisateur dont l’agent utilise le jeton. Pour les agents dont vous souhaitez valider chaque modification, utilisez plutôt la passerelle de capacités.

  4. Délégation au service d’agents Hermes

    Une conversation commencée dans l’assistant intégré peut être transférée au service d’agents Hermes. Hermes reçoit un identifiant à durée de vie courte, valable 300 secondes et lié à l’entreprise, puis rappelle Draivix via la passerelle de capacités. Les appels s’exécutent avec les droits de l’utilisateur qui a lancé la conversation ; le mode salle blanche ne peut pas être élargi. Chaque appel délégué est consigné dans le journal d’audit comme pertinent pour la sécurité.

04Ce qui s’exécute automatiquement

Des automatisations qui font gagner du temps.

  1. Aucun téléchargement redondant du catalogue

    Le catalogue d’outils est mis en cache pendant 15 minutes par entreprise et par version. Lorsqu’un agent se connecte et que le catalogue n’a pas changé, le serveur ne le renvoie pas et l’agent n’a pas besoin de le retélécharger.

  2. Une piste d’audit pour chaque appel

    Chaque appel d’agent crée automatiquement une entrée dans le journal d’audit marquée avec la source mcp et un identifiant de trace, ce qui permet de retrouver facilement n’importe quelle action par la suite.

  3. Expiration automatique des identifiants

    Lorsqu’une conversation est transférée, le service Hermes reçoit un identifiant lié à l’entreprise qui expire au bout de 300 secondes, garantissant un accès strictement éphémère.

Intégrations externes

  • Claude Code en tant qu’agentConnectez Claude Code à Draivix via MCP (Model Context Protocol). Il manipule les données selon les autorisations et la clé API d’un utilisateur précis, sans jamais contourner les droits d’accès ni le journal d’audit.
  • Codex soumis aux mêmes règlesCodex se connecte à Draivix via MCP et reçoit le même catalogue d’outils que l’assistant intégré. Chaque appel s’exécute avec les autorisations d’un utilisateur spécifique.
  • Hermes prend le relais de la conversationLe service d’agent Hermes reprend une conversation transmise par l’assistant et rappelle le système via la passerelle de capacités. Le mode salle blanche (clean-room) ne peut pas être élargi et chaque appel est consigné dans le journal d’audit.
  • Analyse de documents via GeminiLe serveur newerp-agents-mcp intègre un outil d’analyse de documents propulsé par Gemini (nécessite une clé API Gemini), ce qui permet à l’agent d’exploiter également le contenu des documents.
  • Le travail de l’agent relié aux commitsLes outils de newerp-agents-mcp relient le travail de l’agent aux tâches et aux commits dans GitLab, afin que vous puissiez suivre directement sur la tâche concernée ce que l’agent a réalisé.
  • Mattermost quand vous en avez besoinLe serveur newerp-agents-mcp peut être enrichi de 7 outils Mattermost optionnels, permettant à l’agent d’interagir avec la messagerie d’équipe dès que votre entreprise le souhaite.

Ce que l’agent IA prend en charge

  • Accès aux données pour vos agents

    Un agent externe peut lire, rechercher et compter les enregistrements de n’importe quelle entité (type d’enregistrement), en ne voyant que ce à quoi l’utilisateur et sa clé API sont autorisés à accéder.

  • Les modifications commencent par des propositions

    Via la passerelle de capacités, un agent se contente par défaut de proposer une modification d’enregistrement. Une fois la proposition confirmée par l’agent ou par un collaborateur, l’opération s’exécute à nouveau selon les autorisations de l’utilisateur.

  • Ajustez les propositions groupées avant validation

    Les éléments individuels d’une proposition en masse peuvent être modifiés avant confirmation, ce qui vous évite de rejeter tout le lot à cause d’un seul élément erroné.

  • Les agents peuvent aussi envoyer des e-mails

    Un agent peut envoyer un e-mail parmi les actions du catalogue d’outils. L’action s’exécute au nom d’un utilisateur précis et est consignée dans le journal d’audit : vous savez toujours qui en est à l’origine.

  • Pièces jointes et e-mails via le serveur

    Grâce au serveur newerp-agents-mcp, un agent peut gérer les pièces jointes et les e-mails. Les écritures s’exécutent immédiatement dans la limite des autorisations de l’utilisateur ; utilisez la passerelle de capacités si vous souhaitez approuver chaque modification.

  • Le travail de l’agent rattaché à la bonne tâche

    L’agent associe son travail aux tâches et aux commits de code dans GitLab, ce qui vous permet de voir à quelle tâche se rapportent ses modifications lors de la revue.

Une personne valide dès qu’il s’agit d’argent, d’un client ou d’une exception.

05Questions fréquentes

Puis-je connecter Claude Code ou un autre agent IA à Draivix ?

Oui. L’agent se connecte via MCP — soit par la passerelle de capacités intégrée à Draivix, soit via le serveur autonome newerp-agents-mcp — et agit avec les autorisations de l’utilisateur dont il utilise la clé ou le jeton.

Un agent peut-il contourner les autorisations via MCP ?

Non. Chaque appel s’exécute au nom d’un utilisateur spécifique, et l’accès effectif correspond à l’intersection des autorisations de cet utilisateur et du plafond défini pour la clé API. La clé peut également être restreinte à une sélection d’outils.

L’agent écrit-il les modifications immédiatement ?

Via la passerelle de capacités, les opérations de création, de mise à jour et de suppression renvoient par défaut une proposition qui doit être confirmée séparément. Le serveur newerp-agents-mcp écrit quant à lui immédiatement, dans le respect des autorisations de l’utilisateur.

Puis-je retracer ce qu’un agent a fait dans le système ?

Oui. Chaque appel passant par la passerelle de capacités est enregistré dans la piste d’audit avec la source mcp et un identifiant de trace, et les appels délégués provenant du service Hermes sont signalés comme pertinents pour la sécurité.

06Modules associés

Des modules qui fonctionnent parfaitement ensemble.

Tous les modules dans IA et intégrations

Commençons ensemble

Expliquez-nous comment fonctionne votre entreprise.

Nous vous montrerons à quoi pourrait ressembler un système qui prend en charge une partie de ce travail.

Réserver une consultation