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 !