boondmanager-mcp-server 1.2.1 → 1.3.0

package/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/fauguste/boondmanager-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/fauguste/boondmanager-mcp-server/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/boondmanager-mcp-server.svg)](https://www.npmjs.com/package/boondmanager-mcp-server)
+[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Serveur MCP (Model Context Protocol) pour l'API BoondManager, permettant a Claude (Desktop, Cowork, Code) de rechercher, consulter, creer et modifier des enregistrements dans votre instance BoondManager.
@@ -106,89 +107,163 @@ Les entites principales disposent d'outils dedies par onglet pour un acces cible
 
 ## Installation
 
-### Via npm (recommande)
+### Claude Desktop (one-click)
 
-```bash
-npx boondmanager-mcp-server
-```
-
-Ou installation globale :
-
-```bash
-npm install -g boondmanager-mcp-server
-boondmanager-mcp-server
-```
+Telechargez le fichier `.mcpb` depuis la [derniere release GitHub](https://github.com/fauguste/boondmanager-mcp-server/releases/latest), puis dans Claude Desktop : **Fichier > Installer une extension...** et selectionnez le fichier. Les identifiants sont demandes a l'installation et stockes de maniere chiffree (Keychain macOS / Credential Manager Windows).
 
-### Depuis les sources
+### Claude Code
 
 ```bash
-git clone https://github.com/fauguste/boondmanager-mcp-server.git
-cd boondmanager-mcp-server
-npm install
-npm run build
+# Avec un token API (recommande)
+claude mcp add --transport stdio --env BOOND_API_TOKEN=votre_token_jwt \
+  boondmanager -- npx -y boondmanager-mcp-server
+
+# Avec BasicAuth
+claude mcp add --transport stdio \
+  --env BOOND_USER=votre_login \
+  --env BOOND_PASSWORD=votre_mot_de_passe \
+  boondmanager -- npx -y boondmanager-mcp-server
 ```
 
-## Configuration
+> **Windows** : ajoutez `cmd /c` avant `npx` :
+> ```bash
+> claude mcp add --transport stdio --env BOOND_API_TOKEN=votre_token \
+>   boondmanager -- cmd /c npx -y boondmanager-mcp-server
+> ```
 
-### Variables d'environnement
+Pour rendre le serveur disponible dans tous vos projets, ajoutez `--scope user` :
 
-**Option 1 : BasicAuth (recommande pour demarrer)**
 ```bash
-export BOOND_USER="votre_login"
-export BOOND_PASSWORD="votre_mot_de_passe"
+claude mcp add --transport stdio --scope user \
+  --env BOOND_API_TOKEN=votre_token_jwt \
+  boondmanager -- npx -y boondmanager-mcp-server
 ```
 
-**Option 2 : Token API (JWT)**
-```bash
-export BOOND_API_TOKEN="votre_token_jwt"
-```
+### Claude Code - Configuration partagee en equipe
 
-**Option 3 : URL personnalisee (si instance dediee)**
-```bash
-export BOOND_BASE_URL="https://votre-instance.boondmanager.com/api"
+Ajoutez un fichier `.mcp.json` a la racine de votre projet (a commiter dans git) :
+
+```json
+{
+  "mcpServers": {
+    "boondmanager": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "boondmanager-mcp-server"],
+      "env": {
+        "BOOND_API_TOKEN": "${BOOND_API_TOKEN}"
+      }
+    }
+  }
+}
 ```
 
-Par defaut, l'URL est `https://ui.boondmanager.com/api`.
+Chaque membre de l'equipe n'a qu'a definir la variable d'environnement `BOOND_API_TOKEN` sur sa machine. Le fichier `.mcp.json` supporte la syntaxe `${VAR}` et `${VAR:-default}` pour les variables d'environnement.
 
-### Configuration Claude Desktop / Cowork
+### Claude Code Enterprise (deploiement administre)
 
-Ajoutez dans votre fichier de configuration Claude :
+Les administrateurs peuvent deployer le serveur MCP pour tous les utilisateurs via le fichier `managed-mcp.json` :
 
-**macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
+| OS | Chemin |
+|----|--------|
+| macOS | `/Library/Application Support/ClaudeCode/managed-mcp.json` |
+| Linux / WSL | `/etc/claude-code/managed-mcp.json` |
+| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |
 
 ```json
 {
   "mcpServers": {
     "boondmanager": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "boondmanager-mcp-server"],
       "env": {
-        "BOOND_USER": "votre_login",
-        "BOOND_PASSWORD": "votre_mot_de_passe"
+        "BOOND_API_TOKEN": "${BOOND_API_TOKEN}",
+        "BOOND_BASE_URL": "https://votre-instance.boondmanager.com/api"
       }
     }
   }
 }
 ```
 
-Ou si installe depuis les sources :
+Ce fichier prend le controle exclusif des serveurs MCP : les utilisateurs ne peuvent pas ajouter ou modifier de serveurs en dehors de cette configuration.
+
+Pour restreindre les serveurs autorises tout en laissant les utilisateurs en ajouter, utilisez plutot `managed-settings.json` :
+
+```json
+{
+  "allowedMcpServers": [
+    { "serverName": "boondmanager" }
+  ]
+}
+```
+
+### Claude Desktop / Cowork (configuration manuelle)
+
+Ajoutez dans votre fichier de configuration Claude :
+
+**macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
   "mcpServers": {
     "boondmanager": {
-      "command": "node",
-      "args": ["/chemin/absolu/vers/boondmanager-mcp-server/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "boondmanager-mcp-server"],
       "env": {
-        "BOOND_USER": "votre_login",
-        "BOOND_PASSWORD": "votre_mot_de_passe"
+        "BOOND_API_TOKEN": "votre_token_jwt"
       }
     }
   }
 }
 ```
 
+### Via npm
+
+```bash
+npx boondmanager-mcp-server
+```
+
+Ou installation globale :
+
+```bash
+npm install -g boondmanager-mcp-server
+boondmanager-mcp-server
+```
+
+### Depuis les sources
+
+```bash
+git clone https://github.com/fauguste/boondmanager-mcp-server.git
+cd boondmanager-mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+### Authentification
+
+**Option 1 : Token API JWT (recommande)**
+```bash
+export BOOND_API_TOKEN="votre_token_jwt"
+```
+
+**Option 2 : BasicAuth**
+```bash
+export BOOND_USER="votre_login"
+export BOOND_PASSWORD="votre_mot_de_passe"
+```
+
+### URL personnalisee (si instance dediee)
+
+```bash
+export BOOND_BASE_URL="https://votre-instance.boondmanager.com/api"
+```
+
+Par defaut, l'URL est `https://ui.boondmanager.com/api`.
+
 ## Exemples d'utilisation
 
 Une fois configure, vous pouvez demander a Claude :

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "boondmanager-mcp-server",
   "display_name": "BoondManager MCP Server",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "MCP Server for BoondManager API - 158 tools across 36 domains for ERP/CRM data",
   "author": {
     "name": "Silamir",
@@ -33,27 +33,27 @@
     "base_url": {
       "type": "string",
       "title": "BoondManager URL",
-      "description": "URL de base de l'API BoondManager (ex: https://ui.boondmanager.com/api)",
+      "description": "URL de base de l'API BoondManager (ex: https://ui.boondmanager.com/api). Laissez vide pour utiliser l'URL par défaut.",
       "default": "https://ui.boondmanager.com/api",
       "required": false
     },
-    "user": {
+    "api_token": {
       "type": "string",
-      "title": "Utilisateur",
-      "description": "Nom d'utilisateur pour l'authentification BasicAuth",
+      "title": "Token API (recommandé)",
+      "description": "Token JWT pour l'authentification Bearer. Méthode recommandée. Renseignez ce champ OU les champs Utilisateur + Mot de passe ci-dessous.",
+      "sensitive": true,
       "required": false
     },
-    "password": {
+    "user": {
       "type": "string",
-      "title": "Mot de passe",
-      "description": "Mot de passe pour l'authentification BasicAuth",
-      "sensitive": true,
+      "title": "Utilisateur (BasicAuth)",
+      "description": "Nom d'utilisateur BoondManager. À renseigner avec le mot de passe si vous n'utilisez pas le Token API.",
       "required": false
     },
-    "api_token": {
+    "password": {
       "type": "string",
-      "title": "Token API",
-      "description": "Token JWT pour l'authentification Bearer (alternative à user/password)",
+      "title": "Mot de passe (BasicAuth)",
+      "description": "Mot de passe BoondManager. À renseigner avec l'utilisateur si vous n'utilisez pas le Token API.",
       "sensitive": true,
       "required": false
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boondmanager-mcp-server",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "MCP Server for BoondManager API - Resources, Candidates & CRM",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",