Connecter des outils d’IA (MCP)
Utiliser BizCortex depuis Claude, ChatGPT, Cursor et d’autres outils d’IA grâce au Model Context Protocol.
MCP (Model Context Protocol) est un standard ouvert qui permet à des outils d’IA comme Claude, ChatGPT ou Cursor de travailler avec d’autres programmes. BizCortex propose deux serveurs MCP.
Le serveur de l’entreprise, à l’adresse https://app.bizcortex.de/api/v1/mcp, travaille avec les données de votre entreprise. Il se connecte avec une clé API, et le rôle de cette clé détermine ce que l’outil d’IA peut voir et faire. Il nécessite le pack Brain, et Brain doit être activé dans les paramètres de Brain.
Le serveur de documentation, à l’adresse https://docs.bizcortex.de/mcp, met cette documentation à la disposition des outils d’IA dans les sept langues. Il est public et ne demande aucune clé.
Qui peut l’utiliser
- Propriétaire
- Administrateur
Étapes
1. Créer une clé API
Ouvrez "Paramètres" puis l’onglet "Clés API". Cliquez sur "Créer une clé", donnez à la clé un nom comme "Claude" et choisissez le plus petit rôle dont l’outil d’IA a besoin. Copiez la clé, elle n’est affichée qu’une seule fois.
2. Copier la configuration de votre outil
Sous le tableau des clés, la carte "Connecter via MCP" affiche le point de terminaison et une configuration prête à l’emploi pour Claude Code, Claude Desktop et Cursor. Ouvrez l’onglet de votre outil, cliquez sur le bouton de copie et remplacez le paramètre ak_… par votre clé.
3. Autres outils d’IA
Dans tout autre client MCP, ajoutez un serveur distant avec l’adresse du point de terminaison et l’en tête Authorization avec la valeur Bearer, suivie d’un espace et de votre clé.
4. Interroger l’outil d’IA
Posez vos questions avec vos propres mots, par exemple "Quelles factures sont en retard ?" ou "Crée un client nommé Exemple SARL". L’outil d’IA trouve les fonctions de BizCortex que sa clé peut utiliser, lit les données directement et prépare chaque modification sous forme de proposition.
5. Confirmer les modifications dans Brain
L’outil d’IA n’exécute jamais lui même une modification (créer, modifier, supprimer, envoyer ou approuver). La proposition apparaît dans Brain, dans la conversation "MCP · <nom de la clé>", et l’outil d’IA reçoit un lien vers elle. La personne qui a créé la clé l’ouvre et clique sur "Confirmer" ou "Refuser". L’outil d’IA peut ensuite consulter le résultat.
Champs et options
- Serveur de l’entreprise
https://app.bizcortex.de/api/v1/mcp. Nécessite une clé API. Lit les données, recherche des enregistrements et propose des modifications.
- Serveur de documentation
https://docs.bizcortex.de/mcp. Public, sans clé. Recherche dans cette documentation, lit une page et liste le sommaire.
Conseils
- Créez une clé distincte pour chaque outil d’IA. Vous pourrez ainsi en révoquer une sans toucher aux autres.
- Une clé avec le rôle Lecteur suffit pour poser des questions sur vos données. Une clé qui doit proposer des modifications a besoin d’un rôle autorisé à les faire.
- Ajoutez aussi le serveur de documentation, pour que l’outil d’IA puisse également expliquer le fonctionnement de BizCortex.
Bon à savoir
- Les connexions personnelles ne sont pas acceptées. Le serveur de l’entreprise fonctionne uniquement avec des clés API.
- Par défaut, une proposition expire au bout de 30 minutes si personne ne la confirme.
- Chaque appel figure dans le journal d’audit, marqué comme effectué via MCP.
- Chaque clé peut effectuer jusqu’à 60 appels par minute.
- Révoquer la clé déconnecte immédiatement l’outil d’IA.
Voir aussi
- Clés API
Des clés qui permettent à d’autres programmes d’accéder aux données de votre entreprise via l’API REST.
- Confirmer les propositions de Brain
Fonctionnement des modifications proposées : cartes de confirmation, statuts, expiration et étape de sécurité supplémentaire.
- Paramètres de Brain
Activez ou désactivez Brain pour l’entreprise, choisissez le modèle, définissez le budget et contrôlez les données RH.