Sync Indy integre dans l'interface web + anti-doublon

2026-06-30 14:08:35 +02:00
parent 458f80f201
commit 75af558b49
13 changed files with 665 additions and 48 deletions
@@ -0,0 +1,82 @@
+# Intégration Indy via MCP (Claude Desktop)
+
+Le serveur MCP [mcp-server-indy-compta](https://github.com/stephaneberle9/mcp-server-indy-compta)
+expose tes données Indy (transactions, clients, factures) en **données structurées**.
+C'est bien plus fiable que l'OCR. Deux usages : **analyse en langage naturel** et
+**pont vers l'import** de JB Compta.
+
+> ⚠️ API non officielle d'Indy : ça peut casser si Indy change son interface, et c'est
+> une zone grise vis-à-vis des CGU. L'authentification se fait par login navigateur
+> (Chrome) ou un token JWT capturé qui expire et doit être renouvelé.
+
+## 1. Installer et brancher le MCP sur Claude Desktop
+
+Prérequis : Python 3.12+, [uv](https://docs.astral.sh/uv/), un compte Indy.
+
+```bash
+git clone https://github.com/stephaneberle9/fastmcp-creds.git
+git clone https://github.com/stephaneberle9/python-indy-compta.git
+git clone https://github.com/stephaneberle9/mcp-server-indy-compta.git
+cd mcp-server-indy-compta && uv sync
+```
+
+Dans Claude Desktop → `Settings… > Developer > Edit Config`, ajoute :
+
+```jsonc
+{
+  "mcpServers": {
+    "indy-compta": {
+      "command": "uv",
+      "args": ["run", "--with-editable", "/chemin/vers/mcp-server-indy-compta",
+               "mcp-server-indy-compta"]
+    }
+  }
+}
+```
+
+Redémarre Claude Desktop. Au premier appel d'outil, un navigateur s'ouvre pour le login Indy.
+
+## 2. Analyse en langage naturel
+
+Exemples de questions à poser à Claude (avec le MCP connecté) :
+
+- « Montre mes dépenses de juin 2026 groupées par catégorie. »
+- « Quel est mon cash-flow du 1er trimestre ? »
+- « Quelles transactions de dépense n'ont pas de justificatif attaché ? »
+- « Liste mes factures en retard. »
+
+## 3. Pont MCP → import JB Compta (le plus utile)
+
+Demande à Claude de **convertir tes transactions Indy au format CSV de l'app**, puis
+colle le résultat dans la page **Importer** (`/import/`).
+
+Prompt type à utiliser dans Claude Desktop :
+
+> En utilisant le MCP indy-compta, récupère toutes mes transactions de **juin 2026**.
+> Donne-moi le résultat en **CSV** avec exactement ces colonnes, séparées par `;` :
+> `date;libelle;categorie;activite;taux_tva;regime;montant`
+> Règles :
+> - `date` au format `AAAA-MM-JJ` ;
+> - `montant` signé (négatif = dépense, positif = encaissement) ;
+> - `taux_tva` = le taux affiché (0, 5.5, 10 ou 20) ;
+> - `regime` = `intracom` si la TVA est marquée « UE », sinon vide ;
+> - `categorie` = le nom exact de la catégorie Indy ;
+> - une seule ligne par transaction, pas de texte autour du CSV.
+
+Tu colles ce CSV dans `/import/` → **Analyser** → tu vérifies l'aperçu → **Importer**.
+
+Avantage : Claude + le MCP font le **fetch fiable et le mapping**, l'app fait la
+**création** (déjà testée). Aucun token Indy à héberger sur ton serveur.
+
+## 4. Plus tard : sync automatique côté serveur (optionnel)
+
+Pour une automatisation totale (sans Claude Desktop), on pourrait intégrer la
+librairie `python-indy-compta` directement dans l'app (tâche planifiée qui tire les
+transactions et crée les opérations). À évaluer car cela demande :
+
+- un **token JWT statique** sur le serveur (le login navigateur est impossible en headless),
+  à renouveler à son expiration ;
+- de mapper les objets de la librairie vers nos modèles (à valider avec ton compte) ;
+- d'accepter la dépendance à une API non officielle.
+
+Le pont CSV (section 3) couvre déjà 90 % du besoin sans cette complexité.