Connexion
Deux étapes : la société autorise le connecteur dans Oxygenius, puis chaque utilisateur ajoute Oxygenius à son assistant et se connecte avec son propre compte.
https://mcp.oxygenius.be/mcpPrérequis
- Un compte utilisateur Oxygenius actif, rattaché à une seule société.
- Une société qui a activé le connecteur (étape 1 ci-dessous). Sans cette activation, le serveur refuse tous ses utilisateurs.
- Un assistant compatible MCP qui gère les serveurs distants (Streamable HTTP) et l'authentification OAuth, par exemple Claude (web, bureau, mobile) ou Claude Code. Les connecteurs de Claude dépendent de l'abonnement Claude ; sur un abonnement Team ou Enterprise, un propriétaire de l'organisation ajoute d'abord le connecteur.
1. Activer le connecteur pour la société
Dans Oxygenius (application web), un utilisateur qui a accès à Paramètres → Intégration IA (permission settings.ai-integration.view) :
- Lit le texte d'information sur l'utilisation des données : ce que l'assistant peut consulter, les données transmises au fournisseur du modèle d'IA, la responsabilité de la société (RGPD).
- Coche la case de confirmation au nom de la société et clique sur Activer le connecteur MCP. L'acceptation (utilisateur, date, version du texte) est enregistrée.
- Facultatif : active Autoriser les outils d'écriture. Sans cela, l'assistant ne peut que consulter les données.
Le bouton Désactiver le connecteur coupe l'accès immédiatement, pour tous les utilisateurs de la société, dès leur requête suivante. Les outils d'écriture se désactivent de la même façon, indépendamment de la lecture.
2. Ajouter Oxygenius à Claude
Depuis l'annuaire des connecteurs
- Dans Claude (claude.ai, application de bureau ou mobile), ouvrez la page des connecteurs : Personnaliser → Connecteurs (selon la version : Paramètres → Connecteurs).
- Parcourez les connecteurs et recherchez Oxygenius, puis cliquez sur Connecter.
- La page de connexion d'Oxygenius s'ouvre : connectez-vous avec votre compte Oxygenius habituel, puis autorisez l'accès.
- Dans une conversation, vérifiez qu'Oxygenius est activé dans le menu + → Connecteurs, puis posez votre question.
Sur un abonnement Team ou Enterprise, un propriétaire de l'organisation ajoute d'abord le connecteur Oxygenius ; chaque membre clique ensuite sur Connecter et se connecte avec son propre compte Oxygenius.
Comme connecteur personnalisé
Pour un test, ou tant que le connecteur n'apparaît pas dans votre annuaire, ajoutez-le par son adresse :
- Page des connecteurs → Ajouter un connecteur personnalisé.
- Nom :
Oxygenius; URL :https://mcp.oxygenius.be/mcp. - Dans les paramètres avancés, saisissez l'OAuth Client ID et l'OAuth Client Secret fournis par le support d'Oxygenius (support@oxygenius.be) : le serveur n'accepte que des clients OAuth enregistrés.
- Cliquez sur Connecter et connectez-vous avec votre compte Oxygenius.
Approbation des outils
Claude lit les annotations des outils : les outils en lecture seule (readOnlyHint) peuvent s'exécuter sans confirmation à chaque appel, et un outil marqué destructif (destructiveHint) demande toujours votre approbation. Les autres outils se règlent outil par outil sur la page du connecteur : nous recommandons d'exiger l'approbation pour tous les outils d'écriture.
Claude Code
Claude Code se connecte depuis votre poste. Avec un identifiant client OAuth fourni par le support (dont l'URL de retour http://localhost:8080/callback est autorisée) :
claude mcp add --transport http oxygenius https://mcp.oxygenius.be/mcp \
--client-id <CLIENT_ID> --client-secret --callback-port 8080Le secret client est demandé de façon masquée. Dans une session, lancez /mcp, choisissez oxygenius puis Authenticate : la connexion s'ouvre dans le navigateur.
Autres clients MCP
Tout client qui gère le transport Streamable HTTP et l'autorisation OAuth 2.1 du protocole MCP peut se connecter :
| Réglage | Valeur |
|---|---|
| URL du serveur | https://mcp.oxygenius.be/mcp |
| Transport | Streamable HTTP |
| Découverte de l'autorisation | https://mcp.oxygenius.be/.well-known/oauth-protected-resource/mcp (indiquée aussi par l'en-tête WWW-Authenticate d'une réponse 401) |
| Flux OAuth | Code d'autorisation avec PKCE, paramètre resource égal à l'URL du serveur |
| Client OAuth | Pré-enregistré : pas d'enregistrement dynamique (DCR). Demandez un identifiant client au support en indiquant l'URL de retour de votre client. |
Pour inspecter le serveur et ses outils, le MCP Inspector s'utilise de la même façon (transport Streamable HTTP, identifiant client OAuth) :
npx @modelcontextprotocol/inspector3. Vérifier la connexion
Demandez à l'assistant : « Qui suis-je dans Oxygenius ? ». Il appelle get_my_profile et répond avec votre nom, votre fonction et votre société. Demandez ensuite : « Quels outils Oxygenius peux-tu utiliser ? » pour voir les outils ouverts par vos permissions.
La liste des outils dépend de vos permissions dans Oxygenius et des réglages de votre société. Voir Permissions par outil et Dépannage.
Se déconnecter
- Un utilisateur : sur la page du connecteur dans Claude, Déconnecter. Les jetons de Claude sont oubliés ; une nouvelle connexion redemande l'authentification.
- La société : Paramètres → Intégration IA → Désactiver le connecteur. L'accès est coupé pour tous ses utilisateurs.
- Un compte désactivé dans Oxygenius perd l'accès au serveur à la requête suivante.