Build · Construire

MCPisation de vos progiciels

Votre ERP, votre CRM ou votre outil métier, utilisable par un agent, avec les bons outils, et seulement ceux-là.

Décrire mon API L'outil, dans le Lab

Point de départ

Un swagger

OpenAPI 2.0, 3.0 ou 3.1

Livrable

Serveur MCP

dans votre dépôt

Format

Forfait

Le problème

Convertir une API en serveur MCP prend une heure : des générateurs le font automatiquement. Le résultat est rarement utilisable par un agent. Des dizaines ou des centaines d'outils, des noms techniques, des descriptions absentes, et aucune différence visible entre lire une facture et la supprimer. L'agent se trompe d'outil, épuise son contexte à lire des schémas, ou déclenche une action que personne n'avait prévue.

Démonstration

118 opérations. 15 outils.

Ce que devient une API quand on la prépare pour un agent.

1Inventaire

118opérations, sur 27 ressources.
2Classement
- 52lectures
- 17créations
- 29modifications ou suppressions
- 20actions
3Drapeaux
- 9mouvements d'argent
- 21opérations touchent des données personnelles
- 1GET qui écrit : jamais en lecture seule
- 1description suspecte
- 1secret probable
4Sélection

20opérations retenues pour le cas d'usage : relancer les factures impayées d'un client.

98écartées, chacune avec son motif : hors budget 76, interne 8, obsolète 4, doublon de version 4, authentification 3, binaire 3.
5Plan

15outils, dont 5 regroupements : une liste et son détail réunis en un seul outil. 4 demandent une confirmation humaine.

GET/clients●
POST/clients●
GET/clients/{id}●
PUT/clients/{id}●
DELETE/clients/{id}●
POST/clients/recherche●
GET/clients/{id}/contacts●
POST/clients/{id}/contacts●
GET/clients/{id}/contacts/{contactId}●
PATCH/clients/{id}/contacts/{contactId}●
DELETE/clients/{id}/contacts/{contactId}●
GET/clients/{id}/notes
POST/clients/{id}/notes
GET/clients/{id}/factures
GET/clients/{id}/solde
GET/clients/{id}/echeances
POST/clients/{id}/envoyer-releve
GET/clients/{id}/historiqueobsolète
PUT/clients/{id}/conditions-commerciales
GET/v1/clients●doublon de version
GET/v1/clients/{id}●doublon de version
GET/factures
POST/factures€
GET/factures/{id}
PATCH/factures/{id}€
GET/factures/{id}/lignes
POST/factures/{id}/relancer€
POST/factures/{id}/promesses-paiement€
GET/factures/{id}/promesses-paiement
GET/factures/{id}/pdfbinaire
POST/factures/{id}/annuler€
GET/factures/{id}/historique-relancesobsolète
GET/v1/facturesdoublon de version
GET/v1/factures/{id}doublon de version
GET/avoirs
GET/avoirs/{id}
POST/avoirs€
GET/avoirs/{id}/pdfbinaire
GET/paiements
GET/paiements/{id}
POST/paiements€
POST/paiements/{id}/rembourser€
GET/paiements/{id}/justificatifbinaire
GET/virements
POST/virements€
GET/relances
GET/relances/{id}
POST/relances
PATCH/relances/{id}
DELETE/relances/{id}
POST/relances/{id}/annuler
GET/commandes
POST/commandes
GET/commandes/{id}
PATCH/commandes/{id}
DELETE/commandes/{id}
GET/commandes/{id}/validerGET qui écrit
POST/commandes/{id}/annuler
GET/commandes/{id}/lignes
GET/produits
POST/produits
GET/produits/{id}description suspecte
PUT/produits/{id}
DELETE/produits/{id}
GET/produits/{id}/stock
PATCH/produits/{id}/prix
POST/produits/{id}/archiver
GET/produits/catalogueobsolète
GET/fournisseurs
POST/fournisseurs
GET/fournisseurs/{id}
PUT/fournisseurs/{id}
DELETE/fournisseurs/{id}obsolète
GET/devis
POST/devis
GET/devis/{id}
PATCH/devis/{id}
POST/devis/{id}/valider
POST/devis/{id}/signer
GET/contrats
POST/contrats
GET/contrats/{id}
PUT/contrats/{id}
POST/contrats/{id}/cloturer
GET/utilisateurs●
GET/utilisateurs/{id}●
PATCH/utilisateurs/{id}●
DELETE/utilisateurs/{id}●
POST/utilisateurs/{id}/notifier●
GET/commerciaux●
GET/commerciaux/{id}●
PATCH/commerciaux/{id}●
GET/oauth/authorizeauthentification
POST/oauth/tokenauthentification
POST/loginauthentification
GET/santeinterne
GET/metriquesinterne
DELETE/debug/cacheinterne
PUT/debug/niveau-loginterne
POST/debug/diagnosticsinterne
GET/jobsinterne
GET/jobs/{id}interne
POST/jobs/{id}/declencherinterne
GET/webhooks
POST/webhookssecret probable
DELETE/webhooks/{id}
PUT/admin/parametres
DELETE/admin/sessions/{id}
PATCH/admin/roles/{id}
POST/synchronisations/{id}/lancer
POST/imports/{id}/valider
PUT/imports/{id}/mapping
POST/rapports/{id}/publier
PATCH/rapports/{id}
PUT/taxes/{id}
POST/taxes/{id}/archiver
POST/entrepots/{id}/cloturer
POST/devises/{code}/synchroniser

GET /commandes/{id}/valider un GET qui écrit : jamais en lecture seule

hors budget : 76

clients_findGET /clients · GET /clients/{id} lecture risque moyen lecture seule
contacts_findGET /clients/{id}/contacts · GET /clients/{id}/contacts/{contactId} lecture risque moyen lecture seule
factures_findGET /factures · GET /factures/{id} lecture risque faible lecture seule
paiements_findGET /paiements · GET /paiements/{id} lecture risque faible lecture seule
relances_findGET /relances · GET /relances/{id} lecture risque faible lecture seule
ajouter_note_clientPOST /clients/{id}/notes création risque moyen confirmation recommandée
lister_factures_clientGET /clients/{id}/factures lecture risque faible lecture seule
consulter_solde_clientGET /clients/{id}/solde lecture risque faible lecture seule
lister_echeances_clientGET /clients/{id}/echeances lecture risque faible lecture seule
envoyer_releve_clientPOST /clients/{id}/envoyer-releve action risque élevé confirmation requise
lister_lignes_factureGET /factures/{id}/lignes lecture risque faible lecture seule
relancer_facturePOST /factures/{id}/relancer action risque critique confirmation requise
enregistrer_promesse_paiementPOST /factures/{id}/promesses-paiement création risque critique confirmation requise
creer_avoirPOST /avoirs création risque critique confirmation requise
planifier_relancePOST /relances création risque moyen confirmation recommandée

Illustration. API fictive « Mirelia ERP », conçue pour tester mcp-readiness. Sortie visée de l'outil.

Ce que nous faisons

L'inventaire. Chaque opération de votre API est classée : lecture, création, modification, suppression, action métier. Les opérations sensibles sont repérées.
Le plan d'outils. Nous retenons les opérations utiles aux cas d'usage visés, sous un budget d'outils explicite. Nous regroupons ce qui doit l'être, nous nommons et décrivons pour un agent, pas pour un développeur.
Les garde-fous. Chaque outil porte ses annotations MCP (lecture seule, destructif, idempotent), son niveau de risque et sa politique de confirmation humaine. Aucune opération d'écriture n'est présentée comme une lecture.
Le serveur. Nous livrons le serveur MCP, testé, dans votre dépôt, avec des artefacts standard que votre passerelle sait lire.

L'outil derrière la méthode

L'analyse s'appuie sur mcp-readiness, un outil de notre Lab. Ce que nous ajoutons, c'est l'arbitrage des cas ambigus et la construction du serveur.

Ce que ça vous permet

Ouvrir votre produit aux agents de vos clients sans leur donner les clés de toute l'API. Savoir ce qu'un agent peut faire avant qu'il le fasse. Changer de passerelle sans refaire le travail.

Repères

Pour qui

Éditeurs de progiciels dont les clients veulent brancher leurs agents

DSI qui veulent ouvrir un ERP, un CRM ou un outil interne à des agents

Équipes qui ont déjà un serveur MCP généré automatiquement, inutilisable en l'état

Livrables

Plan d'outils : opérations retenues, regroupements, noms, descriptions, niveaux de risque

Serveur MCP testé, dans votre dépôt

Politique de confirmation humaine pour chaque action à effet de bord

Rapport d'analyse de votre API : ce qui gêne un agent, et comment le corriger

Surcouche OpenAPI Overlay : votre spécification source n'est jamais modifiée

Ce que ce n'est pas

Une passerelle MCP de plus : nous alimentons la vôtre

La conversion automatique de toutes vos routes en outils

De l'hébergement ou un service managé

Extrait offert

« Les agents IA : la maîtrise avant la vitesse »

Extrait du chapitre 9 de Data & IA Detox. Offert, en échange de votre e-mail.

À voir aussi

Comprendre CMP-04