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.
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:/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?”Cursor
1
Add the server
In Cursor, open Cursor Settings → Tools & MCP and click New MCP Server. Cursor opens its Don’t add a token or headers — you sign in with your ClarityQ account in the next step.
mcp.json file. Add ClarityQ inside mcpServers: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 URLhttps://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.Disconnecting
Remove the connector from your assistant’s connector or MCP settings — for example Customize → Connectors in Claude, Plugins in ChatGPT, orclaude mcp remove clarityq in Claude Code. Your ClarityQ conversations and data are not affected.