> ## Documentation Index > Fetch the complete documentation index at: https://api-doc.fidly.be/llms.txt > Use this file to discover all available pages before exploring further. # Connecter votre IA (MCP) > Laisser Claude, ChatGPT ou un autre assistant IA chercher, résumer et préparer votre facturation dans Fidly. Fidly a un serveur MCP : un assistant IA qui accepte les connecteurs MCP (Claude, ChatGPT, Claude Desktop…) peut travailler sur les données de votre entreprise en langage naturel — « quelles factures de Dupont sont impayées ? », « combien ai-je facturé ce trimestre ? », « prépare une facture pour 3 jours de conseil chez Martin ». Vos intégrations logicielles continuent d'utiliser l'API REST. La connexion MCP est disponible pour les entreprises qui ont accès à l'API Fidly. ## Ajouter Fidly à votre IA Dans votre assistant IA, ajoutez un connecteur personnalisé (aussi appelé serveur MCP) avec cette URL : ``` https://api.fidly.be/mcp ``` Aucune clé ni aucun secret : l'assistant ouvre une page Fidly dans votre navigateur, où vous vous connectez et l'autorisez. ## Écran de consentement La page affiche : * le **nom que l'assistant se donne** — choisi par l'assistant, il ne prouve donc pas son identité ; * l'**adresse vers laquelle vous serez renvoyé** après votre décision (`claude.ai`, `chatgpt.com`, `localhost` pour une application de bureau…). Vérifiez que c'est celle de votre assistant ; * un **avertissement** quand Fidly ne reconnaît pas l'assistant. Ne l'autorisez que si vous avez vous-même ajouté Fidly à cet assistant. Vous choisissez ensuite l'entreprise et les droits, puis cliquez sur **Autoriser**. Vous avez **10 minutes** depuis l'ouverture de la page par l'assistant ; au-delà, recommencez la connexion depuis votre assistant. Seuls les utilisateurs qui peuvent créer des identifiants API pour une entreprise peuvent y autoriser une IA. Chaque autorisation crée une nouvelle connexion : connecter deux fois le même assistant donne deux connexions, et vous pouvez révoquer celle qui ne sert plus. ## Droits Les droits d'une connexion fonctionnent comme ceux d'un client d'API : pour chaque ressource, chaque action — créer, lire, modifier, supprimer — est autorisée ou non. L'assistant ne voit que les outils que ses droits permettent. * Avec **lire les documents** seul, un document montre le nom de sa relation et rien d'autre d'elle. Trouver une relation par son nom demande **lire les relations**. * **Modifier les documents** permet d'envoyer un document sur Peppol, ce qui est irréversible. * Les droits sans outil pour l'instant (comptes bancaires, journaux, identités visuelles, toute suppression) sont aujourd'hui sans effet ; ils s'appliqueront quand des outils arriveront, sans reconnexion. * Une connexion travaille toujours sur les données réelles de votre entreprise : pas de sandbox pour les connexions IA. ## Révoquer une connexion Les connexions IA apparaissent dans la liste des accès API de votre entreprise dans Fidly, avec leur nom, l'utilisateur qui les a autorisées et leur dernière activité. Une connexion reste active jusqu'à sa révocation, même si l'assistant ne sert plus. **Révoquer** prend effet immédiatement : la requête suivante de l'assistant est refusée. **Changer les droits** : un outil dont le droit est retiré est refusé dès l'appel suivant de l'assistant ; un outil dont le droit est ajouté apparaît quand l'assistant relit sa liste d'outils, en pratique dans une nouvelle conversation. Pour vous reconnecter après une révocation, ajoutez à nouveau la connexion depuis votre assistant. ## Outils | Outil | Ce qu'il fait | Droits requis | | - | - | - | | `find_relations` | Trouve clients, fournisseurs et contacts par nom, alias, numéro de TVA ou identifiant | lire les relations | | `relation_overview` | La fiche d'une relation ; avec lire les documents, aussi ce qu'elle doit encore et ce qui lui est dû, et ses 5 derniers documents | lire les relations (+ lire les documents) | | `search_documents` | Trouve factures, notes de crédit et proformas, avec les totaux de tous les résultats | lire les documents | | `get_document` | Le détail d'un document, lignes comprises | lire les documents | | `get_document_file` | Le PDF d'un document, ou son XML Peppol | lire les documents | | `summarize_documents` | Chiffres des ventes ou des achats sur une période, par mois, relation, statut de paiement ou type | lire les documents | | `create_document` | Crée une facture, une note de crédit ou une proforma | créer des documents | | `update_document` | Corrige un document qui n'a pas encore été envoyé | modifier les documents | | `send_document` | Envoie un document sur Peppol | modifier les documents | | `create_relation` | Crée une entreprise ou un contact | créer des relations | | `update_relation` | Corrige une relation | modifier les relations | Non disponibles via l'IA : la suppression, l'import de documents, les pièces jointes, les comptes bancaires, les journaux et les identités visuelles. ### Relations par leur nom Partout où un outil prend une relation, l'assistant peut donner son identifiant ou son nom. Quand plusieurs relations correspondent à un nom, l'outil renvoie les candidates (identifiant, nom, numéro de TVA) et l'assistant vous demande laquelle. ### Totaux `search_documents`, `summarize_documents` et `relation_overview` comptent par **sens** : ventes (factures et notes de crédit de vente) et achats (factures et notes de crédit d'achat), qu'ils soient émis dans Fidly ou reçus. Dans tout total : * les notes de crédit sont soustraites ; * les proformas, les autres documents et les documents supprimés ou masqués en comptabilité ne sont pas comptés ; * les montants sont donnés par devise ; * « en retard » signifie échéance passée et montant encore dû. `search_documents` renvoie jusqu'à 50 documents par appel, du plus récent au plus ancien ; ses `sums` portent sur tous les résultats, par sens et par devise. `summarize_documents` couvre au plus 366 jours par appel. Groupé par relation, il renvoie les 20 plus grosses relations par devise, puis une ligne par devise qui additionne le reste (`key: "others"`, libellé « Other relations (N) »). ### Détail d'un document `get_document` renvoie le document comme l'API, sans ses pièces jointes. Sa relation n'est donnée que par son identifiant et son nom (`relation_id`, `relation_name`). `get_document_file` renvoie un lien de téléchargement du PDF du document, ou de son XML Peppol avec `format: "xml"`. Le lien est valable 15 minutes et fonctionne pour quiconque le détient ; passé ce délai, l'assistant en demande un nouveau. Un document qui vient d'être créé ou corrigé n'a son fichier que quelques instants plus tard. ### Créer un document `create_document` crée par défaut une facture de vente, et une proforma seulement si vous demandez un brouillon ou une proforma. Il prend la relation, les lignes (article, quantité, prix unitaire, code TVA…) et, en option, la date d'émission, les conditions de paiement, le journal, le numéro de commande, la référence acheteur et la devise. Le document est **numéroté à la création**. Il ne peut être supprimé que s'il est le dernier de sa séquence, n'a pas été envoyé, n'est pas passé en comptabilité et n'est lié à rien ; dès qu'une autre facture le suit, une erreur se corrige par une note de crédit. Rien n'est envoyé, et le PDF est produit quelques instants plus tard. ### Corriger un document `update_document` prend l'identifiant du document et seulement les champs à changer (`changes`), sous la forme de la modification de document de l'API. Les lignes envoyées **remplacent** toutes les lignes : pour en ajouter une, l'assistant relit le document et renvoie toutes ses lignes avec la nouvelle. Les montants sont recalculés, le numéro ne change pas et le PDF est régénéré quelques instants plus tard. Un document envoyé (mail ou Peppol) ou passé en comptabilité ne peut plus être corrigé : une note de crédit le corrige. Le type et le journal ne changent jamais. ### Envoyer un document `send_document` envoie sur Peppol un document émis dans Fidly. L'assistant a pour consigne de vous demander confirmation d'abord : un document envoyé ne peut plus être corrigé ni supprimé. L'envoi est asynchrone : l'outil répond `{"status": "handed_over", "document": …}` quand l'envoi est accepté, et le statut Peppol du document change une fois le réseau passé. ### Créer et corriger une relation `create_relation` prend la relation sous la forme de la création de relation de l'API (`relation` : type, nom ou prénom, adresse avec son pays…). Une entreprise dont le numéro de TVA, l'identifiant ou l'adresse électronique est déjà porté par une autre relation est refusée, avec l'identifiant de cette relation. `update_relation` prend la relation (identifiant ou nom) et seulement les champs à changer (`changes`) ; le type de la relation ne peut pas changer. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.