Troubleshooting & FAQ
The most frequent situations, their cause and the fix. If the problem persists, contact support.
Connection
| Symptom | Likely cause | Fix |
|---|---|---|
| Claude cannot reach the server. | Mistyped URL, or server temporarily unavailable. | Check the URL https://mcp.oxygenius.be/mcp (with /mcp). https://mcp.oxygenius.be/health must answer Healthy. |
| Authorization fails on the sign-in page. | Unknown account, password, or mistyped OAuth client (custom connector). | Sign in with the same account as in the Oxygenius application. For a custom connector, check the client ID and secret provided by support. |
| Connected, but every request is refused (403). | The company has not enabled the connector or has disabled it, the account is deactivated, or it is attached to several companies. | An administrator enables the connector in Settings → AI integration. Otherwise, contact support. |
| The connector asks to reconnect. | Session expired, or disconnected from the connector page. | Click Connect and sign in again. |
| "Too many requests" (429). | More than 60 requests per minute. | Wait a minute. |
Tools
| Symptom | Likely cause | Fix |
|---|---|---|
| A tool is missing. | Your profile lacks the permission of the matching Oxygenius screen. | Compare with the permission shown on the tool page (Tools) and check with your administrator. |
| No write tool at all. | The company has not turned on Allow write tools. | An administrator turns it on in Settings → AI integration. |
get_item_stock missing. | The Stock module is not active for the company. | — |
| No e-mails. | No Microsoft 365 mailbox linked to the account, or mailbox permissions missing. | Check the mailbox link in Oxygenius; e-mails are no fresher than the last synchronisation. |
| "Oxygenius refuse cette action : …" | An application rule applies (document already numbered, estimate accepted, permission…). | The message says why; some actions can only be done in the application. |
| The confirmation token is refused. | Token expired (10 minutes), already used, or document changed since the preparation. | Ask the assistant to prepare the action again, read the preview and confirm. |
| Sending is refused (cap). | More than 30 sends today for the user. | Try again tomorrow, or send from the application. |
| A calendar event cannot be changed. | Its Microsoft 365 synchronisation is not finished, or it is another user's private event. | Try again a few minutes later. |
| A document is not read. | Scanned page (no OCR), image or Office file, PDF over 20 MB, or a document type your roles cannot see. | Use get_document_download_link to open the file. |
| The assistant says a write was "possibly recorded". | The application did not answer in time. | Check in Oxygenius before asking again, to avoid a duplicate. |
Frequently asked questions
Can the assistant change my data without me?
No. Write tools only exist if your company has enabled them; the assistant must announce every action and wait for your approval, and Claude always asks for your approval before a destructive tool (the others are set on the connector page). Irreversible actions (numbering, sending) also go through a preview and a confirmation token.
Does the assistant see more than I do in Oxygenius?
No. It acts with your account and your permissions, no more and no less, and some data is never passed to it (bank details, internal remarks, margins…).
Does Oxygenius use our data to train an AI?
No. The MCP server only answers tool calls. The data looked up is passed to the provider of the model you use, under its terms and those of your subscription.
How do I cut access?
A user disconnects from the connector page in Claude; the company disables the connector in Settings → AI integration, which cuts access for all its users immediately.
Are the computed amounts reliable?
Yes: prices, VAT and totals of estimates, invoices and credit notes are always computed by Oxygenius, with the same rules as the document screen. The assistant never sends an amount it computed.
Why are the tools in French?
Oxygenius data and users are French-speaking: titles and descriptions are written in the language of the data. Assistants understand requests in other languages.
Which assistants are supported?
Claude (web, desktop, mobile) and Claude Code. Any other MCP client that supports the Streamable HTTP transport and OAuth 2.1 can connect with a client ID provided by support.
Still stuck? Write to support@oxygenius.be.