Serveur MCP Oxygenius
Connectez Claude, ou tout assistant compatible avec le Model Context Protocol, aux données Oxygenius de votre entreprise de construction : dossiers, tiers, planning, devis, factures, notes de crédit, tâches, courriels et documents. Posez vos questions en langage naturel ; l'assistant ne voit et ne fait que ce que vous pouvez voir et faire dans Oxygenius.
https://mcp.oxygenius.be/mcp- Éditeur
- Oxygenius, logiciel de gestion pour les entreprises de la construction (oxygenius.be)
- Transport
- Streamable HTTP, sans état (
POST /mcp) - Authentification
- OAuth 2.1 (code d'autorisation + PKCE), découverte par les métadonnées de ressource protégée (RFC 9728)
- Capacités
- 81 outils (32 en lecture seule, 49 d'écriture sur activation) ; ni ressources ni prompts
- Données
- En français ; montants en euros ; dates et heures en heure locale belge (Europe/Brussels)
- Prérequis
- Un compte Oxygenius, dans une société qui a activé le connecteur
Ce que vous pouvez faire
Retrouver un dossier
« Où en est le chantier Dupont à Namur ? » : statut, étapes, intervenants, devis et factures du dossier.
Suivre la facturation
Factures en retard, soldes, reste à facturer d'un devis accepté, notes de crédit.
Organiser le planning
Qui est où cette semaine, planifier une équipe sur un chantier, déplacer un rendez-vous.
Rédiger un devis
Créer un devis à partir du catalogue d'articles et d'ouvrages ; Oxygenius calcule prix, TVA et totaux.
Courriels et tâches
Résumer ses courriels, préparer une réponse, adresser une tâche à un collègue.
Lire les documents
Rechercher un document d'un dossier et en lire le texte : PV, offres de prix, factures UBL.
Démarrage rapide
- Activez le connecteur pour votre société. Un administrateur ouvre Paramètres → Intégration IA dans Oxygenius, prend connaissance du texte d'information et l'accepte au nom de la société. Détails
- Ajoutez Oxygenius à votre assistant. Dans Claude : Paramètres → Connecteurs, recherchez « Oxygenius » puis cliquez sur Connecter. Détails
- Connectez-vous avec votre compte Oxygenius et posez une question, par exemple : « Retrouve le dossier de M. Dupont à Namur ». Exemples
Principes
| Principe | Ce que cela signifie |
|---|---|
| Mêmes droits que dans l'application | Chaque utilisateur se connecte avec son propre compte. Un outil exige la même permission que l'écran correspondant d'Oxygenius ; sans elle, l'assistant ne le voit même pas. |
| Lecture seule par défaut | Les 49 outils d'écriture n'apparaissent que si la société les a explicitement autorisés. Ils passent par l'API d'Oxygenius, avec les mêmes contrôles que l'application web. |
| Actions engageantes en deux temps | Numéroter une facture, envoyer un courriel, transmettre par Peppol : un outil prepare_* montre d'abord ce qui va se passer, puis l'action exige un jeton de confirmation valable 10 minutes. |
| Isolation des sociétés | La société est déduite du jeton de connexion, jamais d'un paramètre : un utilisateur n'accède qu'aux données de sa propre société. |
| Réversible à tout moment | La société peut désactiver le connecteur dans Oxygenius : l'accès est coupé dès la requête suivante, pour tous ses utilisateurs. |
search_dossiers et get_dossier pour les chantiers, search_invoices pour la facturation, search_planning_events pour le planning, get_my_tasks et get_my_emails pour son quotidien, get_my_profile pour savoir qui est connecté.
Dans cette documentation
Connexion
Activer le connecteur et l'ajouter à Claude, Claude Code ou un autre client MCP.
Authentification et accès
OAuth 2.1, découverte, jetons et permissions par outil.
Outils
La référence des 81 outils : paramètres, résultats, annotations, permissions.
Exemples
Des demandes concrètes et les outils que l'assistant enchaîne.
Sécurité et données
Isolation, garde-fous, données transmises, conservation et confidentialité.
Dépannage et FAQ
Les messages d'erreur courants et leurs solutions.