SymplesSSP/dendreo-mcp-analytics

📊 Dendreo MCP Analytics

Serveur MCP (Model Context Protocol) pour l'intégration de Claude Desktop avec les statistiques Dendreo. Permet d'analyser vos données de formation via une interface conversationnelle naturelle.

🚀 Installation

Installation npm (Recommandée)

Prérequis : Claude Desktop uniquement

Configuration Claude Desktop (~/claude_desktop_config.json) :

{
  "mcpServers": {
    "dendreo-analytics": {
      "command": "npx",
      "args": ["-y", "@symplessp/dendreo-mcp"],
      "env": {
        "DENDREO_API_KEY": "your-api-key-here",
        "DENDREO_BASE_URL": "https://pro.dendreo.com/{account}/api"
      }
    }
  }
}

Exemple concret :

{
  "mcpServers": {
    "dendreo-analytics": {
      "command": "npx", 
      "args": ["-y", "@symplessp/dendreo-mcp"],
      "env": {
        "DENDREO_API_KEY": "BUOCKzRmeaHwqXKJ98X0",
        "DENDREO_BASE_URL": "https://pro.dendreo.com/cpformation_sandbox/api"
      }
    }
  }
}

Redémarrez Claude Desktop - C'est tout ! ✅

Installation développement (Avancée)

Pour contribuer ou modifier le code :

1. Cloner et installer

git clone https://github.com/SymplesSSP/dendreo-mcp-analytics
cd dendreo-mcp-analytics
npm install
npm run build

2. Configuration locale Copiez .env.example vers .env et configurez vos credentials.

3. Test local

npm run dev

🎯 Utilisation

Une fois configuré, vous pouvez utiliser Claude Desktop pour analyser vos données Dendreo :

Exemples de requêtes

Analyse financière globale

"Quel a été mon chiffre d'affaires ce mois-ci ?"

Performance par client

"Montre-moi les statistiques de mon client EDF"

Analyse par type de client

"Analyse mes prospects non-clients"

🛠️ Outils disponibles

dendreo_get_financial_stats

Récupère les statistiques financières des entreprises clientes.

Paramètres :

• client_id (optionnel) : ID spécifique d'une entreprise
• client_type (optionnel) : "clients", "fournisseurs", "nonclients"
• time_period (optionnel) : "current_month", "last_month", "current_quarter", "last_quarter"

Exemple de réponse :

💰 Analyse Financière

Synthèse globale (4 entreprises)
• CA total facturé : 124 981 €
• CA formations : 107 550 € (86%)  
• Recettes prévisionnelles : 140 000 €

Top 3 clients :
1. EDF : 45 231 € (36%)
2. Peugeot : 32 100 € (26%) 
3. Total Energies : 28 750 € (23%)

🔧 Développement

Mode développement

Définir USE_MOCK_API=true dans .env pour utiliser des données simulées.

Tests

npm test                # Tests unitaires
npm run test-install    # Script de validation automatisé
npm run validate        # Build + tests complets
npm run test-api        # Test rapide de l'API Dendreo

Structure du projet

src/
├── index.ts                # Point d'entrée MCP
├── services/
│   ├── api-interface.ts    # Interface commune
│   ├── dendreo-api.ts     # Client API Dendreo
│   └── mock-dendreo-api.ts # Données simulées
├── tools/
│   └── financial-stats.ts # Outil statistiques financières
└── types/
    └── dendreo.ts         # Types TypeScript

🐛 Dépannage

Erreurs communes

404 Not Found sur endpoints API

• Vérifiez votre URL de base dans DENDREO_BASE_URL
• Validez votre clé API et compte

Permission denied

• Vérifiez les droits de votre clé API
• Contactez votre administrateur Dendreo

Serveur MCP ne démarre pas

• Vérifiez que Node.js 18+ est installé
• Exécutez npm run build pour compiler le TypeScript
• Vérifiez les logs dans Claude Desktop

Mode debug

Activez les logs détaillés en définissant :

export DEBUG=dendreo:*

📋 Roadmap

Phase 1 - MVP ✅

• ✅ Architecture MCP avec TypeScript
• ✅ Intégration API Dendreo réelle
• ✅ Outil statistiques financières
• ✅ Cache intelligent avec TTL
• ✅ Mode développement avec données simulées
• ✅ Gestion d'erreurs robuste

Phase 2 - Extensions (À venir)

• 🚧 Outil analyse satisfaction formations
• 🚧 Outil performance actions de formation
• 🚧 Outil catalogue public
• 🚧 Dashboard exécutif consolidé
• 🚧 Filtres temporels avancés
• 🚧 Gestion multi-comptes

📖 Documentation

• - Procédure détaillée pas à pas
• - 18 questions pour valider l'intégration
• - Historique des versions et modifications

📄 License

MIT - Voir LICENSE pour détails.