View Categories

Connecter une IA externe (MCP)

2 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. Sécurité #

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.

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 #