Dépannage et FAQ
Les situations les plus fréquentes, leur cause et la solution. Si le problème persiste, contactez le support.
Connexion
| Symptôme | Cause probable | Solution |
|---|---|---|
| Claude n'arrive pas à joindre le serveur. | Adresse mal saisie, ou serveur momentanément indisponible. | Vérifiez l'adresse https://mcp.oxygenius.be/mcp (avec /mcp). https://mcp.oxygenius.be/health doit répondre Healthy. |
| L'autorisation échoue sur la page de connexion. | Compte inconnu, mot de passe, ou client OAuth mal saisi (connecteur personnalisé). | Connectez-vous avec le même compte que dans l'application Oxygenius. Pour un connecteur personnalisé, vérifiez l'identifiant et le secret client fournis par le support. |
| Connecté, mais toutes les demandes sont refusées (403). | La société n'a pas activé le connecteur ou l'a désactivé, le compte est désactivé, ou il est rattaché à plusieurs sociétés. | Un administrateur active le connecteur dans Paramètres → Intégration IA. Sinon, contactez le support. |
| Le connecteur demande à se reconnecter. | Session expirée, ou déconnexion depuis la page du connecteur. | Cliquez sur Connecter et reconnectez-vous. |
| « Trop de requêtes » (429). | Plus de 60 requêtes par minute. | Patientez une minute. |
Outils
| Symptôme | Cause probable | Solution |
|---|---|---|
| Un outil n'apparaît pas. | Votre profil n'a pas la permission de l'écran correspondant dans Oxygenius. | Comparez avec la permission indiquée sur la page de l'outil (Outils) et voyez avec votre administrateur. |
| Aucun outil d'écriture. | La société n'a pas activé Autoriser les outils d'écriture. | Un administrateur l'active dans Paramètres → Intégration IA. |
get_item_stock absent. | Le module Stock n'est pas actif pour la société. | — |
| Aucun courriel. | Pas de boîte Microsoft 365 associée au compte, ou permissions de la messagerie manquantes. | Vérifiez l'association de la boîte dans Oxygenius ; les courriels ne sont pas plus récents que la dernière synchronisation. |
| « Oxygenius refuse cette action : … » | Une règle de l'application s'applique (document déjà numéroté, devis accepté, permission…). | Le message dit pourquoi ; certaines actions se font uniquement dans l'application. |
| Le jeton de confirmation est refusé. | Jeton expiré (10 minutes), déjà utilisé, ou document modifié depuis la préparation. | Demandez à l'assistant de préparer à nouveau l'action, relisez l'aperçu et confirmez. |
| L'envoi est refusé (plafond). | Plus de 30 envois aujourd'hui pour l'utilisateur. | Réessayez demain, ou envoyez depuis l'application. |
| Un événement du calendrier ne peut pas être modifié. | Sa synchronisation Microsoft 365 n'est pas terminée, ou c'est l'événement privé d'un autre utilisateur. | Réessayez quelques minutes plus tard. |
| Un document n'est pas lu. | Page scannée (pas d'OCR), image ou fichier Office, PDF de plus de 20 Mo, ou type de document non permis à vos rôles. | Utilisez get_document_download_link pour ouvrir le fichier. |
| L'assistant dit qu'une écriture est « peut-être enregistrée ». | L'application n'a pas répondu à temps. | Vérifiez dans Oxygenius avant de redemander l'action, pour éviter un doublon. |
Questions fréquentes
L'assistant peut-il modifier mes données sans moi ?
Non. Les outils d'écriture n'existent que si votre société les a activés ; l'assistant doit annoncer chaque action et attendre votre accord, et Claude demande toujours votre approbation avant un outil destructif (les autres se règlent sur la page du connecteur). Les actions irréversibles (numérotation, envois) passent en plus par un aperçu et un jeton de confirmation.
L'assistant voit-il plus que moi dans Oxygenius ?
Non. Il agit avec votre compte et vos permissions, ni plus ni moins, et certaines données ne lui sont jamais transmises (données bancaires, remarques internes, marges…).
Oxygenius utilise-t-il nos données pour entraîner une IA ?
Non. Le serveur MCP ne fait que répondre aux appels d'outils. Les données consultées sont transmises au fournisseur du modèle que vous utilisez, selon ses conditions et celles de votre abonnement.
Comment couper l'accès ?
Un utilisateur se déconnecte depuis la page du connecteur dans Claude ; la société désactive le connecteur dans Paramètres → Intégration IA, ce qui coupe l'accès de tous ses utilisateurs immédiatement.
Les montants calculés sont-ils fiables ?
Oui : prix, TVA et totaux des devis, factures et notes de crédit sont toujours calculés par Oxygenius, avec les mêmes règles que l'écran du document. L'assistant n'envoie jamais un montant calculé par lui.
Pourquoi les outils sont-ils en français ?
Les données d'Oxygenius et ses utilisateurs sont francophones : titres et descriptions sont rédigés dans la langue des données. Les assistants comprennent des demandes dans d'autres langues.
Quels assistants sont pris en charge ?
Claude (web, bureau, mobile) et Claude Code. Tout autre client MCP qui gère le transport Streamable HTTP et OAuth 2.1 peut se connecter avec un identifiant client fourni par le support.