View Categories

Connecter une IA externe (MCP)

3 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é #

  • 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 #