> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qonto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom redirect URLs

> Connect an AI tool that isn't on Qonto's list, for your organization only

Qonto MCP works out of the box with a list of known AI tools, such as Claude, ChatGPT, Cursor, Le Chat and VS Code. When you connect one of them, it gives Qonto a **redirect URL**: the address your browser returns to once you approve the connection. To connect a tool that isn't on that list, for example an agent platform your company runs itself, an owner or an admin can add the tool's redirect URL for your organization.

A custom redirect URL only works for **your organization**. Before your browser is sent anywhere, Qonto MCP checks which organization the person signing in picked. Members of other organizations can never complete a connection through a URL your organization added, and nothing is ever sent to that URL on their behalf.

> [!WARNING]
>
> **Only add URLs you fully trust.** Whoever controls a redirect URL gets access to your organization's Qonto data every time a member connects through it: balances, transactions, invoices and anything else that member can see or do. Qonto doesn't review or monitor these URLs. Never add a URL someone sent you unexpectedly, even if they say they're from Qonto, and remove any URL you no longer use.

## 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.

> [!NOTE]
>
> 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**.

You can now connect the tool to `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](https://docs.qonto.com/mcp/authentication.md#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

1. The tool registers with Qonto MCP and gives it its redirect URL.
2. 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.
3. You sign in, pick the organization to connect and review the permissions.
4. Before sending your browser back to the tool, Qonto MCP checks that this organization has added this exact URL.
5. 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.

Qonto can show you the address a second time after you sign in, for example when your browser blocks cookies. The tool still receives nothing until you tick the box and click **Continue**.

Custom redirect URLs only work on the single-organization endpoint, `https://mcp.qonto.com/mcp`. The [multi-organization endpoint](https://docs.qonto.com/mcp/multi-organization.md) 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.

If the page says the problem is temporary, wait a few minutes and connect again.

### The tool reports an invalid redirect URI when it registers

The tool's redirect URL doesn't meet the rules in [Before you start](#before-you-start), most often because it doesn't use `https://`. Qonto MCP can't accept it, even from **Advanced settings**. Check whether the tool offers an HTTPS callback.
