boondmanager-mcp-server 2.15.0 → 2.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -876,6 +876,49 @@ boondmanager-mcp-server/
876
876
  └── README.md
877
877
  ```
878
878
 
879
+ ## Depannage
880
+
881
+ ### « JSON Schema declares an unsupported dialect (draft-07) » sur les outils `*_search`
882
+
883
+ **Symptome.** Les outils de recherche (`boond_candidates_search`, `boond_resources_search`,
884
+ `boond_opportunities_search`...) echouent systematiquement, alors que les outils de fiche
885
+ (`boond_*_get`), les dictionnaires et les workflows textuels fonctionnent. La dissymetrie est
886
+ le diagnostic : seuls les ~59 outils qui declarent un `outputSchema` sont concernes, parce que
887
+ c'est ce schema-la que l'hote compile -- au moment ou il enregistre l'outil, donc **avant tout
888
+ appel**. L'outil n'echoue pas, il devient inutilisable.
889
+
890
+ **Cause.** Les versions **2.1.0 a 2.12.1** annoncaient `"$schema": "http://json-schema.org/draft-07/schema#"`
891
+ sur leurs schemas (le SDK MCP convertit les schemas Zod avec `target: 'draft-7'`, en dur). Un hote
892
+ qui valide avec un validateur **2020-12 uniquement** refuse de compiler un tel schema.
893
+
894
+ **Correctif : mettre a jour vers >= 2.12.2.** Depuis cette version le serveur n'annonce plus
895
+ aucun dialecte (`src/schema-dialect.ts`), ce que la suite de tests verifie sur les 182 outils
896
+ a travers un vrai client, sous validateur 2020-12 **et** draft-07.
897
+
898
+ **Redemarrer le connecteur ne suffit pas** : un redemarrage relance le binaire installe, il ne le
899
+ met pas a jour. Verifiez la version reellement chargee plutot que celle affichee par le catalogue :
900
+
901
+ ```bash
902
+ # npm / npx : quelle version est resolue et depuis quel cache
903
+ npm view boondmanager-mcp-server version
904
+ npx --yes boondmanager-mcp-server@latest --version 2>/dev/null || true
905
+
906
+ # Le serveur annonce sa version dans la reponse `initialize` (champ serverInfo.version),
907
+ # lue depuis son propre package.json -- c'est la seule source fiable.
908
+ ```
909
+
910
+ Selon le canal d'installation :
911
+
912
+ | Canal | Mise a jour |
913
+ |---|---|
914
+ | Extension Claude Desktop (`.mcpb`) | Telecharger le `.mcpb` de la derniere release et le reinstaller -- les extensions tierces ne s'auto-mettent pas a jour |
915
+ | Plugin Claude Code | `/plugin marketplace update boondmanager` puis reinstaller le plugin (le lancement est epingle sur `boondmanager-mcp-server@X.Y.Z`) |
916
+ | `claude mcp add` / config manuelle | Epingler `boondmanager-mcp-server@latest` (ou une version >= 2.12.2) dans la commande `npx` |
917
+ | Docker / GHCR | `docker pull ghcr.io/fauguste/boondmanager-mcp-server:latest` |
918
+
919
+ > Verifiez aussi la version de Node : le serveur requiert **Node.js >= 22**. Un poste encore en
920
+ > Node 20 est en general un poste dont l'installation n'a pas ete rafraichie depuis longtemps.
921
+
879
922
  ## Securite
880
923
 
881
924
  - Les credentials BoondManager (JWT ou BasicAuth) ne transitent jamais via le protocole MCP -- ils sont configures en variables d'environnement cote serveur uniquement
package/manifest.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "manifest_version": "0.3",
3
3
  "name": "boondmanager-mcp-server",
4
4
  "display_name": "BoondManager MCP Server",
5
- "version": "2.15.0",
5
+ "version": "2.15.1",
6
6
  "description": "MCP Server for BoondManager API - 182 tools, 12 prompts, 22 resources (ERP/CRM)",
7
7
  "author": {
8
8
  "name": "Frédéric Auguste",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "boondmanager-mcp-server",
3
- "version": "2.15.0",
3
+ "version": "2.15.1",
4
4
  "description": "MCP Server for BoondManager API - 182 tools, 12 prompts, 22 resources (ERP/CRM)",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",