View Categories

Connecter ChatGPT, Claude ou Gemini à Kafinea (MCP)

7 minutes

0:00 7:38

Introduction #

Interrogez vos données Kafinea directement depuis ChatGPT, Claude, Gemini, Copilot, Cursor ou Codex : factures, clients, stocks, projets. Vous ajoutez une seule adresse dans votre assistant, vous vous connectez avec votre compte Kafinea habituel, et l’assistant travaille avec vos droits, sans clé à stocker.

Kafinea utilise pour cela MCP (Model Context Protocol), le standard ouvert qui permet aux assistants IA de se connecter à des applications. Tout assistant compatible MCP peut donc se connecter, qu’il figure ou non dans les exemples de cette page.

1. Ouvrir la page de connexion #

  1. Connectez-vous à Kafinea
  2. Ouvrez le menu utilisateur, en haut à droite
  3. Choisissez Connecter mon assistant IA

Le même bouton figure dans Mes préférences. La page Connectez votre assistant IA à Kafinea présente les étapes propres à chaque assistant, l’adresse de connexion à copier et la liste de Vos assistants connectés.

Si la page indique que la connexion n’est pas encore activée pour votre espace, copiez la demande d’activation qu’elle propose et transmettez-la à votre administrateur ou à votre intégrateur.

2. Connecter votre assistant #

L’adresse de connexion est la même pour tous :

https://mcp.kafinea.com/mcp

Sur la page, choisissez votre assistant : ses étapes s’affichent, puis copiez l’adresse avec le bouton Copier l’adresse. Le principe est toujours le même :

  1. Dans les paramètres de votre assistant, ajoutez une connexion (souvent appelée « connecteur » ou « serveur MCP distant ») et collez l’adresse.
  2. Lancez la connexion depuis l’assistant : une page de connexion Kafinea s’ouvre.
  3. Connectez-vous avec votre compte Kafinea habituel, puis autorisez l’accès en choisissant les catégories d’opérations : consultation, modification, configuration.

Aucune clé ni aucun mot de passe n’est enregistré dans l’assistant. Les étapes par assistant :

  • Claude (web, bureau et mobile) : Paramètres > Connecteurs > Ajouter un connecteur personnalisé, nommez-le Kafinea et collez l’adresse, puis Se connecter. Dans une organisation, le propriétaire ajoute le connecteur une fois pour tous les membres ; chacun s’y connecte ensuite avec son propre compte Kafinea et ne voit que ses espaces.
  • ChatGPT : Paramètres > Applications et connecteurs > Créer (activez au besoin le mode développeur dans les paramètres avancés), collez l’adresse et choisissez l’authentification OAuth.
  • Copilot / VS Code : palette de commandes, MCP: Add Server, type HTTP, collez l’adresse et nommez le serveur kafinea ; la connexion Kafinea s’ouvre à la première question posée à Copilot en mode agent.
  • Cursor : Cursor Settings > Tools & MCP > New MCP Server, ajoutez le bloc proposé par la page, puis Connect.
  • En ligne de commande :
    • Claude Code : claude mcp add --transport http kafinea https://mcp.kafinea.com/mcp, puis /mcp pour vous connecter ;
    • Codex : codex mcp add kafinea --url https://mcp.kafinea.com/mcp, puis codex mcp login kafinea ;
    • Gemini CLI : gemini mcp add --transport http kafinea https://mcp.kafinea.com/mcp, puis /mcp auth kafinea dans une session pour vous connecter ;
    • autres assistants : ajoutez un serveur distant de type HTTP avec cette adresse ; l’assistant ouvre la connexion Kafinea au premier usage.
  • Tous les autres assistants compatibles MCP : Le Chat de Mistral, Microsoft Copilot Studio, Windsurf, JetBrains AI Assistant, Zed, Cline, Continue, Goose, OpenCode, n8n et bien d’autres se connectent de la même façon. Cherchez dans leurs paramètres l’ajout d’un « connecteur », d’un « serveur MCP » ou d’un « outil MCP » distant, de type HTTP, puis collez l’adresse.

Astuce : laissez votre assistant se configurer lui-même. Un assistant capable de modifier sa propre configuration (en ligne de commande ou dans un éditeur de code) peut faire l’installation pour vous. Donnez-lui simplement cette consigne : « Ajoute à ta configuration le serveur MCP distant Kafinea, à l’adresse https://mcp.kafinea.com/mcp (transport HTTP, connexion OAuth), puis lance la connexion. » Il vous reste à vous identifier avec votre compte Kafinea sur la page qui s’ouvre. Pour un assistant de discussion en ligne, demandez-lui plutôt la marche à suivre pour ajouter un connecteur MCP distant.

3. Tester la connexion #

  1. Demandez à l’assistant la liste de vos espaces Kafinea
  2. Posez ensuite une question sur l’un d’eux (par exemple : « Liste mes dernières factures »)
  3. L’assistant interroge l’espace choisi et affiche les résultats

Un espace inactif depuis un moment peut demander une minute de démarrage : l’assistant vous propose alors de réessayer.

4. Ce que vous pouvez demander #

L’assistant consulte, recherche et, si vous l’avez autorisé, modifie vos données avec les mêmes règles que les écrans de Kafinea. Quelques exemples :

  • « Quelles factures clients de ce mois sont encore impayées ? »
  • « Retrouve la fiche du client Durand et ses trois derniers devis. »
  • « Quel est le stock disponible de l’article Chaise pliante ? »
  • « Ajoute une tâche de relance sur cette affaire pour vendredi. »
  • « Qu’est-ce qui attend mon approbation ? » (voir les approbations)
  • « Quelle facture a généré ce bon de livraison et ses modifications sont-elles synchronisées ? » (voir la génération automatique des bons de livraison)
  • « Remplace la vis M6 par la vis M8 dans la composition de ce kit. » (voir les kits de produits)

L’assistant parcourt aussi les éléments liés à une fiche (contacts d’un client, lignes d’un document, documents rattachés) et crée ou modifie les liens entre éléments.

5. Plusieurs espaces, une seule connexion #

Avec l’adresse unique, l’assistant accède à tous les espaces Kafinea auxquels vous avez droit : production, sandbox, et espaces de vos différents clients si vous êtes intégrateur. La liste suit vos droits d’accès : un espace qui vous est ouvert plus tard devient accessible sans nouvelle configuration, et un espace qui vous est retiré ne l’est plus.

L’assistant commence par lister vos espaces, puis indique à chaque opération l’espace concerné. Une demande ne s’applique donc jamais à un autre espace que celui choisi.

Pour connecter un seul espace, utilisez plutôt son adresse propre : sur la page de connexion, ouvrez Limiter l’assistant à cet espace, sous l’adresse de connexion.

6. Sécurité #

  • Chaque opération s’exécute avec votre compte et vos droits dans l’espace concerné
  • Les catégories d’opérations autorisées (consultation, modification, configuration) limitent ce que l’assistant peut faire, quels que soient vos droits
  • La section Vos assistants connectés de la page de connexion liste vos connexions ; la révocation d’une connexion à adresse unique, signalée par Tous vos espaces, s’applique à tous vos espaces
  • Un accès retiré à votre compte s’applique à l’assistant en quelques minutes

FAQ #

Qu’est-ce que MCP ?
MCP (Model Context Protocol) est un protocole standard qui permet aux assistants IA de se connecter à des serveurs d’outils. Kafinea expose un serveur MCP qui donne accès à vos données de manière sécurisée, en respectant les droits d’accès de l’utilisateur connecté. Tout assistant compatible MCP peut donc se connecter à Kafinea.

Faut-il une connexion par espace ?
Non. L’adresse unique https://mcp.kafinea.com/mcp donne accès à tous vos espaces avec une seule connexion. Une adresse propre à un espace reste disponible, sous Limiter l’assistant à cet espace, si vous souhaitez limiter l’assistant à celui-ci.

Un nouvel espace m’a été ouvert, que faire ?
Rien : demandez à l’assistant la liste de vos espaces, il y figure dans les minutes qui suivent.

L’assistant me demande de me reconnecter
Votre connexion a été révoquée ou a expiré. Relancez la connexion depuis l’assistant et autorisez à nouveau l’accès.

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

Puis-je encore utiliser une clé d’accès ?
Oui, pour les scripts et les outils qui ne savent pas ouvrir une connexion avec le compte Kafinea. La configuration correspondante se trouve dans la section Intégration technique (clé d’accès) de la page de connexion ; la clé reste masquée tant que vous ne cliquez pas sur Afficher la clé, et ne donne accès qu’à cet espace. Préférez la connexion avec votre compte : aucune clé n’est stockée dans l’outil et chaque assistant connecté se révoque individuellement.

Références associées #