By Ira Bodnar, Ryze AI · Updated
Quick answer
Microsoft Copilot chat has no field for an MCP URL, so Thrad is added through an agent. Create an API key in the Thrad Platform dashboard and paste it into the Thrad card in Ryze AI, then in Copilot Studio open the agent's Tools page, add a Model Context Protocol tool with the URL https://connector.get-ryze.ai/mcp and OAuth 2.0 with Dynamic discovery, and create the connection.
- In the Thrad Platform dashboard create an API key under Settings > API keys
- In Ryze AI open Integrations, click Connect on the Thrad card and paste the key
- In Copilot Studio open your agent, go to Tools, Add a tool, New tool, Model Context Protocol
- Enter the name Ryze AI and the URL, choose OAuth 2.0 with Dynamic discovery, create a connection, sign in to Ryze AI and select Add to agent
Before you start
- A Copilot Studio agent, usually built by an admin or agent maker. Microsoft says Copilot Studio is available to all Microsoft 365 users for creating agents and actions. A trial with a work or school account lets you create and test agents but not publish them. The Copilot Studio for Teams plan in select Microsoft 365 subscriptions does not include Power Platform connectors or generative orchestration, which need a standalone Copilot Studio subscription. Whether MCP tools work on the Teams plan was not verified.
- Data policy room for the connector. Microsoft says access to MCP servers in Copilot Studio relies on Power Platform connectors, so a data policy that regulates connectors also regulates the Ryze AI server and its tools.
- A Thrad Platform account that can create an API key. Thrad's docs say only organization owners and admins can create, rotate or revoke a key. A key starts with ak_ and an organization has one active key.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and Agency is $279 per month for agencies. Annual billing takes 30% off the first year. Connecting is free; the tools need an active plan or trial.
- Ryze AI was not tested in Copilot Studio or Microsoft 365 Copilot for this page. The steps follow Microsoft's documentation and the Ryze AI server's OAuth metadata.
How to connect Microsoft Copilot to Thrad in Copilot Studio
Two steps happen in Ryze AI and five in Copilot Studio. The connector URL is the same for every user.
Create an API key in Thrad
In the Thrad Platform dashboard go to Settings > API keys, create a new key and copy it. It starts with ak_. Thrad shows the full secret only once, so paste it into Ryze AI right away.
Connect Thrad in Ryze AI
Create a Ryze AI account or sign in, open Integrations, click Connect on the Thrad card, paste the key into API key and click Continue. Ryze AI verifies it and the card shows Connected. To add another Thrad account, click View > Add one more account.
Open the agent's Tools page and start a new MCP tool
In Copilot Studio open the agent and go to its Tools page. Select Add a tool, then New tool, and in the Create new section select Model Context Protocol. The MCP onboarding wizard opens.
Enter the server details
Server name: Ryze AI. Server description: a short note such as: Reads and manages Thrad ad accounts, campaigns, ad groups and ads, and returns Thrad insights. Server URL: https://connector.get-ryze.ai/mcp. Microsoft says the agent orchestrator uses the description to decide whether to call the server, so keep it plain and specific.
Choose OAuth 2.0 with Dynamic discovery
For authentication select OAuth 2.0 and set the type to Dynamic discovery, which fits servers that support dynamic client registration. The Ryze AI server supports it, so there is no client ID or secret to enter. Select Create.
Create the connection and sign in to Ryze AI
On the Add tool dialog select Create a new connection and complete the Ryze AI sign-in. Choose the workspace that holds your Thrad account and allow the connection.
Add it to the agent and ask your first question
Select Add to agent, then test the agent in Copilot Studio. Ask: Show my Thrad ad account and list my campaigns with their status.
The Ryze AI help article for Thrad covers the Thrad side of the connection. Microsoft's page is Connect your agent to an existing MCP server.
Microsoft 365 Copilot declarative agent
Microsoft 365 Copilot can use the same URL through a declarative agent built in Microsoft 365 Agents Toolkit. This is a developer workflow in VS Code, and an admin must allow custom app upload.
- In VS Code open Microsoft 365 Agents Toolkit (version 6.12.0 or later) and select Create a New Agent/App, then Declarative Agent.
- Select Add an Action, then Start with an MCP Server, and enter https://connector.get-ryze.ai/mcp.
- Choose OAuth with dynamic registration, then pick a project location and an agent name.
- In the Accounts pane sign in to Microsoft 365 and confirm that Custom App Upload Enabled and Copilot Access Enabled are shown, then select Provision in the Lifecycle pane.
- At m365.cloud.microsoft/chat open the agent (its name ends in dev), ask a question and select Sign in when prompted.
Microsoft says sideloading needs Upload custom apps turned on by an admin in the Teams admin center, and that agents can be built without a Microsoft 365 Copilot license with limited capabilities. The reviewed Microsoft docs describe MCP only through agents, so a plain Copilot chat without an agent has nowhere to paste the URL.
Sources: Build MCP plugins for Microsoft 365 Copilot and extensibility prerequisites.
ChatGPT, Claude and Claude Code
The same URL works in other MCP clients. Thrad is connected once in Ryze AI with its API key, so nothing changes on the Thrad side.
ChatGPT
In ChatGPT on the web open Plugins, select the plus button, choose Add custom MCP server, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp and choose OAuth. OpenAI lists custom MCP servers with write actions for Business and Enterprise/Edu; Pro is read and fetch only.
Claude
Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI, enter https://connector.get-ryze.ai/mcp and click Connect. To require approval for campaign changes, set write and delete tools to Needs approval under Customize, Connectors, Ryze AI.
Claude Code
Run this command, then use /mcp inside Claude Code to sign in:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userPermissions and sign-in
Thrad uses an API key instead of a Google or Microsoft sign-in for the ad account. Three things decide what a Copilot agent can see and change.
- Who can create the key
- Thrad's docs say only organization owners and admins can create, rotate or revoke keys. Ask an owner or admin if Settings > API keys is not available to you.
- One key per organization
- Thrad allows one active key per organization. If you create a new key in Thrad, the old key stops working and Ryze AI needs the new one through Reconnect on the Thrad card.
- Who can use the agent
- In Copilot Studio the OAuth 2.0 connection is made by the person who signs in, and Microsoft describes OAuth as letting individual users authenticate and grant permissions without sharing credentials. Whoever can run the agent can ask it to use the tools, so share the agent with that in mind.
Sign-in details
Thrad does not publish a scope list for its keys. Its docs describe a Bearer token on every call, with these responses and limits, and Microsoft lists the authentication options below.
| Item | Detail |
|---|---|
| Thrad 401 response | A missing, malformed, invalid, expired or revoked key returns the same 401, and Thrad does not say which |
| Thrad rate limits | 1000 requests per hour per key, and 60 per hour per key on campaign creation |
| Key secret | Shown only once, when the key is created or rotated |
| Copilot Studio auth options | None, API key (header or query parameter) or OAuth 2.0 with Dynamic discovery, Dynamic or Manual. Use OAuth 2.0 with Dynamic discovery for Ryze AI. |
Sources: Microsoft's MCP server guide, licensing and the Ryze AI help center.
Removing access
To remove access, remove the Ryze AI tool from the agent's Tools page in Copilot Studio and delete its connection. You can also click View on the Thrad card in Ryze AI and disconnect it, or rotate or revoke the key in the Thrad Platform dashboard.
What a Copilot agent can do in Thrad
The Ryze AI connector exposes 5 Thrad tools: 2 read, 2 write and 1 delete. Their names start with thrads__, the provider slug for Thrad.
| Tool | Type | What it does |
|---|---|---|
| thrads__read | Read | Reads any Thrad resource, such as the ad account, campaigns, ad groups, ads and assets. |
| thrads__insights | Read | Returns aggregated insights combining Thrad and ChatGPT (OpenAI Ads) supply: impressions, clicks, spend, CTR, CPC and CPM. |
| thrads__write | Write | Creates or updates campaigns, ad groups and ads, and activates or pauses them. |
| thrads__uploadFromUrl | Write | Uploads an image from a URL to get a file id for an ad creative. Thrad currently answers this call with a 404, so existing assets are used instead. |
| thrads__delete | Delete | Archives a campaign, ad group or ad. Archiving a campaign is irreversible. |
In the Ryze AI chat, Tool approvals starts on Skip all approvals, so the agent runs read, write and delete tools without asking. That setting belongs to the Ryze AI chat, not Copilot. The Microsoft pages reviewed for this guide do not describe a per-tool confirmation step for MCP tools, so before you share an agent, test what it does when you ask it to pause or archive something. For a read-only agent, keep the instructions to reading tasks and leave the agent unshared until you have tested it. In Claude, write and delete tools can be set to Needs approval.
First 3 prompts to run
1. Account and campaign status
Show my Thrad ad account, then list every campaign with its ad groups and whether each one is active or paused.
Tools used: thrads__read
What comes back: The ad account details and the campaign and ad group tree with their current status.
2. Thrad against ChatGPT supply
For the last 30 days, give me impressions, clicks, spend, CTR, CPC and CPM for my Thrad account, split by source so I can compare Thrad supply with ChatGPT supply.
Tools used: thrads__insights
What comes back: Aggregated metrics that combine Thrad and ChatGPT (OpenAI Ads) supply, filterable by source.
3. Pause an ad group
Pause the ad group named in my last message and then read it back so I can confirm it is paused.
Tools used: thrads__write, thrads__read
What comes back: The ad group status after the change. Changes run without an approval step unless you set one, so test this on an agent only you can use.
These prompts work in other clients, but they were not run in Copilot Studio for this page. New campaigns are submitted for Thrad's review before they go live, archiving goes through the separate delete tool, and targeting is country-level only.
Ryze AI vs the Thrad REST API
Thrad's advertiser documentation describes a REST API and mentions no MCP server of its own. Microsoft's reviewed docs list no Thrad connector for Copilot, so these are the realistic routes.
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad API key pasted into Ryze AI, then the URL https://connector.get-ryze.ai/mcp with OAuth 2.0 Dynamic discovery on a Copilot Studio agent's Tools page | 5 tools: read, insights, write, image upload from URL and archive | Copilot Studio agents, Microsoft 365 declarative agents, ChatGPT, Claude, Claude Code |
| Thrad REST API with a custom connector | Bearer token with an ak_ key against https://api.thrad.ai/v1, wrapped by your own developers as a Power Apps custom connector from an OpenAPI file | Ad account, campaigns, ad groups, ads, assets and insights as Thrad documents them | Whatever you build |
If you have developers and want your own tooling, the REST API gives you full control, and Microsoft documents custom connectors made from an OpenAPI schema file. If you want a Copilot agent to work on Thrad without writing code, the Ryze AI connector is hosted, so there is nothing to build or deploy. Thrad's tool description also says campaign creation needs a default card on the Thrad organization and a $10 deposit. That is a Thrad charge, separate from any Ryze AI price.
Sources: Thrad advertiser API authentication, Microsoft Copilot Studio MCP guide, Ryze AI Thrad integration. Checked November 14, 2026.
Errors and fixes
- There is no place to paste an MCP URL in Copilot chat
- Microsoft documents MCP through agents only. Build or open an agent in Copilot Studio and add the server on its Tools page.
- Model Context Protocol is missing under New tool
- The wizard is Microsoft's recommended route, and a custom connector through Power Apps is the alternative. Your environment or plan may restrict it, and the Teams plan does not include Power Platform connectors.
- The tool is blocked or cannot be added
- Microsoft says data policies on Power Platform connectors also regulate MCP servers. Ask your Power Platform admin whether a data policy covers the connector.
- The server fails to connect
- Copilot Studio supports only the Streamable transport, and SSE support ended after August 2025. Check that the URL is exactly https://connector.get-ryze.ai/mcp.
- Thrad tools do not show up
- If the Ryze AI connector was set up before Thrad was connected, remove and re-add the tool in the agent, then start a new test. Confirm the Thrad card in Ryze AI shows Connected.
- The Thrad connection stopped working
- Thrad keeps one active key per organization, so creating a new key invalidates the old one. Copy the current key from the Thrad Platform dashboard and use Reconnect on the Thrad card.
- Ryze AI says the key is invalid
- Check that you pasted the whole ak_ key. Thrad shows the secret only once, so if it was lost, rotate the key in Thrad and paste the new one.
- Image upload fails with a 404
- Thrad currently answers the upload call with a 404. Use an asset that already exists in your Thrad account when you create an ad.
- A campaign cannot be brought back
- Archiving a campaign is terminal. Archiving an ad group or ad deactivates it and it can be activated again.
- Thrad returns a rate limit error
- Thrad allows 1000 requests per hour per key and 60 campaign creations per hour per key. Wait and retry with fewer requests.
- The agent says a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial, then retry.
- Sideloading is off for a declarative agent
- Ask an admin to turn on Upload custom apps in the Teams admin center. The Accounts pane in Agents Toolkit should show Custom App Upload Enabled.
Frequently asked questions
How do I connect Microsoft Copilot to Thrad?
Create an API key in the Thrad Platform dashboard under Settings > API keys, then in Ryze AI open Integrations, click Connect on the Thrad card and paste the key. In Copilot Studio open your agent, go to Tools, select Add a tool, New tool, Model Context Protocol, enter the name Ryze AI, a description and the URL https://connector.get-ryze.ai/mcp, choose OAuth 2.0 with Dynamic discovery, create a new connection, sign in to Ryze AI and select Add to agent.
Can I add the MCP URL in the Copilot chat app?
No. The Microsoft docs reviewed for this page describe MCP only through agents, and there is no documented field to paste an MCP URL into Copilot chat itself. Use a Copilot Studio agent or a Microsoft 365 declarative agent.
Which Copilot plan or license do I need?
Microsoft says Copilot Studio is available to all Microsoft 365 users for creating agents. A trial with a work or school account lets you create and test agents but not publish them, and the Teams plan lacks Power Platform connectors, which MCP access relies on. For Microsoft 365 Copilot declarative agents an admin must allow custom app upload.
Does Thrad have its own MCP server for Copilot?
Thrad's advertiser documentation describes a REST API at https://api.thrad.ai/v1 with Bearer ak_ keys and mentions no MCP server. The Microsoft docs reviewed list no Thrad connector either.
Should I use the Ryze AI connector or the Thrad REST API?
Ryze AI is the best way to connect a Copilot Studio agent to Thrad without writing code, because it is hosted and has 5 tools, but it was not tested in Copilot Studio for this page, needs a Ryze AI plan or trial and its image upload tool currently fails. Developers who want their own tooling can wrap Thrad's REST API.
Can a Copilot agent change my Thrad campaigns?
The connector has tools to create and update campaigns, ad groups and ads, activate or pause them, and archive them through a separate delete tool. Whether a Copilot agent asks you to confirm each write was not verified, so test it before sharing the agent.
Which authentication type should I pick in Copilot Studio?
OAuth 2.0 with Dynamic discovery. Microsoft says it fits servers that support dynamic client registration, and the Ryze AI server supports it, so you do not enter a client ID or secret.
What Thrad access do I need?
An API key from the Thrad Platform dashboard. Thrad's docs say only organization owners and admins can create, rotate or revoke keys, and an organization has one active key.
Why does Microsoft's data policy matter here?
Microsoft says access to MCP servers in Copilot Studio relies on Power Platform connectors, so a data policy that regulates connectors also regulates the MCP server and its tools. If the tool is blocked, ask your Power Platform admin.
Can I connect more than one Thrad account?
Yes. Several Thrad accounts can be connected to one Ryze AI workspace with View > Add one more account, and a star marks the primary. There is no default accounts picker, so name the account in your prompt.
Can I undo archiving a Thrad campaign?
No. Archiving a campaign is irreversible. Archiving an ad group or ad deactivates it and it can be activated again.
What does it cost?
Connecting is free, and the tools need an active plan or trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and annual billing takes 30% off the first year. Copilot Studio licensing is billed by Microsoft.