Connecter vos outils à la plateforme via le protocole MCP

Dans Cogity, un connecteur MCP est le pont entre la plateforme et un système externe. Il permet à un workflow de lire ou d'écrire dans vos outils existants : TMS, ERP, WMS, PIM, base de données, API métier.

Le protocole MCP standardise cette connexion. Concrètement, cela veut dire :

• une interface de configuration commune, quel que soit le système cible
• une gestion centralisée des accès et des secrets
• des appels journalisés et traçables dans la Supervision
• une réutilisation du connecteur dans plusieurs workflows

Dans la navigation, ouvrir Connecteurs. La vue affiche deux zones :

• Connecteurs actifs : systèmes déjà connectés, avec statut (Actif / Inactif / Erreur)
• Catalogue : liste des connecteurs disponibles, organisés par catégorie

Cliquer sur Ajouter un connecteur. Le catalogue propose :

• ERP : SAP, Sage, Cegid, Generix et autres via API générique
• TMS : systèmes transport standards et API REST
• PIM : Akeneo, Plytix et autres
• Bases de données : PostgreSQL, MySQL, SQL Server
• API REST générique : pour tout système disposant d'une API

Pour ce tutoriel, choisir TMS générique ou le connecteur de démo. Renseigner les paramètres demandés :

• URL ou endpoint du système
• Méthode d'authentification (clé d'API, OAuth, token)
• Nom du connecteur (sera visible dans le Builder)
• Environnement : production ou test

Cliquer sur Tester la connexion. La plateforme envoie une requête légère vers le système (lecture d'un enregistrement de test). Le résultat affiche :

• Statut : Connexion établie (vert) ou Échec avec message d'erreur
• Temps de réponse
• Aperçu d'une donnée retournée (ex : un identifiant d'ordre de transport, un code produit)

Si la connexion échoue, le système indique le type d'erreur : authentification, endpoint inaccessible, timeout. Chaque type a un guide de résolution rapide.

Une fois le connecteur actif, il est disponible dans tous les workflows. Dans le Builder, ajouter une étape Appel connecteur et la configurer :

• Connecteur à appeler : sélectionner dans la liste des connecteurs actifs
• Donnée à récupérer : identifiant, champ spécifique, liste d'enregistrements
• Variable de sortie : nom de la variable qui portera la donnée dans les étapes suivantes

Exemple concret dans un flux de pré-facturation transport : l'étape Appel TMS récupère l'ordre de transport correspondant au numéro extrait du document entrant, puis compare les montants dans l'étape suivante.

Pour voir ce cas en détail : Pré-facturation transport.

Dans Supervision, chaque appel connecteur apparaît dans le journal de l'exécution :

• Système appelé
• Donnée récupérée (résumé)
• Durée de l'appel
• Statut (Succès / Erreur)

En cas d'erreur de connexion pendant une exécution, l'exception est visible, avec le message d'erreur et l'état des données au moment du blocage. L'exécution peut être reprise après correction.