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

# MCP Server

> Connect AI assistants like Claude to Conveo via the Model Context Protocol

Conveo exposes a remote [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that lets AI assistants interact with your studies — designing research, managing questions, running analyses, and more.

<iframe src="https://www.loom.com/embed/8e68aaf2137e44aa925407ed74ed61fc" style={{ width: '100%', border: 'none', aspectRatio: '16/9', borderRadius: '8px' }} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen="true" />

## Connection details

| Field                   | Value                                  |
| ----------------------- | -------------------------------------- |
| **Server URL**          | `https://app.conveo.ai/api/mcp`        |
| **OAuth Client ID**     | `7326f7bf-48d6-4b75-a418-0c9c0d8eb901` |
| **OAuth Client Secret** | *(leave empty)*                        |

Authentication uses OAuth 2.0 — you'll be redirected to sign in with your Conveo account when connecting for the first time.

## Adding to Claude Code

Add the following to your Claude Code settings (`.claude/settings.json`):

```json theme={null}
{
  "mcpServers": {
    "Conveo": {
      "type": "url",
      "url": "https://app.conveo.ai/api/mcp",
      "oauthClientId": "7326f7bf-48d6-4b75-a418-0c9c0d8eb901"
    }
  }
}
```

After adding the server, Claude Code will prompt you to authenticate with Conveo the first time a tool is invoked.

## Adding to Claude Desktop

Open **Settings → Developer → Edit Config** and add:

```json theme={null}
{
  "mcpServers": {
    "Conveo": {
      "type": "url",
      "url": "https://app.conveo.ai/api/mcp",
      "oauthClientId": "7326f7bf-48d6-4b75-a418-0c9c0d8eb901"
    }
  }
}
```

Restart Claude Desktop and authorize when prompted.

## Adding to other MCP clients

Any MCP-compatible client can connect using the details above. Provide the server URL and OAuth Client ID — no client secret is needed.

## Available tools

Once connected, your AI assistant has access to tools for:

* **Studies** — create and configure studies, update settings and welcome pages
* **Research objectives** — add, update, reorder, and delete objectives
* **Questions** — add, update, move, and delete questions; manage answer options and routing logic
* **Stimuli** — create stimuli, attach assets, and link them to objectives or questions
* **Quotas & parameters** — configure quota groups, parameter sets, and response limits
* **Analysis** — create analysis sessions, query study data, and search interview clips
* **Quote reels** — list and download quote reels, prepare snippet downloads
* **Recruitment** — view recruitment overview and manage participant reporting
