Before you start
- You need to be an owner or an admin of the organization.
- Find the redirect URL in your AI tool’s settings or documentation. It’s sometimes called a callback URL or an OAuth redirect URI.
- Copy it exactly. Qonto compares the full address character by character, so a missing trailing slash or a different path won’t match.
- The URL has to start with
https://and use a domain name. IP addresses,localhost, credentials (user:password@), a#fragment and*wildcards are refused, and it can’t be longer than 2,048 characters. - An organization can add up to 10 URLs.
Tools that run on your own computer and redirect to
http://localhost or http://127.0.0.1, such as Claude Code, already work. You don’t need to add anything for them.Add a redirect URL
1
Open Qonto AI
Sign in to the Qonto web app and open Qonto AI from the left sidebar.
2
Open Advanced settings
In the Qonto MCP panel, expand Advanced settings.
3
Add the URL
Under Custom redirect URLs, paste the URL and click Add URL.
4
Confirm
Read the warning, tick I trust this URL and understand the risks, then click Add URL.
https://mcp.qonto.com/mcp as you would any other client. When Qonto asks which organization to connect, pick the one that added the URL.
Being on the list doesn’t change who may connect. Managers and employees still need Qonto MCP to be enabled for the organization, see Enabling Qonto MCP for managers and employees, and every tool call stays bound by the role of the person who connected.
How a connection is checked
- The tool registers with Qonto MCP and gives it its redirect URL.
- Your browser opens at Qonto, on a page that shows the address the connection goes to and reminds you that Qonto hasn’t verified it. If you recognize the address and trust it, tick the box that says so and click Continue to sign in. If you click Cancel, the connection stops there and nothing is sent to the tool.
- You sign in, pick the organization to connect and review the permissions.
- Before sending your browser back to the tool, Qonto MCP checks that this organization has added this exact URL.
- If it has, your browser returns to the tool and the connection completes. If it hasn’t, you stay on a Qonto page titled This connection can’t be completed, and the tool receives nothing.
https://mcp.qonto.com/mcp. The multi-organization endpoint accepts only the tools on Qonto’s list.
Remove a redirect URL
Open Advanced settings again, click remove next to the URL and confirm. New connections through that URL stop working right away. Connections that were already made can keep working for up to one hour, until the tool next renews its access. To cut them off immediately, also revoke them from the connected apps section of your Qonto account.Troubleshooting
”This connection can’t be completed”
The organization you picked hasn’t added the redirect URL this tool is using.- Check you picked the organization that added the URL.
- Compare the URL in Advanced settings with the one your tool uses, including the path and any trailing slash. They have to match exactly.
- If you’re a manager or an employee, ask an owner or an admin to add the URL.
The tool reports an invalid redirect URI when it registers
The tool’s redirect URL doesn’t meet the rules in Before you start, most often because it doesn’t usehttps://. Qonto MCP can’t accept it, even from Advanced settings. Check whether the tool offers an HTTPS callback.