Skip to main content
First, ensure the MCP option is toggled on on the AI & MCP page in Settings. Second, decide whether PII should be hidden via the MCP:
Image
All clients connect to the same server URL:
You’ll need an active Great Question account with MCP access enabled. The connection uses OAuth 2.1 — you’ll authenticate through your browser with your existing Great Question credentials. No API keys or secrets to manage.

​
Claude Desktop

  1. Open Settings → Connectors → Add custom connector.
  2. Enter the name Great Question and the server URL above.
  3. Click Save, then Connect. Authenticate via your browser.
  4. Restart Claude Desktop. Great Question tools will appear when you start a new chat.

​
Claude Code

Run in your terminal:

​
ChatGPT/Codex Desktop app

  1. Go to Settings → Plugins → MCPs.
  2. Click + Add server, then enter:
    • Name: Great Question
    • Type: Streamable HTTP
    • URL: https://greatquestion.co/api/mcp/v1
    • Leave other fields blank
  3. Click Save, and then authenticate.

​
Cursor

  1. Open Cursor Settings (Cmd/Ctrl + Shift + J), then select MCP from the sidebar.
  2. Click + New MCP Server to open your mcp.json file.
  3. Add the following:
  1. Save the file, then click Connect on the settings page. Authenticate via your browser.

​
Copilot

There are two ways to connect your agent to an MCP server in Copilot Studio: To connect your agent using the MCP onboarding wizard, please follow these steps:
  1. Go to the Tools page for your agent.
  2. Select Add a tool.
  3. Select New tool.
  4. Select Model Context Protocol. The MCP onboarding wizard appears.
  5. Fill in the required fields Server name, Server description, and Server URL. Write a brief, but clear description of what your MCP server does. The agent orchestrator uses this information to identify whether to call your server at runtime.
    1. Server name: Great Question
    2. Server URL: https://greatquestion.co/api/mcp/v1
    3. Server description: Give the agent read and write access to Great Question’s research platform — studies, screeners, candidates, sessions, transcripts, highlights, and insights. Use it to create and configure interview, survey, and unmoderated studies, manage participants and recruitment, pull transcripts and screener responses, and search past research for findings and highlights.
  6. Select the authentication type for your MCP server, if applicable. You have three options:
    1. None
    2. API key: Configure API key authentication
    3. OAuth 2.0: Configure OAuth 2.0 authentication
  7. Create a new connection and add the MCP server to your agent
    1. On Add tool, select Create a new connection for your MCP server or use an existing one.
    2. Select Add to agent to finish adding the MCP server to your agent.

​
Verifying your connection

Once connected, run through these quick checks in your MCP client:
  1. See your studies. Ask for your recent studies. You should see titles, statuses, and IDs you recognize.
  2. Find participants. Ask for candidates in one of those studies. Names and emails should appear as expected.
  3. Pull a transcript. Ask for transcripts from that study, then request the full content of one. Look for speaker labels and timestamps.
  4. Connect the dots. Pick a participant and ask which studies they’ve appeared in, what sessions they had, and what their transcripts say.
  5. Try a write action. Create a test candidate or draft study to confirm write access is working. You can delete it afterward.
  6. Try a repo session. Ask for recent repo sessions, pick one, and request its transcript.
If something doesn’t work, see Troubleshooting below.

​
Connecting an agent (no human login required)

Beyond the browser-based OAuth flow above, an agent can now connect to Great Question entirely on its own, without a person driving it. Give the agent a secure API token once, and it authenticates automatically in the background whenever it needs to, with no repeated logins and no OAuth window to click through. The agent only has access to what the token’s associated user can already see in Great Question. Permissions and privacy work exactly like a normal login: if that user can’t see a given study, session, or candidate, the agent can’t either.

​
Troubleshooting

OAuth window doesn’t appear? Make sure your browser allows popups from your MCP client. Some browsers block the OAuth redirect by default. Tools not showing up? Restart your MCP client after saving the configuration. If tools still don’t appear, confirm with your Great Question account team that your user has the feature enabled. An agent’s API token stops working? Tokens can be rotated or revoked from your Great Question account. Generate a new token for the agent and update it in the agent’s configuration. Since the agent only sees what its associated user can see, also confirm that user’s permissions haven’t changed. Can I query against two different Great Question workspaces? Each MCP connector can only be linked to one workspace at a time. If you work across multiple workspaces, you have two options:
  • Use a single connector and re-authenticate when switching. Disconnect the connector and authenticate it again to point it at a different workspace.
  • Create a separate connector for each workspace. When you create a connector, you can give it a name to make the workspaces easy to tell apart, for example:
    • GQ-product-lab
    • GQ-dtx