# Connecter Claude, ChatGPT et d’autres agents IA > Connectez Claude, Claude Code, ChatGPT, OpenClaw ou tout client MCP à vos livres — connectez-vous, approuvez l’accès, puis demandez rapports et documents. Canonical: https://docs.getonebooks.com/fr/ai/mcp/ Language: fr Documentation index: https://docs.getonebooks.com/fr/llms.txt 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é**. > **L’adresse du serveur** > `https://api.getonebooks.com/mcp` — Streamable HTTP avec connexion OAuth. Aucune clé d’API à copier. ## 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 - 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 seul un **propriétaire** ou un **administrateur** peut proposer des encaissements. - 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 À la première connexion d’un client, OneBooks ouvre son écran de connexion et de consentement. 1. Connectez-vous avec votre e-mail et votre mot de passe OneBooks si ce n’est pas déjà fait. 2. Vérifiez l’entreprise indiquée à l’écran : l’accès n’est accordé que pour votre **entreprise active**. 3. Passez en revue ce que l’application pourra faire, puis sélectionnez **Approuver** (ou **Refuser**). ![L’écran de consentement OneBooks pour Claude, avec les autorisations demandées et les boutons Approuver et Refuser](https://docs.getonebooks.com/screenshots/fr/integrations-oauth-consent.webp) Changer d’entreprise active dans OneBooks met fin à la connexion ; reconnectez-vous et donnez votre consentement pour la nouvelle entreprise. ## Claude Les 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. 1. 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**. 2. 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’enregistre lui-même. 3. Sélectionnez **Connecter** et approuvez l’accès sur l’écran OneBooks. 4. Dans une conversation, ouvrez le menu **+**, choisissez **Connecteurs** et activez OneBooks. Demandez ensuite : « Quelle est ma position de trésorerie ? » ## Claude Code Enregistrez le serveur une seule fois pour tous vos projets, puis connectez-vous depuis le panneau `/mcp` : ```bash claude mcp add --transport http onebooks --scope user https://api.getonebooks.com/mcp ``` Dans 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 Les serveurs MCP personnalisés dans ChatGPT exigent le **mode développeur**, disponible dans les formules Plus, Pro, Business, Enterprise et Edu (un administrateur de l’espace de travail doit parfois l’autoriser au préalable). Configurez-le une fois sur le Web ; le connecteur appartient à votre compte ChatGPT. 1. Ouvrez **Paramètres → Applications** (appelé **Connecteurs** dans certaines formules), puis **Paramètres avancés**, et activez le **mode développeur**. 2. Sélectionnez **Créer**, nommez-le OneBooks, saisissez `https://api.getonebooks.com/mcp`, choisissez **OAuth** comme authentification et confirmez que vous faites confiance au fournisseur. 3. Approuvez l’accès sur l’écran OneBooks. 4. Dans une nouvelle conversation, sélectionnez **+ → Plus → Mode développeur**, activez OneBooks pour cette conversation, et posez vos questions. Sans le mode développeur, ChatGPT n’utilise que deux outils en lecture seule — **search** et **fetch** — qui trouvent et citent vos factures, achats, clients, fournisseurs et articles, par exemple dans une recherche approfondie. Les rapports et la rédaction de documents exigent le mode développeur. ## OpenClaw OpenClaw est un agent personnel open source qui s’exécute sur votre propre machine et vous parle à travers vos applications de messagerie. 1. Ouvrez **Paramètres → MCP**, sélectionnez **Ajouter un serveur**, nommez-le `onebooks`, choisissez le transport **Streamable HTTP** et saisissez `https://api.getonebooks.com/mcp`. 2. Réglez l’authentification du serveur sur OAuth (l’entrée de configuration est présentée ci-dessous). 3. 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 `--code` qu’il affiche. 4. `openclaw mcp status --verbose` confirme la connexion. Dans le fichier de configuration d’OpenClaw, l’entrée du serveur se présente ainsi : ```json5 { mcp: { servers: { onebooks: { url: "https://api.getonebooks.com/mcp", transport: "streamable-http", enabled: true, auth: "oauth", }, }, }, } ``` ## 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 : ```json { "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 Exactement ce que fait l’assistant intégré : [rapports et recherches](https://docs.getonebooks.com/fr/ai/reports/), réponses tirées de cette documentation et [propositions](https://docs.getonebooks.com/fr/ai/drafting/) de factures, d’achats, de charges, d’encaissements, de clients et de fournisseurs. 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. Chaque proposition apparaît aussi dans l’assistant intégré, où vous pouvez la confirmer ou l’annuler vous-même. Il n’existe aucun outil de suppression, d’annulation, de modification ni de remboursement pour aucun agent. ## Gérer et révoquer l’accès **Applications → Applications**, avec le filtre **Applications**, 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. ![La page Applications filtrée sur les applications connectées, avec les cartes Claude et ChatGPT](https://docs.getonebooks.com/screenshots/fr/integrations-mcp-card.webp) 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é. ![Le panneau de l’application connectée Claude, avec ses autorisations et le bouton Révoquer l’accès](https://docs.getonebooks.com/screenshots/fr/integrations-connected-app-detail.webp) ## Limites 120 requêtes par minute et par adresse, un plafond hebdomadaire d’appels par entreprise, et l’allocation hebdomadaire de crédits partagée. Voir [Crédits et limites](https://docs.getonebooks.com/fr/ai/credits/). ## 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 exigent un propriétaire ou un administrateur, et ChatGPT exige le mode développeur pour tout ce qui va au-delà de search et fetch. - **L’agent signale des crédits épuisés** — l’allocation se renouvelle chaque semaine ; voir [Crédits et limites](https://docs.getonebooks.com/fr/ai/credits/). - **OpenClaw n’affiche rien après Approuver** — le navigateur n’a pas pu joindre son rappel local ; exécutez la commande `--code` affichée dans le terminal. ## 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. ## Voir aussi - [Sécurité, confidentialité et limites](https://docs.getonebooks.com/fr/ai/safety/) - [Applications connectées et OAuth](https://docs.getonebooks.com/fr/integrations/connected-apps/)