Questions fréquentes
+Questions fréquentes
-Le solde du porte-monnaie représente les liquidités disponibles sur une plateforme, c'est-à-dire l'argent que vous pouvez retirer ou réinvestir. Il est calculé comme suit : @@ -137,7 +301,7 @@ export default function Aide() { permettant de réconcilier de micro-écarts de calcul (par exemple un arrondi de centimes sur la fiscalité).
Le réinvestissement automatique permet de capitaliser les intérêts perçus après chaque remboursement, sans aucune saisie manuelle. Les intérêts sont automatiquement réinjectés dans le capital du prêt, @@ -179,41 +343,26 @@ export default function Aide() {
- Le serveur MCP tourne déjà en continu en production (service Docker crowdlending-mcp,
- exposé via Traefik) — contrairement au développement local, vous n'avez rien à démarrer ni
- à laisser tourner sur votre machine. Il suffit de connecter Claude Desktop à l'URL publique.
-
Prérequis
--
-
- Le service
crowdlending-mcpdu -docker-compose.ymldoit être déployé, avec un enregistrement - DNS pourmcp.<votre domaine>pointant vers la même IP que l'app - (certificat TLS automatique via Traefik).
- - Une clé API dédiée à la production, distincte de celle utilisée en développement - local si vous en avez une — cela permet de révoquer l'une sans affecter l'autre. -
+ Le serveur MCP tourne déjà en continu (service Docker crowdlending-mcp,
+ exposé via Traefik) — vous n'avez rien à installer ni à laisser tourner sur votre machine. Il
+ suffit de connecter Claude Desktop à l'URL publique.
+
Étapes
-
-
- Générez une clé API dédiée : Mon compte → Clés API → Nouvelle clé (par exemple nommée « MCP Prod »). +
- Générez une clé API : Mon compte → Clés API → Nouvelle clé (par exemple nommée « Claude Desktop »).
- Allez dans Mon compte → Serveur MCP et renseignez l'URL publique
- (
https://mcp.<votre domaine>/mcp) ainsi que la clé générée. L'environnement - se détecte automatiquement sur « PROD » dès que l'URL ne contient nilocalhostni -dev— cochez « Forcer manuellement » si votre domaine de test prête à confusion.
+ ( - Copiez la configuration générée dans
claude_desktop_config.json(Réglages - → Développeur → Serveurs MCP locaux → Modifier la config), exactement comme en développement — seule l'URL change, - le mécanismemcp-remote(et le wrappercmd /csous - Windows) reste identique.
+ → Développeur → Serveurs MCP locaux → Modifier la config) — le mécanisme passe par
+ - Redémarrez complètement Claude Desktop.
{mcpConfigUrl}{appInfo.mcpUrl ? ' — déjà pré-rempli si vous ne l\'avez pas modifié' : ''}) ainsi que la clé générée.
mcp-remote (avec le wrapper cmd /c sous
+ Windows), généré automatiquement pour vous.
- Vous pouvez connecter dev et prod simultanément : répétez ces étapes une seconde fois
- avec l'URL locale et une clé distincte, les deux entrées de config (crowdlending-dev /
- crowdlending-prod) coexistent sans collision.
-
Sécurité
-
@@ -223,16 +372,16 @@ export default function Aide() {
- Limite de 60 requêtes/minute par IP (au-delà, erreur 429) et fermeture automatique des sessions inactives depuis plus de 30 minutes — aucune donnée de session n'est conservée entre deux connexions.
- L'outil
crowdlending_fetch_url(lecture d'une page web arbitraire) reste - désactivé en production, même s'il est activé chez vous en développement local.
+ désactivé sur ce serveur.
- Si la connexion reste bloquée sans erreur visible, la cause est presque toujours la même qu'en développement local
- (npx qui échoue silencieusement à joindre le registre npm) — voir la
+ Si la connexion reste bloquée sans erreur visible, la cause est presque toujours la même :
+ npx qui échoue silencieusement à joindre le registre npm — voir la
section Dépannage de Mon compte → Serveur MCP.
Une fois connecté, Claude (Desktop ou tout autre client MCP) peut consulter votre portefeuille en langage naturel — il choisit lui-même le bon outil selon votre question. Le serveur est strictement @@ -309,6 +458,214 @@ export default function Aide() {
+ Comme le serveur MCP, Power Query s'appuie sur l'API v1 (lecture seule) via une clé API. + Power Query est intégré nativement à Excel (365 / 2016 et plus, Windows ou Mac) — rien à + installer. Chaque étape ci-dessous correspond à un écran que vous pouvez capturer pour + illustrer votre propre guide. +
+ +
+ Le classeur ci-dessus contient déjà les 7 requêtes ci-dessous, prêtes à charger — il ne
+ reste qu'à renseigner votre clé (étape 1). Vous pouvez aussi tout reconstruire à la main
+ avec les fichiers .pq individuels
+ proposés à chaque étape ci-dessous.
+
Étape 1 — Générer une clé API
+-
+
- Mon compte → Clés API → Nouvelle clé. +
- Donnez-lui un nom explicite (ex. « Excel »), validez, puis copiez immédiatement la clé + affichée — elle ne sera plus visible en clair ensuite. +
Étape 2 — Créer les deux requêtes de connexion
++ Dans Excel : Données → Obtenir des données → À partir d'autres + sources → Requête vide. Une nouvelle requête « Requête1 » apparaît dans l'éditeur Power Query. +
+-
+
- Renommez-la
ApiBaseUrl(double-clic + sur son nom dans le volet Requêtes), puis Affichage → Éditeur avancé, + effacez le contenu par défaut et collez :
+
+{`"http://localhost:4000/api/v1"`}
+
+ 
{ e.currentTarget.style.display = 'none'; }}
+ />
+ -
+
- Cliquez Terminé, puis Accueil → Fermer et charger dans… → Uniquement créer la connexion (pas besoin d'un tableau pour celle-ci). +
- Répétez l'opération pour une seconde requête vide nommée
ApiKey:
+
+{`"clk_live_VOTRE_CLE_API"`}
+
+ 
{ e.currentTarget.style.display = 'none'; }}
+ />
+ Remplacez par la clé copiée à l'étape 1, entre guillemets. Même chose : Terminé → Uniquement créer la connexion.
+ +Étape 3 — La fonction technique fnApiGet
+
+ Une troisième requête vide, nommée fnApiGet,
+ fait l'appel HTTP et transmet la clé dans l'en-tête X-API-Key —
+ les requêtes suivantes la réutiliseront par son nom, sans la récrire :
+
+{`(chemin as text, optional parametres as nullable record) as any =>
+ let
+ parametresBruts = if parametres = null then [] else parametres,
+ champsUtiles = List.Select(
+ Record.FieldNames(parametresBruts),
+ each Record.Field(parametresBruts, _) <> null and Record.Field(parametresBruts, _) <> ""
+ ),
+ parametresNettoyes = Record.SelectFields(parametresBruts, champsUtiles),
+ reponse = Web.Contents(
+ ApiBaseUrl,
+ [
+ RelativePath = chemin,
+ Headers = [#"X-API-Key" = ApiKey, #"Accept" = "application/json"],
+ Query = parametresNettoyes
+ ]
+ ),
+ resultat = Json.Document(reponse)
+ in
+ resultat`}
+
+ 
{ e.currentTarget.style.display = 'none'; }}
+ />
+ Terminé → Fermer et charger dans… → Uniquement créer la connexion (ce n'est pas une donnée à afficher).
+ +Étape 4 — Première requête de données : Investissements
+Une nouvelle requête vide, nommée Investissements :
+{`let
+ // Pour filtrer par statut, remplacez null par [statut = "rembourse"]
+ // Statuts possibles : en_cours, rembourse, en_retard, procedure, cloture
+ Source = fnApiGet("/investissements", null),
+ Resultat = Table.FromRecords(Source)
+in
+ Resultat`}
+
+ 
{ e.currentTarget.style.display = 'none'; }}
+ />
+ + Cette fois-ci, Terminé → Fermer et charger (le bouton + simple, pas « … ») : la requête s'ajoute comme tableau dans une nouvelle feuille, avec vos + investissements en ligne et en colonnes. +
+ +Étape 5 — Actualiser
++ Données → Actualiser tout (ou Ctrl+Alt+F5) à tout moment + pour recharger les données depuis l'API — utile après un nouvel investissement ou remboursement + saisi dans l'app. +
+ +Aller plus loin — les autres requêtes
+Même principe (requête vide → nom exact → éditeur avancé → coller → charger) pour :
+
+ Investisseur
+ |
+ Profil investisseur (ou liste des membres si clé « Famille et entreprises »). | +
+ |
+
+ Dashboard
+ |
+ KPIs du portefeuille, au format « Indicateur / Valeur » (facile à croiser dans un TCD). | +
+ |
+
+ Remboursements
+ |
+ Historique des remboursements, filtrable par période. | +
+ |
+
+ DépôtsRetraits
+ |
+ Historique des mouvements de cash. | +
+ |
+
+ fnDetailInvestissement
+ |
+
+ Fonction avancée : sur la table Investissements, colonne personnalisée{' '}
+ = fnDetailInvestissement([id]){' '}
+ pour ramener le détail + les remboursements de chaque prêt.
+ |
+
+ |
+
+ Toutes ces requêtes sont déjà incluses dans le classeur téléchargeable en haut de cette fiche —
+ les fichiers .pq ci-dessus
+ ne sont utiles que si vous préférez les coller vous-même dans un classeur existant.
+
Dépannage
+-
+
- « Impossible de se connecter au service distant » — le
+ backend n'est pas démarré, ou
ApiBaseUrlest + incorrecte (vérifiez le port et le suffixe/api/v1).
+ - Erreur 401 / clé invalide — régénérez une clé dans
+ Mon compte → Clés API et mettez à jour la requête
ApiKey.
+ - Avertissement de confidentialité au premier chargement — + normal pour toute nouvelle source Web dans Power Query ; choisissez « Organisationnel » ou « Public » + selon votre contexte. +
+ Comme le serveur MCP, ces requêtes sont strictement en lecture seule : aucune saisie n'est possible + depuis Excel, toute modification reste à faire dans l'application. +
+