MCP Server — Pilotez Dolibarr par IA

MCP Server transforme votre Dolibarr en ERP pilotable par l'intelligence artificielle. Il expose un point d'accès Model Context Protocol (MCP) standard, en JSON-RPC 2.0 sur HTTP stateless, auquel se connectent Claude (Anthropic), ChatGPT (OpenAI), Gemini (Google), Mistral et tout agent ou orchestrateur IA compatible MCP — sans jamais émettre le moindre appel sortant vers un fournisseur d'IA. L'IA vient se connecter à votre Dolibarr ; votre Dolibarr ne se connecte à personne.

Pourquoi ce module est différent

La plupart des intégrations « IA + ERP » sont des chatbots qui reformatent des données. MCP Server implémente le vrai protocole MCP (révision 2025-06-18), le standard ouvert d'Anthropic adopté par l'ensemble de l'industrie IA. Cela signifie :

• Interopérabilité native : n'importe quel client MCP (Claude Desktop, claude.ai, OpenAI Agents, LangChain, AutoGen, CrewAI, n8n, Make…) se connecte sans développement spécifique.
• Outils structurés avec JSON Schema : l'IA comprend exactement quels arguments passer, ce qui évite les hallucinations sur les paramètres.
• Prompts et ressources MCP : en plus des outils, le module expose des modèles de prompts métier prêts à l'emploi (qualification de lead, rédaction de devis, e-mail de relance) et des ressources URI adressables (dolibarr://thirdparty/{id}, dolibarr://invoice/{id}).

Sécurité — Le cœur du module

La sécurité n'est pas un ajout : elle est architecturale.

Jetons d'accès dédiés

Chaque client IA reçoit un jeton unique généré à partir de 30 octets aléatoires (mcp_xxxx…, 64 caractères hexadécimaux). Seul le hash SHA-256 est stocké en base — exactement comme les PAT de GitHub. Le jeton en clair est affiché une seule fois à la création ; si vous le perdez, vous en créez un nouveau. Chaque jeton est associé à :

• Un utilisateur Dolibarr précis — le jeton agit en son nom
• Des portées — groupes d'outils autorisés : tiers, ventes, factures, projets, etc.
• Une date d'expiration optionnelle
• Un suivi de dernière utilisation et de dernière IP

Double vérification des droits

Un appel IA est autorisé uniquement si :

1. Le jeton est actif, non expiré, et l'IP est dans la liste blanche (si configurée)
2. La portée du jeton inclut le groupe de l'outil demandé
3. L'utilisateur lié au jeton possède le droit Dolibarr natif correspondant (ex. : propal->creer pour créer un devis, facture->paiement pour enregistrer un paiement)

Il est impossible d'escalader les privilèges via un jeton. Un administrateur avec portée * reste limité aux droits de l'utilisateur associé.

Contrôles globaux configurables

Journal d'audit complet

Chaque appel MCP est enregistré : horodatage, utilisateur Dolibarr, méthode, outil appelé, résumé des arguments (les secrets sont toujours masqués), statut ok/error, durée en ms, IP du client. Consultable directement dans l'interface d'administration du module.

27 outils métier

🏢 Tiers et contacts (thirdparty)

📋 Ventes (sales)

🧾 Factures (invoice)

📁 Projets et agenda (project)

📦 Produits (product)

📊 Analytique (analytics)

⚙️ Système (system)

Prompts et ressources MCP

Prompts prêts à l'emploi :

• qualify_lead — Guide l'IA pour qualifier un prospect et proposer les prochaines étapes dans Dolibarr
• draft_proposal — Aide l'IA à structurer un devis commercial pour un client
• dunning_email — Génère un e-mail de relance courtois pour une facture impayée

Ressources URI :

• dolibarr://thirdparty/{id} — Fiche complète d'un tiers au format JSON
• dolibarr://invoice/{id} — Fiche complète d'une facture au format JSON

Connexion à un client IA

Claude Desktop / claude.ai : ajoutez un connecteur personnalisé avec l'URL du point d'accès et le jeton porteur.

Clients stdio uniquement (via mcp-remote) :

{
  "mcpServers": {
    "dolibarr": {
      "command": "npx",
      "args": ["mcp-remote", "https://votre-dolibarr/custom/mcpserver/mcp.php",
               "--header", "Authorization: Bearer VOTRE_JETON"]
    }
  }
}

Configuration requise

• Dolibarr 22.0 ou supérieur
• PHP 8.1 ou supérieur