Skip to content
  • There are no suggestions because the search field is empty.

Intentwise AI Gateway Setup Guide for Microsoft Copilot

Everything you need to connect your Microsoft Copilot Studio to your Amazon data, personalize your experience, and start generating reports using Intentwise AI Gateway.

WHAT IS MCP? 
Model Context Protocol (MCP) is an open standard that allows AI assistants like Microsoft Copilot to connect to external data sources and tools. By adding the Intentwise MCP server, your Copilot agent gains real-time access to your Amazon Advertising data, campaign performance metrics, and optimization tools.

Prerequisites

  • An active Microsoft Copilot Studio license (standalone or as part of Microsoft 365 Copilot)
  • Access to create or edit agents in Microsoft Copilot Studio
  • An active Intentwise account with API access enabled

Connection Details

Gather the following Intentwise OAuth 2.0 credentials before starting.

Setting

Value

MCP Server URL

https://mcp.intentwise.com/mcp/

Setup Steps

Step 1: Create a new agent in Copilot Studio(If you already have a Copilot Studio agent, skip to Step 2.)

Navigate to copilotstudio.microsoft.com and sign in with your Microsoft 365 account. Click “+ Create” in the left sidebar, then “New agent.” Give it a name (e.g., “Intentwise Analytics Assistant”) and click “Create.”

TIP: Consider adding a system instruction like: “You are an advertising analytics assistant powered by Intentwise. Help users analyze their Amazon Advertising campaigns, review performance data, and provide optimization recommendations.”

Step 2: Add the Intentwise MCP Server

In your agent editor, click “Tools” in the top menu, then “+ Add a tool,” then select “MCP” under Create New.

Enter the following details:
Server Name: Intentwise MCP
Server Description: Get Insights from your Retail Media data
Server URL: https://mcp.intentwise.com/mcp
Connection Type: Dynamic Discovery

Step 3: Complete the Connection

Click “Create,” then “Create new connection,” then “Create.”
The first time the agent invokes an Intentwise tool, you will be prompted to sign in. A sign-in card will appear in the chat — click “Sign in” and authenticate with your Intentwise credentials.

Step 5: Test the Connection

Try asking your agent: “Show me my top 10 campaigns by spend for the last 30 days” or “What is my total ACOS for last month?”
If you see data in the response, the integration is working correctly.

Step 6: Publish

Once tested, click “Publish” to make the agent available to your team in the Copilot app.

Available Intentwise Tools

Once connected, the Intentwise MCP server exposes these tools to your Copilot agent:

Tool

Description

get_organization

Retrieves your Intentwise organization details

get_intentwise_accounts

Lists all advertising accounts linked to your organization

search_schema

Discovers available data tables, columns, and metrics

get_insights

Runs natural language queries against your advertising data

Copilot Troubleshooting

Issue

Resolution

The sign-in pop-up does not appear

Ensure pop-ups are not blocked in your browser. Check the Authorization URL.

“Redirect URL mismatch” error

Copy the Callback URL from Copilot Studio MCP settings and share it with your Intentwise account manager.

Token expired / session timeout

Verify the Refresh URL is set to https://api.intentwise.com/mcp/oauth/token

“Server not reachable” error

Verify the MCP Server URL. Check your network/firewall settings.

No tools discovered

Try disconnecting and reconnecting the server. Contact Intentwise support if it persists.

Agent does not use Intentwise tools

Check that tools are enabled in the Tools panel. Add instructions in the agent system prompt.