HOLCO

DOCS · INSTALLATION

Installer PennyPilot dans Claude Desktop

Pré-requis

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 v0.2 ne supporte que Company. Le Firm Token (un seul token pour tout le portefeuille, plus pratique pour les cabinets) arrive en v0.3 (Q3 2026).

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 v0.2 ne fait que lire, jamais écrire).
  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.2.4.mcpb (3,3 Mo) depuis votre page d'accès personnelle, ou directement à l'URL apps.holco.co/downloads/pennypilot-0.2.4.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 13 outils, 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, que peux-tu faire ? » — la carte d'accueil about_pennypilot liste les 13 outils (lecture financière + 8 outils Grand livre/comptabilité + canal feedback @holco).
  • 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