DOCS · INSTALLATION

Activer PennyPilot : 3 canaux + 1 fallback

PennyPilot v1.0.0 s'active dans l'IA que vos collaborateurs utilisent déjà. Choisissez le canal qui correspond à votre cabinet (recommandé), ou installez le bundle local Claude Desktop pour une architecture 100% locale.

Pour les 3 canaux remote ci-dessus, votre token Pennylane est stocké chiffré at-rest côté HOLCO et n'apparaît jamais dans le chat. La même clé pp_live_… fonctionne dans les 3 canaux en parallèle.

🔧 Fallback avancé

La suite de ce guide concerne le bundle local Claude Desktop (.mcpb), architecture 100% locale, token Pennylane stocké en variable d'environnement Claude sur le poste du collaborateur, HOLCO sans accès. Recommandé seulement si Claude Desktop est votre seul environnement IA.

Pré-requis bundle local Claude Desktop

PennyPilot nécessite Claude Desktop ≥ 0.10.0 (macOS ou Windows, builds 2026 recommandés) avec un abonnement Claude Pro minimum, Claude Max recommandé pour la génération de la note de synthèse mensuelle (plusieurs tool calls chaînés, plus confortable sur Max).

  • Claude Desktop Mac ou Windows. Téléchargement : claude.ai/download.
  • Compte Anthropic Claude Pro (min.) ou Claude Max (recommandé). Plan gratuit insuffisant, le rate-limit des tool calls est trop bas pour la note de synthèse.
  • Une clé HOLCO active reçue par email après validation de votre inscription pilote (format HOLCO-XXXX-XXXX-XXXX-XXXX).
  • Un Company API Token Pennylane v2 à générer sur le dossier client de test (voir section dédiée plus bas).

Comment vérifier votre Claude Desktop

  • Version Desktop : menu Claude → À propos de Claude (macOS) ou Aide → À propos (Windows). Vérifiez ≥ 0.10.0.
  • Plan en cours : badge affiché en haut à droite de la fenêtre Claude Desktop (« Pro », « Max », ou rien si Free).

Préparer votre token Pennylane

PennyPilot a besoin d'un Company API Token v2 pour parler à votre dossier Pennylane. Un token = un dossier client. Choisissez d'abord le dossier que vous voulez tester (idéalement un dossier réel avec quelques mois d'historique), puis suivez les étapes ci-dessous.

Company Token vs Firm Token : le Company Token est scopé à un seul dossier, le Firm Token donne accès à tout le portefeuille du cabinet. PennyPilot v1.0.0 utilise encore un Company Token par dossier en pilote. Le mode multi-dossier read-only via Firm Token est disponible (mode cabinet, pilote en cours).

Génération étape par étape

  1. Connectez-vous à app.pennylane.com et sélectionnez le dossier client que vous voulez tester avec PennyPilot.
  2. Dans le menu paramètres du dossier (icône engrenage), ouvrez Paramètres → Connectivité → Développeurs (l'emplacement peut varier selon votre version Pennylane).
  3. Cliquez sur l'onglet API v2 (pas l'API v1, qui est legacy et incompatible).
  4. Cliquez Générer un nouveau token. Nommez-le par exemple PennyPilot HOLCO pour la traçabilité.
  5. Si Pennylane vous demande de choisir un scope, prenez lecture seule (PennyPilot est read-only par conception).
  6. Copiez immédiatement le token affiché. Pennylane ne le réaffiche jamais (par sécurité). Si vous le perdez, il faudra en générer un nouveau et révoquer l'ancien.
  7. Conservez le token sous la main, vous le collerez dans Claude Desktop à l'étape 3 ci-dessous.

Documentation officielle Pennylane : pennylane.readme.io. Si vous ne trouvez pas l'option « API v2 », contactez votre admin Pennylane Cabinet ou écrivez à alan@holco.co.

Étape 1 : Télécharger le bundle

Récupérez pennypilot-0.6.0.mcpb (~3,5 Mo) depuis votre page d'accès personnelle, ou directement à l'URL apps.holco.co/downloads/pennypilot-0.6.0.mcpb.

Étape 2 : Drag-drop dans Claude Desktop

Glissez le fichier .mcpb directement sur la fenêtre de Claude Desktop. Alternative : Settings → MCP Extensions → Install Extension, puis sélectionner le fichier.

Claude Desktop affiche une fenêtre de validation (nom de l'extension, éditeur, outils exposés). Cliquez Install.

⚠ Warning Claude Desktop à l'installation

À l'installation, Claude Desktop affichera un warning d'Anthropic : « Les informations sur le développeur affichées n'ont pas été vérifiées par Anthropic. »

C'est normal. Toutes les extensions tierces non listées dans le directory officiel Anthropic affichent ce message, indépendamment de leur qualité.

Sources de confiance vérifiables :

Nous avons soumis PennyPilot au directory officiel Anthropic, la vérification est en cours (Q3 2026).

Étape 3 : Saisir vos clés à l'installation

Claude ouvre une popup demandant deux variables :

  • HOLCO_LICENSE_KEY : votre clé pilote (format HOLCO-XXXX-XXXX-XXXX-XXXX, reçue par email).
  • PENNYLANE_API_TOKEN : votre Company API Token v2 (généré à l'étape « Préparer votre token Pennylane » ci-dessus).

Les deux valeurs sont stockées comme environment variables Claude Desktop sur votre poste, jamais envoyées à HOLCO. La clé HOLCO est consultée localement sous forme de hash uniquement.

Étape 4 : Premier message

Ouvrez une nouvelle conversation Claude Desktop. Commencez simplement par :

PennyPilot, que peux-tu faire ?

PennyPilot se présente, liste ses 42 outils comptables (analyse dossier, brief RDV, message client sourcé, charte IA cabinet, diagnostic AI Act, exploration grand livre, banque, analytique, FEC, etc.), et vous suggère des questions à poser sur votre dossier. C'est la meilleure entrée en matière.

Ensuite, posez vos vraies questions, par exemple :

  • « Génère la note de synthèse de mai 2026 pour mon dossier »
  • « Quelles factures clients sont en retard de plus de 60 jours ? »
  • « Donne-moi le P&L du dernier trimestre »

Première réponse en 6 à 10 secondes (la note de synthèse complète prend ~8 s sur un dossier moyen).

Vérifier l'installation

  • Si vous n'êtes pas sûr, demandez à Claude : « PennyPilot, démarre », la carte d'accueil start_pennypilot liste vos droits, vos quotas, les 42 outils disponibles et propose 4 ressources cabinet (catalogue d'usages, aide, lexique, espace cabinet).
  • Si rien ne s'affiche : Claude Desktop → Settings → MCP Extensions, vérifier que PennyPilot est listé et Enabled.

Désinstaller

Settings → MCP Extensions → PennyPilot → Remove. Le serveur MCP s'arrête, votre token Pennylane est purgé des variables d'environnement Claude Desktop. Les conversations passées restent visibles mais l'outil ne peut plus interroger Pennylane.

Un problème ? alan@holco.co · FAQ