Fix

mcp-server/README.md

@@ -44,15 +44,37 @@ locaux → **Modifier la config**, puis ajoutez dans `mcpServers` :
 {
   "mcpServers": {
     "crowdlending-dev": {
-      "url": "http://localhost:4100/mcp",
-      "headers": {
-        "X-API-Key": "clk_live_..."
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote",
+        "http://localhost:4100/mcp",
+        "--header",
+        "X-API-Key:${CROWDLENDING_API_KEY}"
+      ],
+      "env": {
+        "CROWDLENDING_API_KEY": "clk_live_..."
       }
     }
   }
 }
 ```
 
+**Important :** `claude_desktop_config.json` n'accepte que des entrées
+`command`/`args` — il n'existe pas de champ `url`/`headers` natif dans ce
+fichier (contrairement à d'autres clients MCP). Pour un serveur HTTP comme
+celui-ci, on passe donc par
+[`mcp-remote`](https://github.com/geelen/mcp-remote), un petit pont
+stdio↔HTTP officiel : Claude Desktop lance `npx mcp-remote` comme d'habitude,
+qui se charge de parler HTTP à notre serveur en coulisses, en-tête
+`X-API-Key` inclus. Aucune installation manuelle requise, `npx` le télécharge
+à la volée.
+
+Notez l'absence d'espace autour du `:` dans `--header` : Claude Desktop
+(Windows) a un bug connu qui tronque les arguments contenant un espace — on
+passe donc la valeur réelle (avec l'espace éventuel) via une variable
+d'environnement dans `env` plutôt que directement dans `args`.
+
 Redémarrez Claude Desktop. Les outils `crowdlending_*` doivent apparaître
 (voir la liste plus bas — `crowdlending_fetch_url` en plus si activé, voir
 Configuration).
@@ -72,8 +94,8 @@ distant réel (en local, les valeurs par défaut conviennent) :
 
 Aucune clé API fixe n'est configurée côté serveur, contrairement à une
 ancienne version qui utilisait le transport stdio : chaque session MCP lit
-sa propre clé dans l'en-tête `X-API-Key` de la requête qui l'initialise (le
-bloc `headers` de la config Claude Desktop ci-dessus). Un même process peut
+sa propre clé dans l'en-tête `X-API-Key` de la requête qui l'initialise
+(transmis via `mcp-remote --header`, voir ci-dessus). Un même process peut
 donc servir plusieurs utilisateurs/sessions en parallèle sans jamais mélanger
 leurs données — voir le déploiement distant plus bas.
 
@@ -88,12 +110,14 @@ possible, même si les noms d'outils sont identiques des deux côtés.
 {
   "mcpServers": {
     "crowdlending-dev": {
-      "url": "http://localhost:4100/mcp",
-      "headers": { "X-API-Key": "clk_live_..." }
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "http://localhost:4100/mcp", "--header", "X-API-Key:${DEV_API_KEY}"],
+      "env": { "DEV_API_KEY": "clk_live_..." }
     },
     "crowdlending-prod": {
-      "url": "https://mcp.crowdlending.croguennec.net/mcp",
-      "headers": { "X-API-Key": "clk_live_..." }
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.crowdlending.croguennec.net/mcp", "--header", "X-API-Key:${PROD_API_KEY}"],
+      "env": { "PROD_API_KEY": "clk_live_..." }
     }
   }
 }
@@ -186,8 +210,12 @@ Garde-fous :
 
 ## Dépannage
 
-- **`En-tête X-API-Key manquant`** — vérifiez la section `headers` de votre
-  config Claude Desktop.
+- **`En-tête X-API-Key manquant`** — vérifiez l'argument `--header` et la
+  variable d'environnement correspondante dans votre config Claude Desktop.
+- **« Certains serveurs MCP n'ont pas pu être chargés » / entrée ignorée** —
+  votre config utilise un bloc `url`/`headers` directement, non supporté par
+  `claude_desktop_config.json` (voir Développement local plus haut) : il faut
+  passer par `command: "npx"` + `mcp-remote`.
 - **`Clé API invalide ou révoquée`** — régénérez une clé dans Mon compte →
   Clés API et mettez à jour la config.
 - **`Impossible de joindre l'API`** — le backend n'est pas démarré, ou