Getting connected
Two steps: the company allows the connector in Oxygenius, then each user adds Oxygenius to their assistant and signs in with their own account.
https://mcp.oxygenius.be/mcpRequirements
- An active Oxygenius user account, attached to a single company.
- A company that has enabled the connector (step 1 below). Until it does, the server refuses all its users.
- An MCP-compatible assistant that supports remote servers (Streamable HTTP) and OAuth, for example Claude (web, desktop, mobile) or Claude Code. Claude connectors depend on the Claude plan; on a Team or Enterprise plan, an organisation Owner adds the connector first.
1. Enable the connector for the company
In Oxygenius (web application), a user who can open Settings → AI integration (permission settings.ai-integration.view):
- Reads the information notice on data use: what the assistant can see, the data passed to the AI model provider, and the company's responsibility (GDPR).
- Ticks the confirmation box on behalf of the company and clicks Enable the MCP connector. The acceptance (user, date, notice version) is recorded.
- Optional: turns on Allow write tools. Without it, the assistant can only read data.
The Disable the connector button cuts access immediately for all the company's users, from their next request. Write tools are disabled the same way, independently of reading.
2. Add Oxygenius to Claude
From the connectors directory
- In Claude (claude.ai, desktop or mobile app), open the connectors page: Customize → Connectors (depending on the version: Settings → Connectors).
- Browse the connectors, search for Oxygenius and click Connect.
- The Oxygenius sign-in page opens: sign in with your usual Oxygenius account, then allow access.
- In a conversation, check that Oxygenius is on in the + → Connectors menu, then ask your question.
On a Team or Enterprise plan, an organisation Owner adds the Oxygenius connector first; each member then clicks Connect and signs in with their own Oxygenius account.
As a custom connector
For a test, or while the connector is not in your directory, add it by its URL:
- Connectors page → Add custom connector.
- Name:
Oxygenius; URL:https://mcp.oxygenius.be/mcp. - Under Advanced settings, enter the OAuth Client ID and OAuth Client Secret provided by Oxygenius support (support@oxygenius.be): the server only accepts registered OAuth clients.
- Click Connect and sign in with your Oxygenius account.
Tool approval
Claude reads the tool annotations: read-only tools (readOnlyHint) can run without per-call confirmation, and a tool marked destructive (destructiveHint) always asks for your approval. The other tools are set tool by tool on the connector page: we recommend requiring approval for every write tool.
Claude Code
Claude Code connects from your machine. With an OAuth client ID provided by support (whose redirect URL http://localhost:8080/callback is allowed):
claude mcp add --transport http oxygenius https://mcp.oxygenius.be/mcp \
--client-id <CLIENT_ID> --client-secret --callback-port 8080The client secret is asked for without echo. In a session, run /mcp, pick oxygenius then Authenticate: sign-in opens in the browser.
Other MCP clients
Any client that supports the Streamable HTTP transport and the MCP OAuth 2.1 authorization can connect:
| Setting | Value |
|---|---|
| Server URL | https://mcp.oxygenius.be/mcp |
| Transport | Streamable HTTP |
| Authorization discovery | https://mcp.oxygenius.be/.well-known/oauth-protected-resource/mcp (also given by the WWW-Authenticate header of a 401 response) |
| OAuth flow | Authorization code with PKCE, resource parameter equal to the server URL |
| OAuth client | Pre-registered: no dynamic client registration (DCR). Ask support for a client ID, giving your client's redirect URL. |
To inspect the server and its tools, the MCP Inspector works the same way (Streamable HTTP transport, OAuth client ID):
npx @modelcontextprotocol/inspector3. Check the connection
Ask the assistant: "Who am I in Oxygenius?". It calls get_my_profile and answers with your name, job title and company. Then ask: "Which Oxygenius tools can you use?" to see the tools your permissions open.
The tool list depends on your Oxygenius permissions and on your company's settings. See Permissions per tool and Troubleshooting.
Disconnecting
- A user: on the connector page in Claude, Disconnect. Claude forgets its tokens; connecting again asks for sign-in.
- The company: Settings → AI integration → Disable the connector. Access stops for all its users.
- A user deactivated in Oxygenius loses access to the server at the next request.