> ## Documentation Index
> Fetch the complete documentation index at: https://greatquestion.co/support/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP: Setup

> Connect Claude, ChatGPT, Cursor, Copilot, or any MCP client to Great Question.

First, ensure the MCP option is toggled on on the [AI & MCP page](https://greatquestion.co/ai_preferences) in Settings. Second, decide whether PII should be hidden via the MCP:

<Frame>
  <img src="https://mintcdn.com/greatquestion/urF3gYulF0hv6l3B/support/images/image-28.png?fit=max&auto=format&n=urF3gYulF0hv6l3B&q=85&s=2ad9e11954956fcc5d334f500fb96e26" alt="Image" width="1830" height="466" data-path="support/images/image-28.png" />
</Frame>

All clients connect to the same server URL:

```text theme={null}
https://greatquestion.co/api/mcp/v1
```

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:

```text theme={null}
claude mcp add --transport http GreatQuestion https://greatquestion.co/api/mcp/v1
```

### 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:

```text theme={null}
{
  "mcpServers": {
    "great-question": {
      "url": "https://greatquestion.co/api/mcp/v1"
    }
  }
}
```

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:

* [Add the MCP server in Copilot Studio by using the *MCP onboarding wizard* ](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent#option-1-use-the-mcp-onboarding-wizard-recommended)(recommended)
* [Create a custom connector to your server through Power Apps](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent#option-2-create-a-custom-mcp-connector-in-power-apps)

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](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. <Tooltip tip="Add tooltip text">Feel free to adjust the server description as desired.</Tooltip>
6. Select the authentication type for your MCP server, if applicable. You have three options:
   1. **None**
   2. **API key**: [Configure API key authentication](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent#configure-authentication-with-your-mcp-server)
   3. **OAuth 2.0**: [Configure OAuth 2.0 authentication](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent#configure-authentication-with-your-mcp-server)
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.

<Tooltip tip="Add tooltip text">Note: This is separate from the OAuth setup above, which is for a person actively using an MCP client. Use an API token when you want an agent to run unattended. For example, checking recruitment status overnight or applying a screener template as part of an automated workflow.</Tooltip>

## 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`

<StillNeedHelp />