> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/dscout-ai/dscout-mcp/set-up-the-dscout-mcp.md).
# Set up the Dscout MCP
*The Dscout MCP is currently in closed beta. Only certain users have access, and the feature may change before general availability. For more information, contact your Dscout Account Director.*
{% hint style="success" %}
**Tip:** Pass this document along to your organization's IT department so they can configure the Dscout MCP for you and your teammates. You may not have the permissions necessary in your chosen AI tool to enable the MCP yourself. If you have any questions, reach out to your Dscout Account Director.
{% endhint %}
The Dscout MCP lets you use Dscout research methods and analysis tools in AI workflows. Your data stays secure.
### Supported tools
You can connect the Dscout MCP to the following AI platforms:
{% columns %}
{% column %}
* Claude.
* Claude Code.
* Figma Make.
* Codex.
* Cursor.
* Rovo.
{% endcolumn %}
{% column %}
* VS Code (GitHub Copilot).
* Antigravity.
* Microsoft 365 Copilot.
* Windsurf.
* Kiro.
{% endcolumn %}
{% endcolumns %}
### Security measures
The Dscout MCP includes these security measures:
* OAuth sign-in ensures no API keys or tokens are shared.
* A Dscout account keeps a team member in the loop.
* Customizable read/write permissions let you choose what the Dscout MCP can do.
For supported tasks, see [Dscout MCP tools](/dscout-ai/dscout-mcp/dscout-mcp-tools.md).
### Dscout's MCP endpoint
Point your MCP client at the following endpoint to leverage the Dscout MCP:
```
https://app.dscout.com/astro/mcp
```
{% hint style="warning" %}
Opening this URL in a browser returns an error. Use it only when configuring a custom connection within an AI tool.
{% endhint %}
### Connect your AI tool
For tool-specific guidance on configuring the Dscout MCP, see the sections below:
{% tabs %}
{% tab title="Claude" icon="claude" %}
**To set up the Dscout MCP in Claude:**
{% hint style="success" %}
On certain Claude plans, you can share connectors at an organization level. On others, individual users must set up their own custom connectors.
{% endhint %}
{% stepper %}
{% step %}
Create a custom connector named `Dscout`.
{% endstep %}
{% step %}
Enter the Dscout MCP URL: `https://app.dscout.com/astro/mcp`
{% endstep %}
{% step %}
Click **Add**.
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is available as a custom connector in Claude. You'll be prompted to authenticate using your standard Dscout credentials.
{% endtab %}
{% tab title="Claude Code" icon="claude" %}
**To set up the Dscout MCP in Claude Code:**
{% stepper %}
{% step %}
Run the following command in your CLI:
```
claude mcp add dscout --transport http https://app.dscout.com/astro/mcp
```
{% endstep %}
{% step %}
Run `claude` in your CLI to open Claude.
{% endstep %}
{% step %}
Run `/mcp`. A list of your enabled MCPs is displayed, with Dscout showing as `Needs authentication`.
{% endstep %}
{% step %}
Select Dscout and press **Enter**.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, loggin in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Figma Make" icon="figma" %}
**To set up the Dscout MCP in Figma Make:**
{% stepper %}
{% step %}
Create a custom connector named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the MCP server URL.
{% endstep %}
{% step %}
Click **Connect**.
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is available as a custom connector in Figma Make. You'll be prompted to authenticate using your standard Dscout credentials.
{% hint style="success" %}
**Tip:** If the connector asks for approval too often, you can set it to auto-run in Figma Make's connector settings. This will minimize the number of times you're prompted to approve the tool's permissions.
{% endhint %}
{% endtab %}
{% tab title="Codex" icon="openai" %}
**To set up the Dscout MCP in Codex:**
{% stepper %}
{% step %}
Add a custom MCP server named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the URL.
{% endstep %}
{% step %}
Click **Save**. You're returned to your list of Codex MCPs.
{% endstep %}
{% step %}
Click **Authenticate** beside Dscout.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, logging in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Cursor" icon="cursor" %}
**To set up the Dscout MCP in Cursor:**
{% stepper %}
{% step %}
Add a custom MCP server named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the **Server URL**.
{% endstep %}
{% step %}
Click **Add MCP**.
{% endstep %}
{% step %}
Locate **Dscout** in your list of custom Cursor MCPs.
{% endstep %}
{% step %}
Click **Login**.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, logging in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Other" %}
Any MCP-compatible client can connect over streamable HTTP.
Point your client to the following endpoint:
```
https://app.dscout.com/astro/mcp
```
No authentication fields are required during configuration. Users will be prompted to authenticate with their standard Dscout credentials upon their first use.
{% endtab %}
{% endtabs %}
{% hint style="info" %}
**Note:** Users must have an active Dscout account to use the Dscout MCP. They will be prompted to authenticate in the browser using their existing Dscout credentials on their initial use of the MCP.
{% endhint %}
### Verify the connection
After connecting to the Dscout MCP, verify the connection with one of these prompts:
> **What studies are currently launched across my Dscout projects?** You'll see a list of launched studies, including parent project, study type, number of entries, and launch date.
> **How many responses have I received in my most recently launched study?** You'll see the number of submitted responses for the study you launched most recently.
> **Show me the most recent entry submitted to my \[study].** You'll see the most recent response for your requested study, including the participant's name, submission date, and key takeaways from their response data.
> **What was one common thread across responses in my \[study]?** You'll see an underlying theme that appeared across participant responses in your requested study, including supporting quotes and participant names.
> **Create a new Dscout usability test for me.** You'll be prompted to enter some basic details about your study (study name, desired project, etc.) and to answer questions about your research objectives.
If your AI tool returns an error, see [Troubleshoot the Dscout MCP](/dscout-ai/dscout-mcp/troubleshoot-the-dscout-mcp.md) for help resolving it.
### Learn more
Learn more about the Dscout MCP in these articles:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.dscout.com/dscout-ai/dscout-mcp/set-up-the-dscout-mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.