Brancher un assistant sur Heelio
Posez vos questions de trésorerie à ChatGPT ou à Claude, et laissez-les lire vos vrais chiffres. En lecture seule, sur les entreprises que vous choisissez.
Ce que fait le connecteur
Il donne à votre assistant accès en lecture seule aux chiffres de votre entreprise, ceux que vous voyez déjà dans Heelio. Ses 13 outils lisent vos chiffres et ne modifient rien, dans Heelio comme dans votre comptabilité. Aucun ne déclenche de paiement.
Vos entreprises
entreprises
Celles que l'assistant peut lire, avec leur identifiant
Point de trésorerie
point_de_tresorerie
Solde, variation du mois, trésorerie devant vous, résultat
Solde de trésorerie
solde_tresorerie
Solde consolidé, épargne, date de dernière mise à jour
Prévisionnel
previsionnel_tresorerie
La courbe mois par mois, jusqu'à 24 mois, encaissements et décaissements attendus
Compte de résultat
compte_de_resultat
L'exercice en cours par agrégat, réalisé et prévu
Factures impayées
factures_impayees
Par tranche d'échéance, à encaisser comme à payer
Recherche de factures
factures
Par client, par fournisseur, par numéro, par période
Recherche de mouvements
transactions
Dans les libellés bancaires et les catégories
Sources
sources
L'état de vos sources et leur dernière mise à jour
Alertes
alertes
Ce que Heelio a repéré : source coupée, découvert prévu, facture échue
Plan de relance des impayés
analyser_impayes
Qui relancer en priorité, scénarios de recouvrement et brouillons de relance. Rien n'est envoyé.
Données disponibles pour une analyse
decrire_donnees
Les dimensions, les opérations et les dates disponibles avant une analyse croisée
Analyse croisée des données
interroger_donnees
Vos chiffres agrégés par mois, par catégorie ou par tiers, en tableau ou en graphique
Ce qu'il vous faut
- Un compte Heelio actif, alimenté par au moins une source : votre comptabilité, connectée ou importée, vos comptes bancaires ou vos factures. Sans source, les outils n'ont aucun chiffre à rendre.
- Pour l'autorisation, n'importe quel rôle suffit, Lecture seule compris. La clé d'accès, elle, est réservée aux administrateurs.
- Un assistant qui accepte les serveurs MCP distants.
Le branchement
L'adresse à coller, dans tous les cas :
https://mcp.heelio.io/mcpChatGPT
- Paramètres, puis Apps, puis Paramètres avancés : activez le mode développeur.
- Connecteurs, puis Ajouter un connecteur personnalisé.
- Nom : Heelio. URL : celle ci-dessus. Authentification : OAuth.
Claude
- Réglages, puis Connecteurs.
- Ajouter un connecteur personnalisé.
- Collez l'adresse ci-dessus.
Cursor, Claude Code et les autres clients qui acceptent une clé
Si votre client gère l'autorisation OAuth, préférez-la : elle seule ouvre plusieurs entreprises et les groupes. Sinon, un administrateur de l'entreprise ouvre dans Heelio le menu Intégrations, puis Mes intégrations, bloc Claude et ChatGPT, et copie l'adresse du serveur et la clé d'accès. Posez la clé en en-tête Authorization: Bearer.
- Il existe une clé par entreprise. Elle ne lit que cette entreprise, jamais un groupe.
- La clé n'expire pas. Un administrateur la coupe par Régénérer la clé : les assistants branchés avec l'ancienne cessent de répondre. Supprimer coupe la clé et retire aussi l'entreprise de tous les assistants branchés.
- Gardez-la secrète : elle suffit à lire les chiffres de l'entreprise.
L'autorisation
Au branchement, votre assistant ouvre une page de Heelio sur app.heelio.io. Vous vous connectez, puis vous cochez les entreprises que l'assistant pourra lire, ou « Ajouter automatiquement les prochaines entreprises » pour qu'il lise aussi celles que vous rejoindrez. Il demande une seule permission, la lecture. Une demande sur une entreprise hors de cet accès échoue sans rendre de chiffre.
L'autorisation repose sur OAuth avec PKCE. Tout membre d'une entreprise peut autoriser un assistant, quel que soit son rôle, pour les seules entreprises auxquelles il a accès.
Le jeton d'accès remis à l'assistant vaut une heure. L'assistant le renouvelle sans nouvelle autorisation tant qu'il s'en sert au moins une fois tous les 30 jours ; chaque renouvellement remplace le précédent.
Pour retirer une entreprise, ouvrez dans Heelio le menu Intégrations, puis Mes intégrations, bloc Claude et ChatGPT. La personne qui a branché l'assistant peut y changer les entreprises qu'il lit ; il doit en rester au moins une. Un administrateur peut retirer son entreprise de tous les assistants branchés par Supprimer, qui supprime aussi la clé. Une entreprise retirée de l'accès cesse d'être lisible dès la question suivante, sans attendre l'expiration du jeton. Pour débrancher l'assistant, déconnectez Heelio dans ses réglages.
Des questions qui marchent
| Ce que vous demandez | Ce que l'assistant lit |
|---|---|
| « Quel est mon solde de trésorerie ? » | Solde consolidé, épargne, fraîcheur des comptes |
| « Est-ce que je tiens jusqu’en mars ? » | Le prévisionnel mois par mois |
| « Montre-moi mon compte de résultat » | L'exercice en cours, réalisé et prévu |
| « Qui ne m’a pas payé ? » | Les impayés par tranche d'échéance |
| « Qui dois-je relancer en priorité ? » | Le plan de relance des impayés, avec des brouillons de relance |
| « Est-ce que Untel m’a réglé ? » | La recherche dans les factures |
| « Combien j’ai dépensé chez X ? » | La recherche dans les mouvements bancaires |
| « Comment évoluent mes charges par catégorie depuis un an ? » | L'analyse croisée, par mois et par catégorie |
| « Mes banques sont-elles connectées ? » | L'état des sources et la dernière mise à jour |
| « Qu’est-ce qui cloche en ce moment ? » | Les alertes du panneau Notifications |
Si vous avez plusieurs entreprises, nommez celle qui vous intéresse : « le solde de Brémontel ». Sinon, l'assistant vous demande laquelle ou liste celles auxquelles il a accès.
Les limites à connaître
Lecture seule.
Chaque outil est en lecture seule. Le connecteur ne modifie aucune donnée dans Heelio et ne déclenche aucun paiement ni virement. Le plan de relance rédige des brouillons et n'envoie aucun message.
Une clé ne lit pas un groupe.
Avec une clé, la lecture d'un groupe est refusée : la consolidation se lit par l'autorisation décrite plus haut. Celle-ci est liée à votre compte Heelio et à vos droits sur chaque société du groupe.
Sur un groupe, les chiffres se lisent au niveau du groupe.
Le point de trésorerie, le solde, le prévisionnel et le compte de résultat se lisent au niveau du groupe. Le point de trésorerie et le prévisionnel donnent aussi le solde société par société, et le point d'un groupe rend le chiffre d'affaires et le résultat de l'exercice en cours. L'analyse croisée additionne les sociétés avant élimination des flux internes ; comme le compte de résultat, elle refuse un groupe tenu en plusieurs monnaies.
Les recherches rendent 50 lignes au maximum.
Pour aller plus loin, précisez le client, le fournisseur ou la période. Les alertes s'arrêtent à 30, le prévisionnel à 24 mois et l'analyse croisée à cinq ans.
La fraîcheur dépend de vos sources.
Si une banque est déconnectée, ses mouvements s'arrêtent à la dernière synchronisation : le solde est incomplet, comme chaque chiffre que Heelio tire de ces mouvements. L'outil Sources le signale : c'est la première chose à regarder quand un montant surprend.
Les données arrivent en français.
Libellés et catégories sont ceux de Heelio. L'assistant peut ensuite vous répondre dans votre langue.
Dépannage
La connexion échoue ou la page de Heelio ne s'ouvre pas.
Vérifiez l'adresse : https://mcp.heelio.io/mcp, chemin /mcp compris. Si votre navigateur bloque les fenêtres surgissantes de votre assistant, autorisez-les, puis relancez la connexion depuis l'assistant.
Le bouton Autoriser reste grisé.
Cochez au moins une entreprise ou « Ajouter automatiquement les prochaines entreprises ».
La page affiche « Demande expirée ».
La demande d'autorisation vaut 15 minutes. Relancez la connexion depuis votre assistant.
L'assistant ne lit aucune entreprise.
Si vous n'avez coché que « Ajouter automatiquement les prochaines entreprises », il lira seulement les entreprises que vous rejoindrez. Déconnectez Heelio dans votre assistant, reconnectez-le et cochez les entreprises voulues.
L'assistant dit qu'une entreprise est inconnue ou ambiguë.
Demandez-lui la liste des entreprises qu'il peut lire, puis reprenez le nom exact. Tant que l'entreprise n'est pas désignée sans ambiguïté, aucun chiffre n'est rendu.
Une clé ne répond plus.
Un administrateur l'a peut-être régénérée ou supprimée : les assistants branchés avec l'ancienne clé cessent de répondre. Demandez la clé en cours à un administrateur de l'entreprise.
Un montant paraît faux ou ancien.
Demandez à l'assistant l'état de vos sources. Une source coupée laisse un chiffre incomplet : vérifiez-la dans Heelio, menu Sources, puis Mes sources. Sur un espace de groupe, les menus Sources et Intégrations sont masqués : ouvrez l'entreprise concernée.
Le problème persiste.
Écrivez à contact@heelio.io en précisant l'assistant utilisé, l'heure de la question et le message affiché.
Données et confidentialité
Le connecteur lit ce que vous voyez dans Heelio : soldes, mouvements, factures, comptes de résultat, état des sources, alertes. Il ne lit ni vos identifiants bancaires, ni vos moyens de paiement, ni les données d'une entreprise hors de l'accès accordé.
Le modèle qui répond est celui de votre assistant ; Heelio ne lui envoie que les données que ses outils rendent : chiffres et, selon l'outil, noms de clients et de fournisseurs, libellés et brouillons de relance. Ce que vous demandez et ce qui vous est répondu transitent par l'éditeur de votre assistant, selon ses propres conditions. Suivant votre offre et vos réglages, cet éditeur peut s'en servir pour entraîner ses modèles.
L'application Heelio et le connecteur pour assistants sont hébergés par Google Cloud, en Belgique (région europe-west1). Les membres habilités de l'équipe Heelio n'accèdent à vos données que pour assurer le service, le support ou l'accompagnement que vous avez souscrit.
Pour Heelio, consultez notre politique de confidentialité et la liste de nos prestataires.
In English
The Heelio connector gives your AI assistant read-only access to the Heelio figures of the companies you select. Its 13 tools read your figures and change nothing. Add https://mcp.heelio.io/mcp as a custom connector in Claude or ChatGPT, sign in to Heelio and tick the companies the assistant may read. Authorization uses OAuth with PKCE, and any member of a company can authorize an assistant, whatever their role, for the companies they have access to.
The access token lasts one hour. The assistant renews it without a new authorization as long as it does so at least once every 30 days, and each renewal replaces the previous one. A company removed from the access can no longer be read from the next question. Access is managed in Heelio under Intégrations, then Mes intégrations, in the Claude et ChatGPT block.
Clients that accept a key can use the access key instead. It is managed by administrators only. It covers a single company, cannot read a group, does not expire, and is revoked with Régénérer la clé or Supprimer. Figures and labels are returned in French.
Privacy policy: heelio.io/politique-de-confidentialite. Support: contact@heelio.io. To report a security issue, write to the same address. We acknowledge receipt within three business days.
Support
Une question, un chiffre qui surprend : contact@heelio.io.
Pour signaler une faille de sécurité, écrivez à la même adresse. Nous accusons réception sous trois jours ouvrés. Le signalement est aussi décrit dans notre politique de confidentialité.