Connecter Claude, ChatGPT et d’autres agents IA
OneBooks exploite un serveur MCP (Model Context Protocol), afin que les agents IA que vous utilisez déjà puissent travailler sur vos livres : obtenir des rapports, consulter des fiches, chercher dans cette documentation et préparer des documents que vous confirmez. Ils reçoivent exactement les outils dont dispose l’assistant intégré, sous la même règle — rien n’est écrit tant qu’une personne ne l’a pas approuvé.
Un agent d’IA intégré à votre navigateur, comme celui de l’application de bureau ChatGPT, peut aussi utiliser OneBooks sans rien connecter — consultez Agents d’IA dans votre navigateur (WebMCP).
Choisissez votre client
Section intitulée « Choisissez votre client »Cursor, VS Code, MCP Inspector et les agents personnalisés se connectent de la même façon — voir la section consacrée aux autres clients MCP, plus bas.
Ce qu’il vous faut
Section intitulée « Ce qu’il vous faut »- Un compte OneBooks. L’agent hérite de votre rôle : un lecteur obtient des outils en lecture seule, un membre peut proposer des documents, et par défaut seul un propriétaire ou un administrateur peut proposer des encaissements, des paiements fournisseurs, leurs affectations, des virements internes, des écritures comptables, des modifications de comptes et des budgets. Proposer de modifier la fiche d’un client ou d’un fournisseur exige l’autorisation de gérer les clients ou les fournisseurs, dont chaque membre dispose par défaut.
- Claude et ChatGPT atteignent OneBooks depuis leurs propres serveurs ; Claude Code et OpenClaw se connectent depuis votre ordinateur. Dans tous les cas, le client se connecte par l’écran de consentement décrit ci-dessous — jamais avec une clé collée.
Approuver l’accès
Section intitulée « Approuver l’accès »À la première connexion d’un client, OneBooks ouvre son écran de connexion et de consentement.
- Connectez-vous avec votre e-mail et votre mot de passe OneBooks si ce n’est pas déjà fait.
- Vérifiez l’entreprise indiquée à l’écran : l’accès n’est accordé que pour votre entreprise active.
- Passez en revue ce que l’application pourra faire, puis sélectionnez Approuver (ou Refuser).

Changer d’entreprise active dans OneBooks met fin à la connexion ; reconnectez-vous et donnez votre consentement pour la nouvelle entreprise.
Claude sur le Web et Claude DesktopLes connecteurs personnalisés sont disponibles dans toutes les formules Claude (la formule gratuite en autorise un). Claude se connecte à OneBooks depuis les serveurs d’Anthropic : un connecteur ajouté une fois fonctionne aussi bien dans le navigateur que dans Claude Desktop.
- Ouvrez Personnaliser → Connecteurs. Dans les formules Team et Enterprise, c’est un propriétaire qui l’ajoute dans Paramètres de l’organisation → Connecteurs → Ajouter → Personnalisé ; les membres sélectionnent ensuite Connecter.
- Sélectionnez Ajouter un connecteur personnalisé, nommez-le OneBooks et saisissez
https://api.getonebooks.com/mcp. Laissez vides les champs OAuth avancés — Claude s’identifie automatiquement auprès de OneBooks. - Sélectionnez Connecter et approuvez l’accès sur l’écran OneBooks.
- Dans une conversation, ouvrez le menu +, choisissez Connecteurs et activez OneBooks. Demandez ensuite : « Quelle est ma position de trésorerie ? »
Claude Code
Section intitulée « Claude Code »Enregistrez le serveur une seule fois pour tous vos projets, puis connectez-vous depuis le panneau /mcp :
claude mcp add --transport http onebooks --scope user https://api.getonebooks.com/mcpDans Claude Code, exécutez /mcp, choisissez onebooks et terminez la connexion dans le navigateur. claude mcp list affiche la connexion et claude mcp remove onebooks la supprime. Claude Code s’identifie au moyen d’un document de métadonnées client : il n’y a donc rien à enregistrer.
ChatGPT ajoute OneBooks comme serveur MCP personnalisé — le parcours autrefois appelé mode développeur. Sa disponibilité dépend de votre formule ChatGPT et, dans un espace de travail, un administrateur doit parfois autoriser les connecteurs personnalisés au préalable. Configurez-le une fois sur le Web ; le connecteur appartient à votre compte ChatGPT.
- Ouvrez Paramètres → Connecteurs et sélectionnez Ajouter un serveur MCP personnalisé.
- Nommez-le OneBooks, saisissez
https://api.getonebooks.com/mcp, choisissez OAuth comme authentification et confirmez que vous faites confiance au fournisseur. - Approuvez l’accès sur l’écran OneBooks.
- Dans une nouvelle conversation, ouvrez le menu +, activez OneBooks pour cette conversation, et posez vos questions.
Pour la recherche et la recherche approfondie, ChatGPT utilise deux outils en lecture seule — search et fetch — qui trouvent et citent vos factures, achats, clients, fournisseurs et articles, dans la limite des fiches que votre rôle permet de voir. Les rapports et la rédaction de documents utilisent les autres outils dans une conversation où OneBooks est activé.
OpenClaw
Section intitulée « OpenClaw »OpenClaw est un agent personnel open source qui s’exécute sur votre propre machine et vous parle à travers vos applications de messagerie.
- Ouvrez Paramètres → MCP, sélectionnez Ajouter un serveur, nommez-le
onebooks, choisissez le transport Streamable HTTP et saisissezhttps://api.getonebooks.com/mcp. - Réglez l’authentification du serveur sur OAuth (l’entrée de configuration est présentée ci-dessous).
- Exécutez
openclaw mcp login onebooks. Le navigateur ouvre l’écran de consentement OneBooks et OpenClaw enregistre les jetons ; si le navigateur ne parvient pas à joindre le rappel d’OpenClaw, utilisez la commande--codequ’il affiche. openclaw mcp status --verboseconfirme la connexion.
Dans le fichier de configuration d’OpenClaw, l’entrée du serveur se présente ainsi :
{ mcp: { servers: { onebooks: { url: "https://api.getonebooks.com/mcp", transport: "streamable-http", enabled: true, auth: "oauth", }, }, },}Autres clients MCP
Section intitulée « Autres clients MCP »Tout client compatible avec Streamable HTTP et OAuth 2.0 avec PKCE peut se connecter — Cursor, VS Code, Windsurf, MCP Inspector, agents personnalisés. Lorsque le client utilise un fichier de configuration, l’entrée est la suivante :
{ "mcpServers": { "onebooks": { "type": "http", "url": "https://api.getonebooks.com/mcp" } }}Le client découvre le serveur de connexion, s’enregistre (ou présente son document de métadonnées client) et ouvre l’écran de consentement.
Ce que l’agent peut faire
Section intitulée « Ce que l’agent peut faire »Exactement ce que fait l’assistant intégré : rapports et recherches, réponses tirées de cette documentation et propositions de devis, de factures, d’avoirs et de notes de débit, d’achats, de charges, d’encaissements, de paiements fournisseurs et de leurs affectations, de virements internes, d’écritures comptables, de rapprochements bancaires, de budgets, de comptes, d’articles, de clients et de fournisseurs — y compris la transformation d’un devis en facture, l’envoi d’une facture en brouillon ou la finalisation d’un achat en brouillon — ainsi que la modification d’une facture ou d’un achat en brouillon, d’un article, d’un compte, des montants d’un budget ou de la fiche d’un client ou d’un fournisseur.
Ici aussi, l’écriture se fait en deux temps. L’agent demande à OneBooks de préparer le document ; OneBooks enregistre une proposition et renvoie un aperçu, que l’agent vous montre. Ce n’est qu’après votre approbation de cet aperçu précis que l’agent confirme la proposition — jamais dans le même tour, une seule fois, et dans un délai de 24 heures. Une proposition que vous n’approuvez pas n’est jamais exécutée ; elle expire d’elle-même au bout de 24 heures. Il n’existe aucun outil de suppression, d’annulation ni de remboursement pour aucun agent, et les seuls outils de modification portent sur une facture ou un achat en brouillon, un article, un compte, les montants d’un budget ou la fiche d’un client ou d’un fournisseur — jamais sur un document comptabilisé ni sur des coordonnées bancaires.
Gérer et révoquer l’accès
Section intitulée « Gérer et révoquer l’accès »Applications → Intégrations, avec le filtre Applications connectées, liste les clients IA connectés à votre entreprise, chacun avec son nom et sa marque, la date d’autorisation et la date de dernière utilisation.

Sélectionnez une carte pour voir ce que l’application peut faire et pour Révoquer l’accès. Ses jetons cessent aussitôt de fonctionner ; rien de ce qu’elle a déjà créé n’est supprimé.

300 requêtes par minute pour chaque client IA connecté à votre entreprise, un plafond hebdomadaire d’appels par entreprise, et la dotation hebdomadaire de crédits IA de votre formule — 100 crédits en formule gratuite, 400 en Standard, 1 200 en Professional et 3 000 en Premium —, partagée avec l’assistant intégré. Voir Crédits et limites.
Dépannage
Section intitulée « Dépannage »- L’écran de consentement indique la mauvaise entreprise — changez d’abord d’entreprise active dans OneBooks, puis reconnectez-vous.
- Le client a cessé de fonctionner après un changement d’entreprise — c’est normal ; reconnectez-vous et donnez votre consentement pour la nouvelle entreprise.
- Des outils manquent — un lecteur n’obtient que les outils de lecture, les encaissements, paiements, affectations, virements internes, écritures comptables, modifications de comptes et propositions de budgets (
create_budget,update_budget_lines) exigent par défaut un propriétaire ou un administrateur, la modification d’un client ou d’un fournisseur exige l’autorisation de les gérer, et dans ChatGPT OneBooks doit être activé pour la conversation. Un client connecté avant l’ajout des devis, des retours, des écritures comptables et du rapprochement bancaire (octobre 2026) ne les voit qu’après une nouvelle connexion et une approbation unique des nouvelles autorisations. Les outils de budgets ont été ajoutés le 15 octobre 2026 : un client connecté avant cette date ne les voit qu’après une nouvelle connexion et une approbation unique de leurs autorisations, car une connexion existante garde les autorisations déjà approuvées. - L’agent signale des crédits épuisés — la dotation se renouvelle tous les 7 jours à partir du moment où votre entreprise s’est inscrite ; voir Crédits et limites.
- OpenClaw n’affiche rien après Approuver — le navigateur n’a pas pu joindre son rappel local ; exécutez la commande
--codeaffichée dans le terminal.
Pour les développeurs
Section intitulée « Pour les développeurs »Vous construisez votre propre client MCP ou votre propre intégration ? La documentation pour développeurs, sur developer.getonebooks.com, couvre OAuth, les portées, l’enregistrement dynamique, les documents de métadonnées client et la référence de l’API.