MCP Dolibarr Expert đ
Un serveur Model Context Protocol (MCP) complet pour Dolibarr ERP/CRM. Permets à n'importe quel assistant IA (Claude, Cursor, Windsurf, etc.) d'agir comme un expert Dolibarr à part entiÚre : facturation, comptabilité avancée, CRM, projets, stocks, contrats, configuration complÚte du systÚme et bien plus.
Développé par Digital Factory Senegal
đ digitalfactory.sn  | đ WhatsApp : +221 77 800 38 14  | đ§ [email protected]
⚠Fonctionnalités (55+ outils)
đą Tiers (Clients / Fournisseurs)
- Lister, rechercher, créer, mettre à jour les tiers
- Accéder à l'historique (factures, devis, commandes, contacts d'un tiers)
đ Facturation (10 outils)
- Créer des factures brouillons, ajouter/modifier/supprimer des lignes
- Valider des factures officiellement
- Enregistrer des paiements avec ventilation multi-factures
- Créer des avoirs (factures de crédit)
- Envoyer des factures par email
đ Devis & Propositions Commerciales
- Créer, envoyer, valider, signer, refuser des devis
- Convertir un devis signé en commande client
đŠ Commandes (Clients & Fournisseurs)
- Gestion complĂšte du cycle commande â livraison â facturation
- Commandes fournisseurs et approvisionnement
đ Produits & Stocks
- Catalogue produits et services avec prix, TVA, codes comptables
- Consultation et mouvements de stock par entrepĂŽt
đ° ComptabilitĂ© & TrĂ©sorerie (Expert)
- Consultation des comptes bancaires et transactions
- Plan comptable et journaux comptables
- Ăcritures du grand livre
- Rapport financier synthétique : CA, impayés, solde de trésorerie
đ€ CRM
- Contacts individuels
- Agenda d'activités (appels, RDV, emails commerciaux)
đ Projets & TĂąches
- Gérer des projets client avec budget et deadline
- Créer et suivre des tùches
đ„ RH & Administration
- Lister les utilisateurs/commerciaux
- Consulter les notes de frais
đ Contrats & Abonnements
- Créer et gérer des contrats client
âïž Configuration & Administration SystĂšme
- Informations de la société (avec mise à jour)
- Activation/désactivation des modules
- Lecture et écriture des constantes systÚme
- Modes et conditions de paiement, devises, pays
đ Installation
Méthode 1 : Via npx (recommandé, aucune installation)
npx mcp-dolibarr
Méthode 2 : Installation globale
npm install -g mcp-dolibarr
Méthode 3 : Depuis le code source
git clone https://github.com/digitalfactorysn/mcp-dolibarr.git
cd mcp-dolibarr
npm install && npm run build
âïž Configuration
1. Activer l'API REST dans Dolibarr
Dans votre Dolibarr : Accueil > Configuration > Modules > Activez "API REST Dolibarr"
2. Obtenir votre Clé API
Dans votre Dolibarr : Accueil > Utilisateurs & Groupes > [Votre profil] > Onglet "Fiche utilisateur"
Copiez la valeur du champ "Clé pour l'API REST" (générez-en une si elle est vide).
đ Connexion avec Claude Desktop
Ăditez le fichier de configuration de Claude Desktop :
- Mac :
~/Library/Application Support/Claude/claude_desktop_config.json - Windows :
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"dolibarr": {
"command": "npx",
"args": ["mcp-dolibarr"],
"env": {
"DOLIBARR_URL": "https://votre-instance.dolibarr.com",
"DOLIBARR_API_KEY": "VOTRE_CLE_API_SECRETE"
}
}
}
}
RedĂ©marrez Claude Desktop. Un nouvel icĂŽne đ apparaĂźtra â Dolibarr est connectĂ© !
đ Connexion avec Cursor / Windsurf
Dans les paramĂštres MCP de votre IDE :
{
"mcp": {
"servers": {
"dolibarr": {
"command": "npx",
"args": ["mcp-dolibarr"],
"env": {
"DOLIBARR_URL": "https://votre-instance.dolibarr.com",
"DOLIBARR_API_KEY": "VOTRE_CLE_API"
}
}
}
}
}
đĄ Exemples d'utilisation avec l'IA
Une fois connecté, vous pouvez demander à votre IA :
"Quelles sont les 5 derniÚres factures impayées ?"
â list_invoices (status=1, limit=5)
"Crée un devis pour STN GROUPE pour la maintenance Azure à 150 000 FCFA HT avec 18% TVA"
â create_proposal â add_proposal_line â validate_proposal
"Quel est notre chiffre d'affaires de 2025 ?"
â get_financial_summary (year=2025)
"Montre-moi le plan comptable"
â list_accounting_accounts
"Quels modules sont activés sur notre Dolibarr ?"
â list_modules
đ SĂ©curitĂ©
- Ne committez jamais votre clé API dans un dépÎt Git.
- Utilisez un compte Dolibarr dédié avec les permissions minimales nécessaires.
- La clé API est transmise uniquement entre votre machine locale et l'instance Dolibarr (pas via des services tiers).
đ License
MIT © Digital Factory Senegal
đ Contact & Support
- Issues & bugs : GitHub Issues
- Contribuer : Les Pull Requests sont les bienvenues !