Méthode
Un jeton API Pennylane par société : brancher Claude sur plusieurs entités
Quand un groupe compte plusieurs sociétés, chacune a sa comptabilité dans Pennylane, et l’accès ne doit pas dépendre d’un salarié. Voici comment donner à Claude un accès propre à chaque entité, testé en lecture avant d’aller plus loin.
Pourquoi l’accès par salarié ne tient pas
Un dirigeant de plusieurs sociétés, ou son expert-comptable, veut que Claude lise la comptabilité de chacune. Le plus rapide consiste à passer par le compte d’un salarié. Cela se paie plus tard : quand la personne part, l’accès tombe, et tout est à refaire.
Le connecteur officiel de Pennylane ne règle pas ce point : il se branche avec les identifiants de la personne connectée et hérite de ses droits. L’accès reste attaché à quelqu’un, pas à la société.
Le mélange pose un autre problème. Avec un accès unique pour tout le monde, on ne sait plus quelle société a été lue, avec quels droits, ni comment couper un accès sans couper les autres. L’API Pennylane permet de faire autrement : un jeton généré au nom de chaque société, rangé dans son propre fichier, que Claude utilise sans jamais l’afficher.
Ce qu’il faut avant de commencer
La préparation compte plus que la technique. Sans elle, les jetons se multiplient et plus personne ne sait lequel sert à quoi.
- Pour chaque société, un accès Pennylane qui permet de générer un jeton, dans Paramètres, Connectivité, Développeur.
- La liste des sociétés, avec le nom exact de chacune dans Pennylane.
- Claude Code, qui travaille dans un dossier de projet sur votre poste : c’est là que vivront les fichiers d’environnement, un par société.
- Si ce dossier est suivi par Git, une règle qui exclut les fichiers d’environnement.
- Une idée claire de ce que Claude doit faire : lire seulement, ou plus tard écrire. Les permissions du jeton en dépendent.
La méthode, étape par étape
Commencez par une seule société. Tant que le premier test ne passe pas, ne générez pas les autres jetons.
- Dans Pennylane, ouvrez Paramètres, Connectivité, Développeur, et générez un jeton au nom de la première société. Cochez les permissions dont Claude aura besoin, pas davantage.
- Demandez à Claude un fichier d’environnement par entité, nommé d’après la société : un fichier, un jeton, une société.
- Collez vous-même le jeton dans le fichier de la société. Évitez de le coller dans la conversation : ce qui y est tapé reste dans l’historique de la session.
- Faites vérifier que ces fichiers sont exclus de Git, et que Claude n’affiche jamais la clé, ni en entier ni en partie.
- Lancez un test de lecture sur cette seule société : lister ses journaux et son plan de comptes suffit à prouver que l’accès fonctionne.
- Comparez le résultat avec ce que vous voyez dans Pennylane. Si les journaux et les comptes correspondent, l’accès est bon.
- Répétez pour chaque société, une à une, avec un test à chaque fois.
- Tenez à jour la liste des jetons : société, personne qui l’a généré, permissions cochées, emplacement du fichier. Jamais la clé elle-même.
La consigne à donner à Claude
La consigne pose le cadre avant le premier jeton : un fichier par société, une clé jamais affichée, un test limité à la lecture. Un exemple à adapter, crochets à remplacer :
J’ai [nombre] sociétés dans Pennylane, avec une comptabilité chacune.
Crée un fichier d’environnement par société : [société A], [société B], [société C].
Je colle moi-même le jeton API de [société A] dans son fichier. Ne l’affiche jamais, et vérifie que ces fichiers sont exclus de Git.
Fais un test de lecture sur [société A] uniquement : liste ses journaux et son plan de comptes, avec le nombre de chacun.
N’écris rien dans Pennylane.
Si le test passe, prépare la même chose pour les autres sociétés, sans rien lancer avant mon accord.Les garde-fous
- Un jeton par société, jamais un jeton partagé entre plusieurs entités : chacun se coupe sans toucher aux autres.
- Des jetons au nom de la société, pas d’un salarié, pour que l’accès survive aux départs.
- La clé jamais affichée, jamais collée dans la conversation, jamais suivie par Git.
- Des permissions cochées au plus juste, revues quand l’usage change.
- La lecture d’abord. Toute écriture viendra plus tard, avec un accord explicite avant chaque lot, une simulation et un journal d’exécution.
- Un test après chaque nouveau jeton, et une vérification humaine dans Pennylane avant de s’appuyer sur ce que Claude a lu.
Ce que montre le cas filmé
En séance, une dirigeante de plusieurs restaurants, une société et une comptabilité Pennylane chacun, voulait que Claude lise la comptabilité de chaque société. Jusque-là, l’accès passait par des comptes de salariés, à refaire à chaque départ. Le jeton est généré dans Pennylane au nom du premier restaurant, permissions cochées, puis Claude crée un fichier d’environnement par restaurant.
Une fois le jeton collé et le test demandé, Claude n’affiche pas la clé et la met à l’abri de Git. Il lit la comptabilité du restaurant : 12 journaux, 127 comptes. La duplication pour les autres restaurants n’est pas montrée, et la page qui affiche le jeton est coupée. Regardez la vidéo pour voir le parcours dans Pennylane et le premier test.
Voir le cas filmé : L’API Pennylane branchée société par société : le premier restaurant lu
Dans ce sujet
L’API Pennylane branchée société par société : le premier restaurant lu, le cas filmé en séance.
MCP Pennylane : brancher Claude sur vos dossiers comptables
Consolidation multi-établissements en comptabilité
Comptabilité restauration multi-établissements
Trois agents sur l’API Pennylane : 12 actions validées, puis écrites
Questions fréquentes
Comment obtenir une clé API Pennylane ?
Le jeton se génère dans Pennylane, dans Paramètres, Connectivité, Développeur. Vous cochez les permissions utiles, puis vous le rangez dans un fichier d’environnement que Claude lit sans l’afficher. Si un libellé a changé, cherchez la rubrique Développeur.
Faut-il un jeton API différent pour chaque société ?
C’est la méthode que nous recommandons quand chaque société a sa propre comptabilité dans Pennylane. Chaque jeton vit dans son fichier, on sait quel accès sert à quoi, et le jour où il faut en retirer un, les autres sociétés ne sont pas touchées.
Claude peut-il écrire dans Pennylane avec ce jeton ?
Cela dépend des permissions cochées. Commencez par la lecture, comme dans le cas filmé. Si vous passez à l’écriture, posez d’abord une règle d’accord explicite, une simulation et un journal d’exécution.
Vous voulez le mettre en place chez vous ?
En séance de coaching, on le construit sur votre logiciel et vos vrais dossiers, en partageant votre écran.
