API et serveur MCP

Pilotez easyBTP par programme, ou par un assistant IA.

easyBTP expose une API REST de 953 opérations et un serveur MCP qui permet à un assistant IA de travailler directement dans votre ERP, en lecture et en écriture. Les deux sont inclus dans tous les plans, sans surcoût, et protégés par des clés qui portent des droits. Tout est hébergé en France.

953 opérations sur 14 modules
361 en lecture, 592 en écriture
Inclus dans Essentiel, Pro et Expert
Hébergement et traitement en France

Qu'est-ce que l'API easyBTP ?

C'est l'interface qui permet à un autre logiciel de lire et d'écrire dans easyBTP. Votre outil de comptabilité, votre site web, un tableur de direction ou un script interne peuvent récupérer vos affaires, créer un devis ou remonter des pointages, sans que personne ne ressaisisse quoi que ce soit.

Une seule adresse pour tout : https://api.easybtp.app
Une clé suffitpour s'authentifier, transmise dans un en-tête. Pas de jeton à rafraîchir toutes les heures.
Un catalogue introspectable: l'API sait décrire elle-même les opérations disponibles, ce qui évite de deviner et rend l'intégration beaucoup plus rapide.

Qu'est-ce que le serveur MCP easyBTP ?

Le MCP, pour Model Context Protocol, est un standard ouvert qui branche un assistant IA sur un logiciel métier. Avec le serveur MCP d'easyBTP, vous demandez à votre assistant où en est un chantier ou de préparer une relance, et il va chercher l'information dans votre ERP. Aucune ligne de code.

C'est la suite logique de notre approche : easyBTP est pensé pour que l'intelligence assistée travaille sur vos données métier, pas à côté. Le serveur MCP ouvre cette capacité à l'assistant de votre choix, en plus des fonctions intelligentes intégrées.

Adresse du serveur

https://mcp.easybtp.app/mcp

Il se déclare dans la configuration de votre client MCP, avec votre clé easyBTP transmise en en-tête. Le serveur fonctionne en HTTP, il n'y a donc rien à installer sur votre poste.

Que couvre l'API ?

953 opérations réparties sur 14modules, soit les mêmes domaines métier que l'application et pas un sous-ensemble réduit. Du devis au décompte général définitif, en passant par les achats, la facturation et le pointage, ce que vos équipes font dans l'interface est accessible par programme.

Répartition des 953opérations de l'API easyBTP par module, en lecture et en écriture
Module	Total	Lecture	Écriture
Études et devisDevis, bibliothèque de prix, appels d'offres, imports de catalogues et de clients.	217	77	140
Paramétrage et modèlesModèles de documents, personnalisation, rappels, préférences de la société.	180	48	132
Achats et sous-traitanceBons de commande, sous-traitance, fournisseurs, factures reçues.	146	54	92
Affaires et chantiersAvancement, avenants, pointages, attestations, DGD, analyse de rentabilité.	145	61	84
Facturation et règlementsFactures, avoirs, situations, impayés, retenue de garantie.	94	46	48
Pilotage et trésorerieTableaux de bord, trésorerie prévisionnelle, banque et rapprochement.	61	27	34
Stocks et matérielÉtat du parc, réservations, affectations, seuils et entrepôts.	40	17	23
Connecteurs et exportsSynchronisations, exports comptables, indices INSEE.	23	11	12
CRM et prescripteursPipeline commercial, opportunités, interactions, prescripteurs.	22	8	14
Utilisateurs et droitsCréation, désactivation, invitations, réinitialisation.	7	1	6
AssistanceTickets de support et échanges avec notre équipe.	6	2	4
Validation de documentsDemandes de validation, décisions, validations en attente.	6	3	3
Alertes et notificationsAlertes du tableau de bord, rappels, notifications non lues.	5	5	0
Tableau de bord généralVue de synthèse de l'activité.	1	1	0
Total	953	361	592

Quelques exemples concrets

Créer un devis, le dupliquer, l'exporter en PDF
Importer un catalogue d'articles ou une liste de clients, avec prévisualisation avant application
Déposer un CCTP et lancer sa lecture
Analyser la rentabilité d'une affaire et consulter l'historique
Créer, envoyer et annuler un bon de commande fournisseur
Générer la facture de solde d'un décompte général définitif
Lister les factures impayées, créer et émettre un avoir
Consulter la trésorerie prévisionnelle et rapprocher un mouvement bancaire
Réserver du matériel, suivre les affectations, mettre à jour les seuils de stock
Déplacer une opportunité dans le pipeline et la marquer gagnée
Demander la validation d'un document et enregistrer la décision

L'assistant peut-il écrire, ou seulement consulter ?

Les deux. Sur les 953 opérations, 361 sont en lecture seule et 592 écrivent réellement dans votre ERP. Un assistant branché sur le serveur MCP ne se contente donc pas de répondre à des questions : il peut créer un devis, envoyer un bon de commande ou enregistrer un règlement, dans la limite des droits de la clé.

Parmi les opérations d'écriture, 111sont explicitement marquées comme sensibles dans le catalogue, parce qu'elles suppriment ou annulent. Elles sont signalées comme telles pour qu'un assistant sache qu'il touche à quelque chose d'irréversible, et pour que vous puissiez les exclure d'une clé. Et les 592écritures exigent toutes une clé d'idempotence, sans exception : si un appel part deux fois, à cause d'un réseau capricieux ou d'un assistant qui réessaie, vous n'obtenez pas deux fois la même facture.

Comment fonctionnent les droits d'une clé API ?

Une clé porte des droits, exactement comme un utilisateur. Vous choisissez ce qu'elle peut voir et faire au moment de la créer. Une clé limitée à la lecture des factures ne pourra jamais modifier un devis, même si quelqu'un l'utilise mal. Le modèle de droits est celui que vous connaissez déjà.

Vous créez autant de clés que nécessaire

Une clé par intégration plutôt qu'une clé unique partout. Votre comptable, votre site vitrine et votre assistant IA ont chacun la leur, avec le strict nécessaire.

Vous révoquez sans casser le reste

Une clé compromise ou un prestataire qui s'arrête : vous supprimez la clé concernée. Les autres intégrations continuent de fonctionner normalement.

Le MCP hérite des mêmes droits

Le serveur MCP utilise l'API et sa clé. Un assistant IA ne peut donc rien faire que la clé n'autorise pas. Vous cadrez ce qu'il voit en amont, une bonne fois.

Vos données restent-elles en France ?

Oui. L'API et le serveur MCP tournent sur la même infrastructure française que le reste d'easyBTP. Vos affaires, votre bibliothèque de prix et vos clients ne quittent pas le territoire, et aucune donnée n'entraîne de modèle. C'est le même engagement que sur le produit.

Une précision utile et honnête : si vous branchez un assistant IA tiers sur le serveur MCP, les données que vous lui transmettez sont ensuite traitées chez cet éditeur, selon ses propres règles. Le choix de l'assistant vous appartient, et nous vous conseillons volontiers. Notre module Sécurité et Souveraineté détaille nos garanties.

À qui ça sert, concrètement ?

À trois profils. Aux PME qui veulent supprimer une double saisie entre easyBTP et un outil existant. Aux dirigeants qui veulent interroger leur activité en langage naturel. Et aux intégrateurs qui construisent une automatisation sur mesure pour leur client.

Supprimer une ressaisie entre easyBTP et votre comptabilité, votre paie ou votre outil de suivi interne.
Interroger votre activitédepuis un assistant : l'état d'un chantier, les factures en retard, la marge d'une affaire.
Alimenter vos propres outils : tableau de bord maison, site web, portail client, reporting groupe.

Quels logiciels de gestion BTP proposent un serveur MCP ?

Ils sont encore peu nombreux en France, et easyBTP en fait partie. Trois questions permettent de les départager utilement : combien d'opérations le serveur expose-t-il réellement, peut-il écrire ou seulement consulter, et dans quelle offre est-il inclus. Sur ces trois points, nos réponses sont 953, oui, et tous les plans.

Le périmètre: beaucoup d'offres exposent une sélection d'actions. Ici, le catalogue couvre 14 modules et le fonctionnement courant du produit, pas une vitrine.
La lecture contre l'écriture: consulter une marge est utile, créer le devis qui la corrige l'est davantage. 592 de nos opérations écrivent.
Le palier tarifaire: l'accès programmatique est souvent réservé aux offres hautes ou vendu en option. Chez nous il est dans Essentiel, Pro et Expert, sans supplément.

Si vous comparez plusieurs solutions, nos pages de comparaison détaillent les différences au-delà du seul sujet de l'API.

Questions fréquentes

Vos questions sur l'API et le MCP

L'API easyBTP est-elle incluse dans mon abonnement ?

Oui, dans tous les plans, sans surcoût ni module à acheter. Essentiel, Pro et Expert donnent accès à l'API et au serveur MCP. C'est un point de différence avec la plupart des ERP du BTP, qui facturent l'accès programmatique en option ou le réservent aux gros contrats.

Qu'est-ce qu'un serveur MCP, concrètement ?

MCP (Model Context Protocol) est un standard ouvert qui permet à un assistant IA de se connecter à un logiciel métier. Concrètement, votre assistant peut consulter vos affaires, vos devis ou vos factures dans easyBTP, puis agir, sans que vous ayez une ligne de code à écrire.

Une clé API peut-elle tout faire sur mon compte ?

Non. Une clé porte des droits, exactement comme un utilisateur. Vous créez une clé en lecture seule sur la facturation, une autre limitée aux achats, et chacune ne peut faire que ce que ses droits autorisent. Une clé ne donne jamais plus de pouvoir qu'un collaborateur équivalent.

Faut-il savoir programmer pour utiliser le serveur MCP ?

Non pour le MCP, oui pour l'API. Le serveur MCP se configure en collant une adresse et une clé dans votre client, puis vous dialoguez en langage naturel. L'API REST, elle, s'adresse à un développeur ou à votre intégrateur, pour construire une automatisation sur mesure.

Combien d'opérations l'API easyBTP expose-t-elle ?

953, réparties sur 14 modules métier. 361 sont en lecture seule et 592 écrivent dans l'ERP, dont 111 marquées comme sensibles parce qu'elles suppriment ou annulent. Ce sont les chiffres du catalogue de production, pas un ordre de grandeur commercial.

Que couvre l'API par rapport à l'application ?

Les mêmes domaines métier que l'interface : études et devis, affaires et chantiers, achats et sous-traitance, facturation et règlements, pilotage, stocks, CRM, documents et signatures. L'API n'est pas une vitrine réduite posée sur le produit, elle en couvre le fonctionnement courant.

Un assistant IA peut-il modifier mes données, ou seulement les lire ?

Il peut modifier, si vous l'y autorisez. 592 des 953 opérations sont des écritures : créer un devis, envoyer un bon de commande, enregistrer un règlement. Tout passe par les droits de la clé, et chaque écriture exige une clé d'idempotence qui empêche les doublons en cas d'appel rejoué.

Mes données sortent-elles de France quand j'utilise l'API ?

Non. L'API et le serveur MCP sont hébergés sur la même infrastructure française que le reste d'easyBTP. Vos affaires, vos prix et vos clients ne quittent pas le territoire. Si vous branchez un assistant IA tiers, en revanche, vérifiez où ce dernier traite les données qu'il reçoit.

Comment obtenir la documentation technique ?

Le périmètre est publié sur cette page : 953 opérations, 14 modules, la répartition entre lecture et écriture. Les schémas détaillés de chaque opération s'obtiennent en nous contactant, et l'API sait par ailleurs décrire elle-même ce qu'une clé donnée peut appeler. Nous préférons vous orienter vers les bonnes opérations plutôt que vous laisser seul devant un catalogue.

Parlons de ce que vous voulez intégrer.

Nous vous transmettons la documentation technique et nous vous orientons vers les bonnes opérations, avec un interlocuteur en face plutôt qu'un portail.

Réserver une démo Nous écrire