View Categories

Connecter une IA externe (MCP)

4 minutes

Introduction #

Le protocole MCP (Model Context Protocol) permet de connecter un client IA externe (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains…) directement à votre instance Kafinea. L’IA externe peut alors interroger vos données ERP, consulter des enregistrements et effectuer des recherches sans quitter votre outil de travail habituel.

1. Qu’est-ce que MCP ? #

MCP est un protocole standard permettant aux clients IA de se connecter à des serveurs d’outils. Kafinea expose un serveur MCP qui donne accès aux données de l’ERP de manière sécurisée, en respectant les droits d’accès de l’utilisateur connecté.

2. Accéder à la page de configuration #

  1. Connectez-vous à Kafinea
  2. Accédez à Mes Préférences (menu utilisateur en haut à droite)
  3. Cliquez sur le bouton Configuration MCP (IA externe)

La page affiche vos identifiants personnels et les configurations JSON prêtes à copier pour chaque client IA supporté.

3. Vos identifiants #

La page de configuration affiche trois informations essentielles :

  • Point d’accès (URL) : l’adresse du serveur MCP de votre instance Kafinea
  • Nom d’utilisateur : votre identifiant Kafinea
  • Clé d’accès : votre clé d’accès personnelle (Access Key)

Important : Ne partagez jamais votre clé d’accès. Elle donne accès à vos données Kafinea avec vos droits utilisateur.

4. Configurer votre client IA #

Pour chaque client IA, la page propose un bloc de configuration JSON prêt à copier. Cliquez sur le bouton Copier à côté du client souhaité.

Claude Desktop #

  1. Ouvrez Claude Desktop
  2. Accédez à Settings → Developer → MCP Servers
  3. Collez la configuration JSON copiée dans le fichier claude_desktop_config.json
  4. Redémarrez Claude Desktop

Cursor #

  1. Ouvrez Cursor
  2. Accédez à Settings → MCP → Add Server
  3. Choisissez le type JSON
  4. Collez la configuration copiée

Windsurf #

  1. Ouvrez le fichier mcp_config.json de Windsurf
  2. Collez la configuration copiée
  3. Redémarrez Windsurf

VS Code / GitHub Copilot #

  1. Créez ou ouvrez le fichier .vscode/mcp.json dans votre projet
  2. Ou accédez aux settings utilisateur de VS Code
  3. Collez la configuration copiée

JetBrains (IntelliJ, PhpStorm, …) #

  1. Accédez à Settings → Tools → AI Assistant → MCP Servers
  2. Collez la configuration copiée

5. Tester la connexion #

Une fois la configuration en place :

  1. Redémarrez votre client IA si nécessaire
  2. Posez une question qui fait référence à des données Kafinea (par exemple : « Liste mes dernières factures »)
  3. Le client IA devrait être capable d’interroger Kafinea et d’afficher les résultats

6. Consulter les relations et le suivi des stocks #

Le serveur MCP emploie les mêmes concepts et règles que l’API Kafinea :

  • les listes connexes servent à parcourir les éléments associés à une fiche ;
  • les liens entre éléments sont créés et modifiés comme des données Kafinea ordinaires ;
  • les kits de produits disposent d’outils dédiés qui conservent les quantités, contrôlent les boucles et recalculent le prix.

Le client IA peut ainsi lire ou corriger la composition complète d’un kit. Une ancienne référence vers un produit supprimé est signalée et peut être retirée lors du remplacement de la composition.

Pour les livraisons et retours, le serveur fournit un outil de consultation du suivi et un guide d’investigation partagé avec le chat IA. Ce guide est proposé parmi les ressources disponibles au client connecté. Il lui indique de remonter à la facture ou à l’avoir lié avant d’expliquer un écart ou de proposer une correction.

Vous pouvez demander : « Cette livraison suit-elle les modifications de sa facture ? » ou « Quel avoir a généré ce retour ? ». La consultation distingue la génération seule de la synchronisation, fournit les dates connues et montre les bons actifs et les dépôts accessibles avec vos droits. Une réception fournisseur est identifiée par sa source réelle et n’est pas assimilée à un retour client.

La consultation ne modifie pas les données et ne relance aucune génération. Pour en savoir plus sur les modes de suivi, consultez la génération automatique des bons de livraison.

7. Sécurité #

  • Chaque utilisateur a sa propre clé d’accès
  • Les requêtes MCP respectent les droits d’accès de l’utilisateur
  • Ne publiez jamais la configuration JSON dans un dépôt public
  • Si votre clé d’accès est compromise, générez-en une nouvelle depuis Mes Préférences

FAQ #

Ma clé d’accès a changé, que faire ?
Retournez sur la page Configuration MCP et copiez à nouveau la configuration avec la nouvelle clé.

Le client IA n’arrive pas à se connecter
Vérifiez que l’URL du point d’accès est correcte et accessible depuis votre poste. Vérifiez aussi que le serveur MCP est activé par votre administrateur.

Quelles données l’IA externe peut-elle voir ?
Uniquement les données auxquelles vous avez accès dans Kafinea, selon votre profil et vos droits.

Références associées #