Audit de couverture MCP — Gap analysis automatisée

# Audit de couverture MCP — Gap analysis automatisée

## But
Re-évaluer systématiquement la couverture MCP face aux 50 cas d'usages des 5 personas finance, détecter les améliorations depuis la dernière analyse, et régénérer `scenarios/mcp-gap-analysis.md` à jour.

À lancer après chaque update MCP (nouveaux endpoints, nouveaux champs) ou trimestriellement.

---

## Phase 1 — Inventaire des outils MCP disponibles

### Étape 1.1 — Sonder chaque outil pour découvrir les champs réels

Pour chaque outil listé ci-dessous, appelle-le avec des paramètres minimaux et inspecte la structure de la réponse. Note les champs effectivement retournés.

```
OUTILS À SONDER :

get_wallet_loads         → noter les champs retournés
get_wallet_summary       → noter les champs retournés
spendesk_analyze_spend   → appeler avec groupBy:supplier, period:last_month
                           → noter paramètres acceptés + structure résultat
get_payables             → appeler avec limit:1
                           → noter TOUS les champs (chercher spécialement :
                             paymentDate, approvedAt, submittedAt, processingDays,
                             rejectionCount, disputeStatus, payableSubType)
get_payable_by_id        → utiliser le premier ID trouvé
                           → noter champs vs get_payables
get_payable_attachments  → appeler avec un payableId
get_suppliers            → appeler avec limit:1
                           → chercher : paymentTerms, preferredStatus, riskScore
get_supplier_by_id       → utiliser le premier ID trouvé
get_purchase_orders      → appeler avec limit:1
                           → chercher : contractEndDate, autoRenewal,
                             noticePeriodDays, invoiceIds
get_requests             → appeler avec limit:1
get_request_by_id        → utiliser le premier ID trouvé
list_cards               → appeler avec limit:1
get_card                 → utiliser le premier ID trouvé
get_transactions          → appeler avec limit:1 (transactions carte, distinct de get_settlements)
get_cost_centers         → noter si budgetAmount ou budgetId présent
get_users                → appeler avec limit:1
get_expense_categories   → appeler
get_analytical_fields    → appeler
get_analytical_field_values → utiliser le premier fieldId trouvé
get_chart_of_accounts    → appeler
get_settlements          → appeler avec limit:1
                           → chercher : bankTransactionId, bankReference
list_companies           → appeler (nécessite org token)
```

### Étape 1.2 — Détecter les nouveaux outils non connus

En plus des outils listés ci-dessus, cherche s'il existe des outils MCP Spendesk non répertoriés dans cette liste. Cela inclut :
- `get_budgets` ou tout outil avec "budget" dans le nom
- `get_payable_events` ou tout outil avec "events" / "history" / "audit"
- `get_bank_transactions` ou tout outil avec "bank" / "transaction"
- `approve_*` ou tout outil d'écriture (write/create/update/approve)

Note tous les nouveaux outils découverts comme **NOUVEAU** dans ton rapport.

### Étape 1.3 — Construire la matrice d'inventaire

Construire un tableau récapitulatif :

```
| Outil | Disponible | Champs notables | Nouveaux champs vs analyse précédente |
```

---

## Phase 2 — Évaluation des 50 cas d'usages

Pour chaque cas d'usage ci-dessous, re-évalue la **faisabilité actuelle** en fonction des outils et champs découverts en Phase 1. Utilise la grille de scoring :

```
Score 80–100 (✅ A) : Faisable avec les outils actuels, résultat fiable
Score 60–79  (🔧 B) : Faisable avec workaround multi-étapes ou approximations
Score 40–59  (⚠️ C) : Partiellement faisable, données incomplètes
Score ≤39    (❌ D) : Non faisable, outils manquants
```

### Grille d'évaluation des 50 cas d'usages

#### CFO (10 cas)

| # | Cas d'usage | Outils requis | Score précédent | Score actuel | Δ |
|---|-------------|---------------|:---------------:|:------------:|:-:|
| C1 | Dashboard trésorerie multi-entités | list_companies, get_wallet_summary | 78 | ? | ? |
| C2 | Flash mensuel dépenses (top catégories + YoY) | spendesk_analyze_spend | 87 | ? | ? |
| C3 | Budget vs Réel par cost center | **get_budgets** (manquant) | 15 | ? | ? |
| C4 | Cash flow forecast AP (30/60/90j) | get_payables, spendesk_analyze_spend | 70 | ? | ? |
| C5 | Approbations bloquées (factures > Xj) | get_payables (status + date filter) | 72 | ? | ? |
| C6 | KPIs équipe finance (délais, taux approbation) | **Payable.approvedAt** (manquant) | 20 | ? | ? |
| C7 | Consolidation dépenses multi-entités | list_companies, spendesk_analyze_spend | 78 | ? | ? |
| C8 | Concentration risque fournisseurs (Pareto) | spendesk_analyze_spend, get_suppliers | 80 | ? | ? |
| C9 | Conformité politique dépenses | get_payables, list_cards | 68 | ? | ? |
| C10 | Board pack automatique | Hors scope MCP | 10 | ? | ? |

#### Controller (10 cas)

| # | Cas d'usage | Outils requis | Score précédent | Score actuel | Δ |
|---|-------------|---------------|:---------------:|:------------:|:-:|
| CT1 | Checklist clôture mensuelle | get_payables, get_settlements, spendesk_get_due_invoices | 87 | ? | ? |
| CT2 | Réconciliation settlements vs export GL | get_settlements | 85 | ? | ? |
| CT3 | Détection doublons factures | get_payables, get_supplier_by_id | 65 | ? | ? |
| CT4 | Validation mapping GL | get_payables, get_chart_of_accounts | 73 | ? | ? |
| CT5 | Réconciliation export comptable complète | get_payables (date filters) | 87 | ? | ? |
| CT6 | Audit trail facture (qui a approuvé, quand) | **get_payable_events** (manquant) | 15 | ? | ? |
| CT7 | Contrôle validité justificatifs | get_payable_attachments | 87 | ? | ? |
| CT8 | Préparation données FEC | get_payables, get_chart_of_accounts | 55 | ? | ? |
| CT9 | Régularisation fin de période | get_payables | 78 | ? | ? |
| CT10 | Rapprochement bancaire | **get_bank_transactions** (manquant) | 10 | ? | ? |

#### AP Manager (10 cas)

| # | Cas d'usage | Outils requis | Score précédent | Score actuel | Δ |
|---|-------------|---------------|:---------------:|:------------:|:-:|
| AP1 | File d'attente AP (factures prioritaires) | spendesk_get_due_invoices, get_suppliers | 83 | ? | ? |
| AP2 | Audit onboarding fournisseur | get_suppliers, get_payables | 85 | ? | ? |
| AP3 | Analyse encours fournisseur (détail) | get_payables, get_suppliers | 87 | ? | ? |
| AP4 | Approbation batch (approuver N factures) | **approve_payables** (manquant) | 5 | ? | ? |
| AP5 | SLA paiement vs conditions contractuelles | **Supplier.paymentTerms** (manquant) | 55 | ? | ? |
| AP6 | Fournisseurs à risque (rejets, litiges) | **Payable.rejectionCount** (manquant) | 20 | ? | ? |
| AP7 | Matching facture ↔ BdC (3-way) | get_payables, get_purchase_orders | 72 | ? | ? |
| AP8 | DPO (Days Payable Outstanding) | get_payables | 70 | ? | ? |
| AP9 | Catalogue fournisseurs approuvés | get_suppliers | 88 | ? | ? |
| AP10 | Détection réclamations / doublons | get_payables | 65 | ? | ? |

#### Finance Analyst (10 cas)

| # | Cas d'usage | Outils requis | Score précédent | Score actuel | Δ |
|---|-------------|---------------|:---------------:|:------------:|:-:|
| FA1 | Analyse dépenses par département (MoM) | spendesk_analyze_spend × 3-6 mois | 83 | ? | ? |
| FA2 | Benchmark catégories vs période précédente | spendesk_analyze_spend | 83 | ? | ? |
| FA3 | Détection anomalies (outliers dépenses) | get_payables, spendesk_analyze_spend | 70 | ? | ? |
| FA4 | ROI par fournisseur | Hors scope Spendesk | 10 | ? | ? |
| FA5 | Analyse SaaS spend + croissance | get_payables (subscription), get_suppliers | 83 | ? | ? |
| FA6 | Spend par employé (top spenders) | spendesk_analyze_spend, get_users | 78 | ? | ? |
| FA7 | Tail spend (analyse long-tail fournisseurs) | spendesk_analyze_spend, get_suppliers | 75 | ? | ? |
| FA8 | Prévision fin d'année (extrapolation YTD) | spendesk_analyze_spend | 73 | ? | ? |
| FA9 | Analyse coûts cachés (frais bancaires) | **Payable.payableSubType** (manquant) | 25 | ? | ? |
| FA10 | Consolidation reporting finance multi-sources | list_companies, spendesk_analyze_spend | 78 | ? | ? |

#### Procurement (10 cas)

| # | Cas d'usage | Outils requis | Score précédent | Score actuel | Δ |
|---|-------------|---------------|:---------------:|:------------:|:-:|
| P1 | Suivi POs ouverts (% consommé, alertes) | get_purchase_orders | 87 | ? | ? |
| P2 | Alerte dépassement budget PO | get_purchase_orders | 87 | ? | ? |
| P3 | POs inactifs (ouverts sans facture > 60j) | get_purchase_orders, get_payables | 78 | ? | ? |
| P4 | Consolidation achats fournisseur (négociation) | spendesk_analyze_spend, get_suppliers | 85 | ? | ? |
| P5 | Maverick spend (dépenses hors PO) | get_payables, get_purchase_orders | 68 | ? | ? |
| P6 | Due diligence fournisseurs | get_suppliers | 85 | ? | ? |
| P7 | Demandes d'achat en attente (aging) | get_requests | 80 | ? | ? |
| P8 | Concentration risque fournisseurs | spendesk_analyze_spend | 82 | ? | ? |
| P9 | Renouvellement contrats (POs à terme) | **PO.contractEndDate** (manquant) | 55 | ? | ? |
| P10 | Catalogue catégories d'achats | get_expense_categories, spendesk_analyze_spend | 80 | ? | ? |

---

## Phase 3 — Calcul de la couverture globale

```
Pour chaque persona, calculer :
  Cas A (≥80) : X/10
  Cas B (60-79) : X/10
  Cas C (40-59) : X/10
  Cas D (≤39) : X/10
  Score moyen : (somme des scores) / 10
  Couverture (A+B) : X/10

Couverture globale = (nombre de cas ≥60 sur 50) / 50 × 100

Comparer avec l'analyse précédente :
  Couverture précédente : 69%
  Couverture actuelle : X%
  Évolution : +X pts
```

---

## Phase 4 — Détecter les changements vs analyse précédente

### Comparer outil par outil

```
Pour chaque outil inventorié en Phase 1 :
  Comparer les champs retournés avec les "champs manquants" listés dans mcp-gap-analysis.md
  
  Pour chaque champ manquant précédemment identifié :
    Si le champ EXISTE maintenant → 🟢 GAP FERMÉ
    Si le champ est TOUJOURS absent → 🔴 GAP PERSISTANT

Pour chaque nouvel outil découvert :
    → ⭐ NOUVEAU TOOL : X — impacte les cas d'usages : [liste]
```

### Évaluer l'impact des nouveaux champs/outils

```
Pour chaque GAP FERMÉ ou NOUVEAU TOOL :
  Identifier les cas d'usages impactés (se référer aux grilles Phase 2)
  Calculer le nouveau score pour ces cas d'usages
  Expliquer pourquoi le score a changé
```

---

## Phase 5 — Régénérer le rapport mcp-gap-analysis.md

Écrire le fichier `scenarios/mcp-gap-analysis.md` mis à jour avec :

### Structure du rapport à produire

```markdown
# Spendesk MCP — Analyse des gaps par persona

> Version : [date du jour]
> Version précédente : [date analyse précédente]
> Évolution couverture : [X%] → [Y%] (+Z pts)

## Résumé des changements depuis la dernière analyse

### Gaps fermés (nouvelles capacités détectées)
- [outil/champ] : impact sur [cas d'usages]

### Nouveaux gaps détectés
- [outil/champ manquant] : impact sur [cas d'usages]

### Gaps persistants (non encore traités)
- [outil/champ] : X mois sans changement

## Résumé exécutif
[tableau couverture par persona — mis à jour]

## Inventaire des outils MCP disponibles
[mis à jour avec champs réels]

## Analyse par persona
[mis à jour avec nouveaux scores]

## Taxonomie des gaps
[mis à jour — retirer les gaps fermés, ajouter les nouveaux]

## Roadmap recommandée
[mis à jour — recalculer les phases en fonction des gaps restants]

## Points de friction UX
[mis à jour si de nouveaux points identifiés]
```

---

## Notes d'utilisation

- **Lancer ce skill après chaque release MCP** pour détecter automatiquement les nouveaux champs ou outils
- **Durée estimée :** 15–25 minutes (appels MCP + analyse + génération)
- **Output :** `scenarios/mcp-gap-analysis.md` mis à jour + résumé des changements dans le chat
- **Tracking :** Chaque version du rapport inclut sa date pour permettre un suivi historique

## Exemples de prompts
- "Lance l'audit MCP — le MCP vient d'être mis à jour avec de nouveaux champs"
- "Refais l'analyse de couverture MCP pour voir ce qui a changé"
- "Y a-t-il de nouveaux outils MCP Spendesk disponibles ?"