Un assistant d'IA peut lire vos données Etrebil et agir pour vous : préparer un rendez-vous à partir du CRM, dire qui est disponible jeudi matin, résumer les alertes de sécurité de la nuit. Il travaille en votre nom, avec vos droits, jamais plus.
Deux portes s'ouvrent pour cela. Le MCP, pour les assistants d'IA. L'API REST, pour vos propres programmes et vos intégrations.
1. Deux portes : MCP et API
Le MCP (Model Context Protocol) est un standard ouvert qui permet à un assistant d'IA de découvrir les outils d'une application, puis de les appeler. Vous posez une question en langage courant ; l'assistant choisit les outils, les appelle et vous répond avec vos données.
L'API REST s'adresse aux développeurs : des adresses HTTP documentées, qu'un script, un tableur ou une autre application appelle directement, sans IA.
- MCP en ligne : l'application web publie ses outils à l'adresse
/mcp de son site, par exemple https://crm.etrebil.com/mcp ;
- MCP sur le poste : Mail et Business installés sur votre ordinateur publient les leurs sur
127.0.0.1, joignables de ce seul ordinateur ;
- API : chaque site qui en a une la documente à
/api/docs, avec son document OpenAPI.
2. Brancher un assistant d'IA
L'accès se donne application par application, depuis la page « Accès des agents » de votre espace Etrebil :
- vous choisissez l'application, l'organisation, la durée, et si l'accès est en lecture seule ou en lecture et écriture ;
- la page affiche le jeton une seule fois (il commence par
etreag_) ; la plateforme n'en garde que l'empreinte ;
- elle donne aussi la commande toute prête pour Claude Code et la configuration pour un autre client MCP (Claude Desktop, Cursor…).
Avec Claude Code, la commande a cette forme :
claude mcp add --transport http etrebil-crm https://crm.etrebil.com/mcp --header "Authorization: Bearer etreag_…"
Le transport est « Streamable HTTP », sans état : chaque requête se suffit à elle-même. Vous pouvez révoquer un accès à tout moment depuis la même page.
3. Sur votre poste, sans passer par Internet
Mail et Business installés sur votre ordinateur ont leur propre serveur MCP et leur API, qui n'écoutent que l'adresse locale 127.0.0.1 : Mail sur le port 17893, Business sur le port 17894. Les questions de l'assistant et les réponses restent sur la machine, entre l'application et l'assistant qui y tourne.
- le jeton est créé dans l'application elle-même, dans ses réglages d'API et de MCP ;
- Mail propose de brancher Claude Code ou Claude Desktop en un clic, ou donne la configuration pour un autre client ;
- une requête venue d'une page web est refusée : seuls les clients installés sur le poste passent.
4. L'API REST, pour vos programmes
Chaque site qui publie une API en sert la documentation à /api/docs et le document OpenAPI à /api/openapi/v1.json, de quoi générer un client ou l'essayer dans Postman. Seules les routes marquées publiques y figurent ; l'administration et les routes internes n'y sont pas.
- Business expose aussi ses outils d'agent en REST :
GET /api/v1/outils les liste, /api/v1/outils/{nom} en appelle un, avec le même jeton d'agent ;
- le SOC expose la recherche dans les journaux, les alertes et les dossiers à
/v1, et la réception des journaux envoyés par ses collecteurs ;
- Documents et Polls exposent le dépôt et la recherche de documents, les événements et les sondages ;
- Etrebil Account expose la connexion des applications, le renouvellement du jeton, l'usage et les configurations rangées dans le compte.
5. Ce que l'agent peut faire, et ce qu'il ne peut pas faire
- Il voit ce que vous voyez, dans l'organisation choisie : les outils passent par les mêmes services et les mêmes droits que les écrans, jamais directement par la base.
- Il ne modifie rien sans votre accord. Sans l'autorisation d'écriture, les outils qui modifient des données ne lui sont même pas montrés ; avec elle, elle est revérifiée à chaque appel, et chaque modification est signée de votre nom, marquée « agent IA ».
- Il perd l'accès en même temps que vous : résiliation, siège retiré ou révocation du jeton.
- Chaque appel compte pour quelques unités selon l'outil, décomptées de quotas par session, par semaine et par mois ; une limite de débit arrête un agent qui tournerait en boucle.
- Le responsable de l'organisation peut interdire les assistants d'IA sur ses données ; les accès existants cessent alors de fonctionner.
Le fournisseur de l'assistant d'IA reçoit les réponses des outils, c'est-à-dire des extraits de vos données : choisissez-le en connaissance de cause. Une IA peut se tromper ; relisez ce qu'elle prépare avant de l'envoyer ou de le confirmer.
6. Les applications compatibles
Les applications qui publient aujourd'hui des outils MCP ou une API, et ce qu'un agent peut y faire.
| Application |
MCP en ligne |
MCP sur le poste |
API REST |
|---|
Business
DisponibleSociétés et projets, démarches et échéances légales, associés et titres, factures, devis, impayés, budgets, tableaux de bord (y compris consolidés). | ✓ | ✓ | ✓ |
|---|
CRM
DisponibleContacts, sociétés, opportunités et pipeline, historique des échanges, tâches, bonnes pratiques et playbooks, envois de messages signés DKIM. | ✓ | – | – |
|---|
Mail
DisponibleSur votre poste : comptes, dossiers, messages et pièces jointes, recherche, brouillons et envois, règles, contacts, agenda, tâches et notes. | – | ✓ | ✓ |
|---|
Property
DisponiblePatrimoine, immeubles et lots, loyers impayés, actions de gestion en attente, incidents et leur suivi. | ✓ | – | – |
|---|
Planning
En préparationRessources, affectations, absences et alertes des règles (chevauchement, repos, durées). | ✓ | – | – |
|---|
Field Service
En préparationInterventions chez les clients, techniciens, planification, rapports et préparation de la facturation. | ✓ | – | – |
|---|
Manufacturing
En préparationArticles, nomenclatures multi-niveaux, stock, ordres de fabrication et réceptions. | ✓ | – | – |
|---|
SOC
DisponibleRecherche dans les journaux, alertes de détection, dossiers d'incident, collecteurs et règles. | ✓ | – | ✓ |
|---|
DataVirt
DisponibleAgents installés chez vous, sources de production et bases virtuelles, modifications en attente et leur poussée. | ✓ | – | – |
|---|
Workflows
En préparationWorkflows de l'organisation, exécutions et leurs étapes, consommation du mois. | ✓ | – | – |
|---|
Documents
DisponiblePar programme : dépôt de documents, recherche dans le texte reconnu, étiquettes, métadonnées. | – | – | ✓ |
|---|
Polls
DisponiblePar programme : lecture d'un événement, de son calendrier iCalendar et d'un sondage par son code de partage. | – | – | ✓ |
|---|
Une application « en préparation » n'est pas encore ouverte aux abonnés : son point d'accès le sera en même temps qu'elle.
7. Exemples d'utilisation
Ce que l'on peut demander, ce que l'agent en fait, et les outils qu'il appelle pour cela.
Business
« Quelles échéances légales tombent ce trimestre pour mes sociétés ? »
Le calendrier calculé : approbation et dépôt des comptes, déclaration du résultat, libération du capital…
cycle_vue_ensembleecheances
« Où en est le budget de l'année par rapport au réel ? »
L'écart ligne par ligne entre le plan et ce qui a été comptabilisé.
lister_planscomparer_plan_au_reel
« Fais un devis au client Dupont : trois jours de conseil. »
Le devis est créé ; vous le relisez et le confirmez dans Business.
rechercherlister_articlescreer_devismodifie des données : écriture accordée
CRM
« Prépare mon rendez-vous avec la société Martin. »
La fiche, les derniers échanges et les opportunités en cours, résumés en quelques lignes.
rechercherfichehistorique
« Note mon appel avec Mme Leroy et planifie une relance dans une semaine. »
L'échange est consigné à l'historique et la tâche de relance est créée, à votre nom.
consigner_echangeplanifier_tachemodifie des données : écriture accordée
« Notre domaine d'expédition est-il prêt ? »
L'état de la clé DKIM, du SPF et du DMARC, et les enregistrements DNS qui manquent.
marketing_etat_domainesmarketing_dns_a_publier
Mail
« Résume les messages non lus de ce matin et prépare une réponse à celui du comptable. »
Un résumé, et une réponse laissée en brouillon : elle ne part que si vous le demandez.
lister_messagesresumer_messagerepondre_brouillonmodifie des données : écriture accordée
« Range automatiquement les factures du fournisseur Alpha dans « Factures ». »
Une règle est créée, puis simulée sur les messages existants pour montrer ce qu'elle aurait fait.
creer_reglesimuler_reglesmodifie des données : écriture accordée
Property
« Quels loyers sont impayés, et depuis combien de jours ? »
Les échéances non soldées, par locataire, avec le montant restant dû.
loyers_impayes
« Ajoute au suivi de l'incident de la chaudière : le chauffagiste passe jeudi. »
L'entrée est ajoutée au suivi, signée de votre nom.
incidentsajouter_suivi_incidentmodifie des données : écriture accordée
Planning
« Qui est disponible jeudi de 8 h à 12 h ? »
Les personnes sans affectation ni absence approuvée sur ce créneau.
disponibilites
« Place Paul sur ce créneau et dis-moi si une règle bloque. »
Une affectation en brouillon, ou le refus motivé par la règle ; la publication reste une étape à part.
creer_affectationalertesmodifie des données : écriture accordée
Field Service
« Crée une intervention chez Dupont et confie-la à Léa demain à 9 h. »
L'intervention est créée puis planifiée avec la technicienne.
lister_clientscreer_interventionplanifier_interventionmodifie des données : écriture accordée
« Que faut-il facturer pour l'intervention terminée hier ? »
Les lignes à facturer : main-d'œuvre, déplacement, pièces.
lister_interventionspreparer_facturation
Manufacturing
« Que manque-t-il pour lancer l'ordre OF-2026-014 ? »
Par composant : le besoin, le disponible et le manque au stock d'aujourd'hui.
penuries_ordre
« Quels articles sont sous leur seuil de stock ? »
La liste des articles à réapprovisionner.
stock
SOC
« Combien d'échecs de connexion sur srv-01 depuis hier ? »
Le décompte, puis les comptes et adresses les plus fréquents si vous le demandez.
langage_de_recherchecompter_evenementsvaleurs_frequentes
« Regroupe les alertes ouvertes de ce poste dans un dossier. »
Un dossier SOC-n est ouvert, les alertes y sont rattachées, avec une note qui explique pourquoi.
lister_alertesouvrir_dossierannoter_dossiermodifie des données : écriture accordée
DataVirt
« Qu'a écrit la recette dans la base Staging, et que donnerait la poussée ? »
Les modifications table par table, et un aperçu de la poussée, sans rien écrire dans la production.
lister_basesmodifications_en_attenteapercu_poussee
Workflows
« Pourquoi la dernière exécution du workflow « Relances » a-t-elle échoué ? »
Les étapes jouées, leurs entrées et sorties, et l'étape en erreur.
lister_executionsexecution
Documents
« Un scanner dépose chaque soir les pièces numérisées. »
Chaque fichier arrive dans Documents, avec son texte reconnu, prêt à être cherché.
POST /api/documents/uploadGET /api/documents/search/ocrmodifie des données : écriture accordée
Polls
« Votre intranet affiche la date retenue d'un événement. »
L'événement et son fichier iCalendar, à ajouter aux agendas.
GET /api/events/{id}GET /api/events/{id}/ical