Connect an MCP client to Qobra - Qobra public API documentation

Prerequisites

MCP enabled for your company

A Qobra admin controls access in Settings > AI. Before you connect, the admin must:

Turn on AI for the company.
Turn on the MCP agent.

The MCP agent can run for all users or as a pilot. In pilot mode, only the users in the pilot group can connect. Ask your admin to add you to the pilot if you’re not in it.If access is denied, your MCP client shows one of these messages:

Message	Fix
`AI is turned off for this company.`	An admin turns on AI in Settings > AI.
`MCP is turned off for this company.`	An admin turns on the MCP agent in Settings > AI.
`MCP is limited to a pilot group and you are not in it. Ask an admin to add you to the pilot.`	An admin adds you to the MCP pilot group, or switches the agent to all users.

A Qobra account

You authenticate as yourself. The tools only ever return data your Qobra user is allowed to see — the same role-based permissions as the app.

Server URL

The server speaks Streamable HTTP. Qobra runs it in two regions — pick the one that matches where your Qobra workspace is hosted (the same region you log in to the app from). If you’re not sure, ask the Qobra team.

Region	Server URL
Europe (EU)	`https://mcp.qobra.co/mcp`
United States (US)	`https://mcp-us.qobra.co/mcp`

There is no API key. Every client authenticates through the same OAuth 2.1 flow described in Authorize below — you only ever paste the server URL, never a secret.

Everywhere below uses the EU URL as the example. If your workspace is hosted in the US, substitute https://mcp-us.qobra.co/mcp throughout.

Add the server to your client

Claude
ChatGPT
Dust

Open Settings → Connectors → Add custom connector, give it a name (e.g. Qobra) and paste the server URL (https://mcp.qobra.co/mcp). Leave the Advanced settings (OAuth Client ID / Secret) empty.

Adding the Qobra MCP server as a custom connector in Claude

Custom MCP connectors live behind Developer mode, available on ChatGPT Plus, Pro, Business, Enterprise and Edu plans. Open Settings → Connectors → Advanced (chatgpt.com/apps#settings/Connectors/Advanced) and click Create to open the New App dialog.

Name the connector

Enter a Name (e.g. Qobra). The icon and description are optional.

Point it at the server

Under Connection, keep Server URL selected and paste https://mcp.qobra.co/mcp.

Choose OAuth

Set Authentication to OAuth. You can leave the Advanced OAuth settings as discovered — the server registers the client automatically.

Acknowledge & create

Tick I understand and want to continue (the standard warning for any custom MCP server), then click Create.

Adding the Qobra MCP server as a custom connector in ChatGPT

Add Qobra as a remote MCP server from a Dust space. Open your space’s Tools (the Actions category), then Add MCP Server to open the Configure MCP Server dialog.

Point it at the server

In URL, paste https://mcp.qobra.co/mcp.

Leave authentication on Automatic

Keep Authentication set to Automatic. Dust discovers that the server requires OAuth and uses dynamic client registration to obtain the credentials. Leave Use custom headers off.

Save & use it in an agent

Click Save, complete the OAuth consent, then add the Qobra tools to an agent so it can query your Qobra data.

Adding the Qobra MCP server as a remote MCP server in Dust

The server is protected by OAuth 2.1 + PKCE — there is no API key to copy. The flow is identical for every client (Claude, ChatGPT, Dust). On first use:

Discovery & registration

The client discovers the server’s OAuth metadata and registers itself automatically.

Consent in your browser

The client opens the Qobra consent screen in your browser. Log in to Qobra as usual (SSO / MFA included) and click Authorize.

Connected

The client receives a short-lived token and the Qobra tools appear in its toolbox. Tokens are scoped to your user and company, and can be revoked.

​Prerequisites

​Server URL

​Add the server to your client

​Authorize (OAuth consent)

Prerequisites

Server URL

Add the server to your client

Authorize (OAuth consent)