Before connecting you need two things: the organization must have MCP turned on in Settings → AI agents, and you need the server address, which you can copy from that same screen:
https://app.leaxio.com/api/mcp
No keys or special headers are used. The client discovers how to authenticate and opens the browser so you can sign in to Leaxio and approve access.
Claude
Verified on October 30, 2026 with Claude.
- Open Settings → Connectors.
- Add a custom connector.
- Paste the address
https://app.leaxio.com/api/mcp. - Press Connect. Leaxio opens: sign in if needed and approve access.
- Go back to Claude and ask a test question.
If Claude shows “Authorization with Leaxio failed” or stays at “signed in but not connecting”, close the conversation, remove the connector and add it again. If it still fails, contact support with the exact time of the attempt.
ChatGPT
- Open the Connectors settings.
- Turn on developer mode if your account requires it.
- Add a custom connector with the server address.
- Sign in to Leaxio and approve access.
ChatGPT changes this screen often. If your plan or account does not allow custom connectors, the option will not appear: it is not a Leaxio problem.
Gemini
This applies to Gemini CLI. Open ~/.gemini/settings.json and add the server (Gemini uses httpUrl for MCP over HTTP):
{
"mcpServers": {
"leaxio": {
"httpUrl": "https://app.leaxio.com/api/mcp"
}
}
}
Save the file and open Gemini CLI. It will take you to Leaxio to sign in and approve. If the browser does not open, type /mcp auth leaxio inside Gemini CLI.
Other clients
Any MCP-compatible app works, such as Cursor, VS Code or MCP Inspector. Add a remote server with HTTP transport and the server address. If your app uses a configuration file, it usually accepts this format:
{
"mcpServers": {
"leaxio": {
"url": "https://app.leaxio.com/api/mcp"
}
}
}
If your server manager asks for a form with a transport, choose HTTP (not stdio) and leave command, arguments and environment variables empty. When you save, the client will open Leaxio so you can sign in and approve.
MCP Inspector (for testing)
Useful if you want to check the connection without relying on a client's interface:
npx @modelcontextprotocol/inspector
Choose Streamable HTTP transport, paste the address and complete the sign-in. Its redirect to localhost is shown as “an app on your machine”; that is normal.
If it does not connect
| What you see | What it means | What to do |
|---|---|---|
mcp_not_enabled or “waiting to be turned on” | The organization has not turned the feature on. | Ask an owner or admin. |
| “Your plan does not include this feature” | The organization is on Basic. | Change to Business or Pro from Billing. |
| “Subscription inactive” | The payment is past due or canceled. | Reactivate the subscription. |
| “No permission” in a response | Your role does not include that section. | Ask whoever manages the organization for the permission. |
| “Too many requests” | The per-user limit was reached. | Wait a minute and try again. |
| The app opens Leaxio and does not return | Consent was not completed. | Repeat the connection from the app. |
| It stopped working overnight | Access was revoked or consent expired. | Connect again. |
Multiple organizations
If you belong to more than one, the agent will ask you to choose one. Each request is validated against the chosen organization: it cannot mix data from two businesses.
Changing agents
You can have several connected at once. Each one appears in Settings → AI agents → Apps connected to your account, with its date and a Revoke button. Revoking one does not affect the others.