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

# Quickstart

> Connect any MCP client to mcp.qonto.com in under a minute

The Qonto MCP server speaks the standard [Model Context Protocol](https://modelcontextprotocol.io/) over streamable HTTP. Most clients only need two things: **the server URL** and **OAuth authorization**.

## Server URL

```
https://mcp.qonto.com/mcp
```

## Generic configuration

Any MCP client that supports remote HTTP servers accepts the same shape:

```json theme={null}
{
  "mcpServers": {
    "qonto": {
      "type": "http",
      "url": "https://mcp.qonto.com/mcp"
    }
  }
}
```

The client will open the OAuth flow on first connection and store the resulting token. No client secret, no API key, no organisation ID to copy by hand.

## Per-client guides

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="comments" href="/mcp/install/claude-desktop">
    Find Qonto under Connectors and finish the OAuth handshake.
  </Card>

  <Card title="Claude Web" icon="globe" href="/mcp/install/claude-web">
    Add Qonto from the Connectors directory on Claude.ai.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp/install/claude-code">
    One CLI command, then <code>/mcp</code> to authenticate.
  </Card>

  <Card title="Cursor" icon="code" href="/mcp/install/cursor">
    Click <b>Add to Cursor</b> and Cursor adds the server in one click.
  </Card>

  <Card title="VS Code" icon="code-branch" href="/mcp/install/vscode">
    Click <b>Add to VS Code</b> to register the server with GitHub Copilot Chat.
  </Card>

  <Card title="ChatGPT" icon="comment-dots" href="/mcp/install/chatgpt">
    Add as a Custom Connector via Developer Mode.
  </Card>

  <Card title="Mistral Le Chat" icon="message" href="/mcp/install/mistral">
    Add as a Custom MCP Connector under Intelligence.
  </Card>

  <Card title="Notion" icon="book" href="/mcp/install/notion">
    Add Qonto as a custom connector in Notion AI.
  </Card>
</CardGroup>

## What happens on first connection

1. The client sends a JSON-RPC `initialize` to `https://mcp.qonto.com/mcp` and discovers that the server requires OAuth.
2. The client opens your browser at the Qonto authorization endpoint.
3. You sign in to Qonto, pick the organization to connect, and consent to the requested scopes.
4. You are redirected back to the client with an access token; the client stores it locally.
5. The client re-issues `initialize`, then `tools/list`, and the Qonto tools become available in chat.

<Info>
  The server is **stateless** and does not pin a session to a particular pod, so first-time and subsequent connections behave identically, there is nothing to keep alive between requests.
</Info>

## Already connected and need to reset?

* **Revoke the connection** on Qonto's side: the **connected apps** section of your Qonto account.
* **Remove the server** from your MCP client following the per-client guide.
* **Reinstall** following any of the install guides above. A fresh OAuth flow will run.

## Troubleshooting

If `initialize` fails, the tool list is empty, or the OAuth window will not close cleanly, see [Troubleshooting](/mcp/troubleshooting).