Bonnard

Connect AI clients

Connect your AI client

Updated

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

Requirements

  • A Bonnard account. Create a workspace, 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 at app.bonnard.ai/connect. The connection URL is https://app.bonnard.ai/mcp.

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

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.

Make sure that the page shows:

You’re connected

Then ask your AI client:

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.

Troubleshooting

Quote the bnreq_ request ID when you get in touch.

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

An admin or editor gives you access 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.