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.

Adresse du serveurhttps://mcp.oxygenius.be/mcp

Prérequis

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) :

  1. 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).
  2. 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.
  3. Facultatif : active Autoriser les outils d'écriture. Sans cela, l'assistant ne peut que consulter les données.
Désactivation

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

  1. Dans Claude (claude.ai, application de bureau ou mobile), ouvrez la page des connecteurs : Personnaliser → Connecteurs (selon la version : Paramètres → Connecteurs).
  2. Parcourez les connecteurs et recherchez Oxygenius, puis cliquez sur Connecter.
  3. La page de connexion d'Oxygenius s'ouvre : connectez-vous avec votre compte Oxygenius habituel, puis autorisez l'accès.
  4. 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 :

  1. Page des connecteurs → Ajouter un connecteur personnalisé.
  2. Nom : Oxygenius ; URL : https://mcp.oxygenius.be/mcp.
  3. 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.
  4. 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 8080

Le 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églageValeur
URL du serveurhttps://mcp.oxygenius.be/mcp
TransportStreamable HTTP
Découverte de l'autorisationhttps://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 OAuthCode d'autorisation avec PKCE, paramètre resource égal à l'URL du serveur
Client OAuthPré-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/inspector

3. 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.

Un outil manque ?

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