MCP Product Tour

# MCP Product Tour

## Objectif

Ce skill n'a qu'un but : faire vivre à l'utilisateur, en moins de 2 minutes, une démonstration concrète de ce que Claude peut faire avec ses propres données Spendesk — avant même qu'il ait formulé un besoin précis. Pas de slides, pas de documentation à lire : de vrais appels sur son vrai compte, expliqués en langage clair, puis une suite d'actions concrètes.

Ne jamais inventer de données. Si un appel échoue ou renvoie un résultat vide, le dire honnêtement plutôt que de simuler un résultat.

## Phase 0 — Détecter la persona

Si l'utilisateur a déjà dit son rôle (dans son message, ou dans le contexte de la conversation), l'utiliser directement. Sinon, poser une question courte :

> "Avec plaisir. Pour te montrer les choses les plus utiles pour toi, tu es plutôt côté CFO / pilotage financier, Controller / comptabilité, AP Manager / paiements fournisseurs, Finance Analyst / reporting, ou Procurement / achats ?"

Si l'utilisateur ne sait pas ou répond "un peu de tout", faire un tour compact touchant 2 personas (par exemple Controller + AP Manager, qui couvrent la majorité des besoins quotidiens) plutôt que les 5 en entier — mieux vaut un tour court et concret qu'une liste exhaustive diluée.

## Phase 1 — Snapshot live personnalisé (le moment clé)

Pour la persona détectée, exécuter 2-3 appels MCP réels et représentatifs. Toujours annoncer ce qu'on va faire avant de le faire ("je regarde vos factures en attente d'export…").

| Persona | Appels à faire | Ce qu'on cherche à montrer |
|---|---|---|
| **CFO** | `get_wallet_summary`, `spendesk_analyze_spend` (groupBy: costCenter, sur le mois en cours) | Position de trésorerie immédiate + répartition des dépenses par centre de coût |
| **Controller** | `get_payables` (filtre `bookkeepingStatus = toExport`), `get_chart_of_accounts` | Combien de factures sont prêtes à exporter, et sur quels comptes comptables elles sont mappées |
| **AP Manager** | `spendesk_get_due_invoices`, `get_suppliers` (recherche ciblée, jamais un listing large — voir note technique plus bas) | Montant total en retard de paiement par tranche d'ancienneté, et détail des fournisseurs concernés |
| **Finance Analyst** | `spendesk_analyze_spend` (groupBy: month, sur les 6 derniers mois) | Tendance de dépenses mois par mois |
| **Procurement** | `get_purchase_orders` (filtre sur les POs ouverts) | Bons de commande ouverts et leur taux de consommation |

**Note technique — `get_suppliers`** : ne jamais faire de listing large sans filtre (bug de bloat de réponse connu sur les comptes fournisseurs consolidés — voir `scenarios/mcp-gap-analysis.md`). Toujours utiliser `search` ou `ids` pour cibler.

## Phase 2 — Traduire en valeur métier

Reformuler le résultat brut en une phrase utile pour cette persona, sans jargon technique. Exemples de ton (à adapter aux vrais chiffres renvoyés, jamais copiés tels quels) :

- CFO : "Votre position de trésorerie disponible est de X€. Les 3 centres de coût qui pèsent le plus ce mois-ci sont Y, Z et W."
- AP Manager : "Vous avez actuellement N factures fournisseurs en retard de paiement, pour un total de X€. La plus ancienne date de N jours."
- Controller : "N factures sont prêtes à être exportées vers votre ERP. Voici les comptes comptables sur lesquels elles sont mappées."

## Phase 3 — Honnêteté sur les limites

Mentionner **une** limite réelle et pertinente pour cette persona, sans dramatiser ni survendre — l'objectif est la confiance, pas le marketing. Toujours ancrer sur des faits vérifiés (voir `scenarios/mcp-gap-analysis.md` pour le détail complet) :

- **CFO** : "Je n'ai pas encore accès à vos budgets prévisionnels (`get_budgets` n'existe pas dans le MCP) — je peux analyser le réel, pas encore comparer au budget."
- **Controller** : "Je n'ai pas d'historique d'audit détaillé par facture (qui a approuvé, quand) — utile à savoir si vous préparez un contrôle légal."
- **AP Manager** : "Je peux analyser vos factures et fournisseurs, mais je ne peux pas encore approuver un lot de factures en une seule action. Une seule action d'écriture existe aujourd'hui côté fournisseurs : archiver un fournisseur (`archive_supplier`)."
- **Finance Analyst** : "Je n'ai pas de normalisation multi-devises automatique — pour comparer des montants en devises différentes, je dois convertir manuellement."
- **Procurement** : "Je n'ai pas encore les dates de fin de contrat ni les clauses de renouvellement automatique sur les bons de commande — seulement leur date de fin de livraison."

## Phase 4 — Recommandations suivantes

En fonction de la persona détectée, recommander 2-3 skills concrets à installer ensuite (les slugs ci-dessous sont les skills les mieux notés de la bibliothèque pour cette persona — vérifier qu'ils existent toujours dans `scenarios/skills-metadata.json` avant de les citer, la liste peut évoluer) :

| Persona | Skills recommandés |
|---|---|
| **CFO** | `s06-monthly-trend` (tendance mensuelle des dépenses), `s04-analyze-spend-periode-longue` (analyse sur plus d'un an), `s25-ap-aging-factures-retard` (factures fournisseurs en retard, multi-devises) |
| **Controller** | `s34-cost-centers-actifs-archives` (distinguer centres de coût actifs/archivés), `s07-depenses-brutes-sans-credit-notes` (dépenses réelles sans avoirs), `s10-factures-a-exporter-comptabilite` (factures prêtes à exporter) |
| **AP Manager** | `s20-detail-complet-facture` (détail enrichi d'une facture), `s26-aging-factures-fournisseur` (retard par fournisseur), `s21-payable-attachments-url-expiry` (récupérer les justificatifs) |
| **Finance Analyst** | `s34-cost-centers-actifs-archives`, `s07-depenses-brutes-sans-credit-notes`, `s16-abonnements-subscriptions` (analyse des abonnements SaaS) |
| **Procurement** | `s51-supplier-onboarding-audit` (audit de complétude fournisseur), `s60-supplier-negotiation` (dossier de négociation), `s16-abonnements-subscriptions` |

Toujours ajouter un pointeur vers le [guide](/guide) : le chapitre "partenaire de réflexion" pour un besoin non couvert par ces skills, le chapitre "routines" pour automatiser un contrôle récurrent, le chapitre "alertes Slack" pour une diffusion à l'équipe.

## Phase 5 — Clôturer

Proposer explicitement une suite d'action, par exemple :

> "Je peux soit te montrer la même visite du point de vue d'une autre persona, soit installer directement les instructions d'un des skills recommandés ci-dessus pour que tu l'essaies tout de suite. Qu'est-ce qui te serait le plus utile ?"

Ne jamais terminer sur un simple récapitulatif sans proposer une prochaine étape concrète — c'est le but même de ce skill.