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

# Copilot Studio

## Overview

The Spark MCP server integrates with Microsoft Copilot Studio using the MCP onboarding wizard. This enables agents to access GWI consumer insights data through OAuth 2.0 authentication.

Reference: [Copilot Studio MCP official documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-create-new-server)

## How to Use

### Setting Up Spark MCP Tool in Agent Builder

1. Open your agent, navigate to the **Tools** page, and select **New tool**

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/mcp_add_tool.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=9ae3441ad377ca78981e3c31b0834ff7" alt="Copilot Studio add MCP tool" width="1654" height="1230" data-path="assets/images/copilot_studio/mcp_add_tool.png" />

2. Select **Model Context Protocol**:

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/add_mcp_2.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=bc819d10a1c3c9887749d075a74f5581" alt="Copilot Studio add MCP tool" width="1682" height="1244" data-path="assets/images/copilot_studio/add_mcp_2.png" />

3. Configure the MCP server details, ensuring the URL is correct

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/mcp_setup.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=783d58d12d5be734e95179307c363084" alt="Copilot Studio MCP setup" width="1670" height="1234" data-path="assets/images/copilot_studio/mcp_setup.png" />

* **Server Description**: Uncover instant insights from real humans across 50+ global markets
* **Server URL**: `https://api.globalwebindex.com/v1/spark-api/mcp`

4. Select **OAuth 2.0** as the authentication type and **Dynamic discovery** as the OAuth 2.0 type
5. Create a connection.

You will be redirected to the GWI sign-in page. Use your GWI credentials to sign in.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/gwi-c45e8f9c/assets/images/claude_custom/signin.png" alt="ChatGPT MCP member signin" />

Review the requested permissions and scopes, then click **Allow** to authorize the connection.

Copilot Studio handles token refresh automatically.

Once the connection is created, you will be prompted to add the MCP tool and configure it in the agent.

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/mcp_add_config.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=011d4ea500c9637937f68db22bf490b3" alt="Copilot Studio MCP setup" width="1670" height="1230" data-path="assets/images/copilot_studio/mcp_add_config.png" />

6. You can select between two authentication modes when using MCP tools within your agent: **End user credentials** and **Maker-provided credentials**. This controls whether users should use their own GWI credentials when using the agent, or the credentials used by the tool builder.

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/mcp_config.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=e7d3336ed384374ef96fe1e57838d546" alt="Copilot Studio MCP setup" width="2262" height="2106" data-path="assets/images/copilot_studio/mcp_config.png" />

7. Finally, you can use GWI Spark MCP in your agent

<img src="https://mintcdn.com/gwi-c45e8f9c/2SjncVGznfIW7zQu/assets/images/copilot_studio/mcp_test.png?fit=max&auto=format&n=2SjncVGznfIW7zQu&q=85&s=acd4f349cb60461b167cd5a38b291263" alt="Copilot Studio MCP setup" width="3328" height="1682" data-path="assets/images/copilot_studio/mcp_test.png" />

## Troubleshooting

* **MCP server not visible**: Verify the server configuration and confirm that you have proper workspace permissions.
* **Authentication failures**: Confirm that your GWI account has Spark MCP access and that OAuth settings are correct.
