Skip to main content
The ClarityQ MCP server lets you ask ClarityQ questions from an AI assistant such as Claude, Claude Code, ChatGPT, or Cursor. The assistant sends your question to ClarityQ, and ClarityQ answers it the same way it does in Ask Anything — using your Context Layer, your data warehouse, and your permissions.
This is the opposite direction from MCP Connectors. MCP Connectors bring outside tools into ClarityQ. The ClarityQ MCP server brings ClarityQ into your AI assistant.

Prerequisites

  • MCP access turned on for your organization. It’s off by default. An Admin turns it on in Organization Settings ❭ External Access — see Turning On MCP Access.
  • A ClarityQ account with a role that can use Ask Anything in at least one workspace.
  • An AI assistant that supports remote MCP servers with sign-in (OAuth). This includes Claude (web and desktop), Claude Code, ChatGPT (web, with developer mode), and Cursor.

Turning On MCP Access

MCP access is off for every organization until an Admin turns it on. Only Admins can change it, and it applies to the whole organization, not to a single workspace.
1

Open External Access

Open Organization Settings from your profile menu and select External Access.
2

Turn on MCP access

On the MCP access card, turn the switch on. The card shows ON, and members can now connect their AI assistants.
To turn it off, turn the switch off and confirm. Members’ existing connections stop working right away, and their assistants show this message:
MCP access is turned off for your organization. Ask your admin to turn it on in Organization Settings ❭ External Access.
When you turn it on again, members don’t need to reconnect.
If the MCP access card doesn’t appear under External Access, MCP isn’t available for your organization yet. Contact your ClarityQ account manager.

Server URL

Use this URL in every client:

Claude (web and desktop)

1

Add a custom connector

In Claude, go to Customize → Connectors and click Add custom connector. On Claude Team and Enterprise plans, an organization owner adds the connector once under Organization settings → Connectors, and members then click Connect.
2

Enter the server URL

Name the connector ClarityQ and paste https://agent.clarityq.ai/mcp as the URL. Leave the OAuth client fields empty.
3

Sign in to ClarityQ

Claude opens the ClarityQ sign-in page. Sign in with the same method you use for the ClarityQ app — email and password, Google, or your company’s single sign-on.
4

Approve access

Review the consent screen and click Accept. Claude can now ask ClarityQ questions on your behalf.

Claude Code

Add the server from your terminal:
Then run /mcp inside Claude Code, select clarityq, and choose Authenticate. A browser tab opens the ClarityQ sign-in page; sign in and approve access.

ChatGPT

ChatGPT connects to MCP servers through developer mode, on ChatGPT on the web. Which plans include developer mode, and who can turn it on, is set by OpenAI — see Developer mode and MCP apps in ChatGPT. On Business, Enterprise, and Edu workspaces, a workspace admin may need to allow it first.
1

Turn on developer mode

Turn on developer mode in your ChatGPT settings, as described in OpenAI’s article above.
2

Add ClarityQ

Go to Plugins (chatgpt.com/plugins), click +, and select Add custom MCP server. Name it ClarityQ, enter https://agent.clarityq.ai/mcp as the Server URL, and choose OAuth for authentication. Leave the client ID and secret empty. Review the warning, confirm, and select Create as a plugin.
3

Sign in to ClarityQ

ChatGPT opens the ClarityQ sign-in page. Sign in and click Accept. Then install the ClarityQ plugin from your plugins.
4

Use it in a chat

In the message box, type @ and select ClarityQ, then ask your question — for example, “@ClarityQ what was weekly active users for Star Surge last week?”
Both ClarityQ tools only read data, so ChatGPT doesn’t ask you to confirm each call.

Cursor

1

Add the server

In Cursor, open Cursor Settings → Tools & MCP and click New MCP Server. Cursor opens its mcp.json file. Add ClarityQ inside mcpServers:
Don’t add a token or headers — you sign in with your ClarityQ account in the next step.
2

Sign in to ClarityQ

Back in Tools & MCP, click Connect next to clarityq. Your browser opens the ClarityQ sign-in page. Sign in and click Accept.
3

Check the tools

clarityq shows a green status and two tools, list_products and ask_question.

Other MCP clients

Add a remote (HTTP) MCP server with the URL https://agent.clarityq.ai/mcp in your client’s MCP settings. The client opens the ClarityQ sign-in page the first time it connects.

Staying Signed In

You sign in once per client. Your assistant renews access automatically in the background, so you don’t need to sign in again each session. You’ll be asked to sign in again only if your access is revoked or you remove and re-add the connector.
If you’re already signed in to ClarityQ in the same browser, the sign-in step may be skipped and you’ll go straight to the consent screen — with that account. To connect with a different ClarityQ account, sign out of ClarityQ in that browser first.

Disconnecting

Remove the connector from your assistant’s connector or MCP settings — for example Customize → Connectors in Claude, Plugins in ChatGPT, or claude mcp remove clarityq in Claude Code. Your ClarityQ conversations and data are not affected.