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 !