# Connect your AI client

> Add Bonnard to Claude, ChatGPT, Cursor, or another MCP client with an install link or the connection URL, then sign in.

Updated: 2026-11-09

One connection covers the data you can use in one workspace or company.

## Requirements

- A Bonnard account. [Create a workspace](https://app.bonnard.ai/sign-up), select **Create one** at sign-in, or ask your workspace admin for an invitation.
- An AI client that can add a custom connector or remote MCP server.

## Find the connect control

In the console at `app.bonnard.ai`, select **Connect your AI client** in the sidebar. After you connect, it reads
**Connected to**. A customer's user finds it in the [customer portal](https://bonnard.ai/docs/customers/customer-portal.md) at
`app.bonnard.ai/connect`. The connection URL is `https://app.bonnard.ai/mcp`.

[Image: The connect panel in the console sidebar: Copy connection URL, Install in Claude, Install in ChatGPT, and Install in Cursor]

## Claude

1. Select **Install in Claude**. Claude opens **Add custom connector** with the name and URL entered.
2. Select **Add**.
3. In **Customize** > **Connectors**, select **Connect** next to Bonnard.
4. Sign in.

## ChatGPT

Custom MCP servers work on the web only. On Pro, set **Developer mode** to on. On Business, Enterprise, and Edu, an admin
sets it.

1. Select **Copy connection URL**, then **Install in ChatGPT**.
2. If the form is not open, select **+**, then **Add custom MCP server**.
3. Enter `Bonnard` as the **Name**, paste the URL in **Server URL**, and select **OAuth**.
4. Select **I understand and want to continue**, then **Create as a plugin**.
5. Install the plugin and sign in.

## Cursor

1. Select **Install in Cursor** and let your browser open Cursor.
2. Accept Cursor's install prompt.
3. In Cursor, select **Customize**, then **MCPs**, then Bonnard's sign-in option.
4. Sign in.

## Claude Code

```bash
claude mcp add --transport http bonnard https://app.bonnard.ai/mcp
```

In Claude Code, run `/mcp`, select `bonnard`, then **Authenticate**, and sign in.

## Codex

```bash
codex mcp add bonnard --url https://app.bonnard.ai/mcp
codex mcp login bonnard
```

Then sign in.

## Microsoft Copilot

Microsoft 365 Copilot uses a declarative agent. Your admin must let users upload custom apps.

1. In Microsoft 365 Agents Toolkit, select **Create a New Agent/App**, then **Declarative Agent**.
2. Select **Add an Action**, then **Start with an MCP Server**, and enter the connection URL.
3. Select **OAuth (with dynamic registration)**, then **Provision**.
4. In Microsoft 365 Copilot, open the agent and sign in.

## Gemini

Custom apps need a personal Google account in the US, in English, aged 18 or older.

1. In Gemini on the web, select **Settings**, then **Connected Apps**.
2. Under **Custom apps**, select **Add a custom app**.
3. Enter the connection URL, select **Next**, and sign in.

## Other MCP clients

Enter the connection URL. The client needs MCP over Streamable HTTP with POST requests only, and OAuth 2.1 with PKCE. It
registers itself with no client ID.

## What sign-in asks for

Enter your **Work email** and **Password**, then select **Sign in**. With no password, select **Forgot password?** to set
one with an email code.

An older `/mcp/<slug>` URL covers one data source and signs in with an email code. For all your data, connect at
`https://app.bonnard.ai/mcp`.

The next page names the client and what it can do. Select **Allow**, or **Authorize** if you are a customer's user. With
Unverified identity, approve only if you recognise the host it names.

[Image: The sign-in page: Allow Claude to use your data, the workspace, what the client will be able to do, and Deny and Allow]

Make sure that the page shows:

> You're connected

Then ask your AI client:

```prompt
Which data sources can you use?
```

The agent names them.

## More than one workspace

A member of more than one workspace selects one under **Which workspace?**, and connects again to use another.

A customer's user in more than one workspace gets a URL for each, with **Copy**. **All companies** is
`https://app.bonnard.ai/mcp`, and sign-in offers each company. A workspace's own URL offers only its companies.
The Claude and Cursor install links use **All companies**. For one workspace, add its URL by hand.

[Image: Which workspace? with two rows, Acme and Acme Labs, each marked Team member]

## Troubleshooting

Quote the `bnreq_` request ID when you [get in touch](https://bonnard.ai/get-in-touch).

### `You don't have access to any data in <workspace> yet.`

An admin or editor [gives you access](https://bonnard.ai/docs/access/give-access.md) on the data source.

### `You are not a member of this workspace.`

You are not a member of the workspace you connected to. Connect again at `https://app.bonnard.ai/mcp` and select another,
or ask a workspace admin to invite you.

### `Staging addresses were retired. Connect to <URL> instead.`

Use the URL in the message.

### `This connection request has already been used or has expired.`

If you approved it, return to the AI client. If not, start again.

## Related

- [AI tools](https://bonnard.ai/docs/ai-clients/ai-tools.md): select what agents can do.
- [Client compatibility](https://bonnard.ai/docs/ai-clients/client-compatibility.md): when charts draw.
- [API keys](https://bonnard.ai/docs/developers/api-keys.md): connect a script.
