wp mcp:tool register create_invoice. Cette commande, exécutée sur l’installation WordPress de l’atelier de mobilier Atelier Kraft, enregistre l’outil au cœur de cet article : un serveur MCP maison capable de créer une facture Stripe à partir d’une commande WooCommerce existante, sur demande d’un agent conversationnel utilisé par l’équipe administrative.
Le besoin venait d’un usage récurrent : générer une facture complémentaire pour un client professionnel ayant demandé un ajustement après commande (frais de livraison spécifique, option supplémentaire facturée a posteriori), une tâche manuelle répétitive que l’équipe souhaitait pouvoir déléguer à un agent, sans pour autant lui laisser un accès libre à la facturation Stripe dans son ensemble.
Ce que l’outil MCP expose exactement
L’outil create_invoice accepte trois paramètres : l’identifiant de la commande WooCommerce d’origine, un montant en euros, et une description courte du motif de la facture complémentaire. Il ne donne accès à aucune autre capacité Stripe : ni remboursement, ni modification d’un abonnement, ni consultation de l’historique complet d’un client, volontairement exclus du périmètre de ce serveur.
{
"name": "create_invoice",
"description": "Cree une facture Stripe complementaire liee a une commande WooCommerce",
"parameters": {
"type": "object",
"properties": {
"order_id": { "type": "integer" },
"amount_eur": { "type": "number", "maximum": 500 },
"reason": { "type": "string" }
},
"required": ["order_id", "amount_eur", "reason"]
}
}Étapes de mise en œuvre
- Créer un endpoint interne WordPress qui vérifie l’existence de la commande WooCommerce et récupère l’identifiant client Stripe associé.
- Exposer cet endpoint comme outil MCP, avec un schéma de paramètres imposant un montant maximal strict.
- Appeler l’API Stripe pour créer un objet Invoice lié au client, avec la ligne de facturation correspondant au motif fourni.
- Renvoyer à l’agent un résumé de la facture créée, incluant son lien de paiement, sans jamais exécuter le paiement lui-même automatiquement.
La limite de montant, non négociable
Le plafond de cinq cents euros par facture créée automatiquement n’est pas un simple conseil dans la documentation de l’outil : il est imposé au niveau du schéma du paramètre amount_eur, ce qui signifie qu’aucun appel dépassant ce montant ne peut techniquement aboutir, quelle que soit l’insistance de la formulation employée par l’utilisateur de l’agent. Un montant supérieur nécessaire dans un cas exceptionnel doit repasser par le circuit de facturation manuel habituel.
Ce choix découle d’un principe simple appliqué à tout outil MCP qui touche à de l’argent réel : plus l’action est irréversible ou coûteuse, plus la marge de manœuvre laissée à l’agent doit être réduite techniquement, pas seulement recommandée dans une consigne textuelle facilement contournable par une reformulation habile.
La confirmation explicite avant création
Avant tout appel réel à l’API Stripe, l’outil renvoie d’abord un résumé de la facture qui serait créée, et attend une confirmation explicite de l’utilisateur transmise par l’agent, plutôt que de créer la facture dès le premier appel. Cette étape intermédiaire a évité au moins deux erreurs de commande mal identifiée lors des premières semaines d’usage, où l’agent avait mal interprété un numéro de commande mentionné oralement par l’équipe.
Un outil MCP qui touche à de l’argent réel gagne à demander deux fois avant d’agir : une première fois pour proposer, une seconde pour confirmer. Le coût d’une confirmation superflue reste toujours inférieur à celui d’une facture erronée.
Ce que cet outil ne fait pas
- Il ne gère aucun remboursement, entièrement traité par le circuit manuel existant.
- Il ne modifie aucun abonnement récurrent, seulement des factures ponctuelles complémentaires.
- Il ne dispense pas d’une vérification comptable régulière des factures ainsi créées.
La sécurité, un sujet volontairement traité ailleurs
L’authentification de ce serveur MCP, les droits d’accès accordés à l’agent et la journalisation détaillée des appels reçus relèvent d’un chantier distinct, non détaillé dans cet article centré sur la mécanique fonctionnelle de l’outil de facturation lui-même.
En résumé
Exposer une capacité de facturation à un agent via MCP demande moins de code que d’imaginer les garde-fous adaptés : un plafond de montant imposé techniquement et une étape de confirmation explicite ont suffi, sur ce projet, à rendre l’outil utilisable en confiance par l’équipe administrative d’Atelier Kraft, sans jamais lui laisser une autonomie totale sur la facturation.
