By Ira Bodnar, Ryze AI · Updated
Quick answer
The Microsoft Copilot chat window has no field for an MCP URL. Meta Ads goes in through an agent: connect Meta Ads in a Ryze AI workspace, then add https://connector.get-ryze.ai/mcp to a Copilot Studio agent as a Model Context Protocol tool with OAuth 2.0 and Dynamic discovery, and sign in to Ryze AI when asked.
- In Ryze AI open Integrations, find Meta Ads under Advertising and click Connect
- In Copilot Studio open your agent, then Tools, Add a tool, New tool, Model Context Protocol
- Enter a name, a description and the URL, choose OAuth 2.0 with Dynamic discovery, then Create
- Create a new connection, sign in to Ryze AI and select Add to agent
Before you start
- A Copilot Studio agent or a Microsoft 365 Copilot declarative agent. Adding an MCP tool is a maker task, usually done by an agent builder or an admin in a work or school tenant. Microsoft says Copilot Studio is available to all Microsoft 365 users for creating agents and actions. With a trial you can create and test agents but not publish them.
- A Copilot Studio plan that includes connectors. Microsoft says MCP access in Copilot Studio relies on Power Platform connectors. Its licensing page says the Copilot Studio for Teams plan, included in select Microsoft 365 subscriptions, has no Power Platform connectors or generative orchestration; those need a standalone Copilot Studio subscription. Microsoft does not say whether MCP tools run on the Teams plan, so test first.
- A Meta login with access to your ad accounts. Ryze AI signs in with Meta. The login needs a Meta Business account with an ad account and at least Advertiser access on it, and Admin access if you want the agent to make changes. Access granted through Meta Business Manager works best.
- 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. Connecting the connector is free; the Meta Ads tools need an active plan or trial.
How to connect Copilot Studio to Meta Ads
Step 1 happens in Ryze AI, steps 2 to 6 in Copilot Studio. The connector URL is the same for every user.
Connect Meta Ads in Ryze AI
Sign in to Ryze AI, open Integrations in the left sidebar and find Meta Ads under Advertising. Click Connect, sign in to Meta and approve access with every requested permission checked. The card then shows Connected. You do not pick an ad account: Ryze AI sees every ad account that Meta login can reach.
Start a new MCP tool on your agent
In Copilot Studio open the agent and go to its Tools page. Select Add a tool, then New tool, then Model Context Protocol. The MCP onboarding wizard opens.
Enter the server details
Server name: Ryze AI. Server description: one or two plain sentences, for example Reads Facebook and Instagram ad performance and manages Meta campaigns. Microsoft says the agent orchestrator uses this text to decide when to call the server. Server URL: https://connector.get-ryze.ai/mcp.
Pick OAuth 2.0 with Dynamic discovery
Set authentication to OAuth 2.0 and the type to Dynamic discovery. The Ryze AI server supports dynamic client registration, so you enter no client ID, secret or callback URL. Select Create, then Next.
Create the connection and add the tool
On the Add tool dialog select Create a new connection and finish the Ryze AI sign-in. Then select Add to agent.
Test with a Meta Ads question
Open the test chat panel and ask: Show Meta spend, ROAS and CTR by campaign for the last 30 days. If no Meta Ads tool runs, go through the errors and fixes below.
The Ryze AI help article for Meta Ads covers the Meta side of the connection. Microsoft's page on connecting an agent to an existing MCP server covers the Copilot Studio wizard.
Microsoft 365 Copilot declarative agent
If your team works in Microsoft 365 Copilot rather than Copilot Studio, the same URL can become an MCP plugin inside a declarative agent. Microsoft describes this in its Agents Toolkit walkthrough.
- Install Visual Studio Code and Microsoft 365 Agents Toolkit, version 6.12.0 or later.
- In Agents Toolkit 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 check that Custom App Upload Enabled and Copilot Access Enabled show. If not, your admin has to allow custom app upload.
- In the Lifecycle pane select Provision.
- Open m365.cloud.microsoft/chat, pick the agent whose name ends in dev, ask a Meta Ads question and select Sign in when prompted.
Microsoft says Agents Toolkit sets up dynamic tool discovery for the plugin, so the agent resolves the server's tools at run time. Sideloading needs an admin to turn on Upload custom apps in the Teams admin center.
Source: Build a plugin for a declarative agent from an MCP server.
Other AI clients
The same connector URL works in other MCP clients. Ryze AI has Meta Ads guides for these:
Meta Ads permissions
Two sign-ins are involved, and each one limits what the agent can reach.
- Meta sign-in in Ryze AI
- OAuth with Meta. Ryze AI requests ads_management, ads_read, business_management, pages_show_list, pages_read_engagement, pages_manage_ads, leads_retrieval, catalog_management, instagram_basic, instagram_manage_comments and public_profile. Keep every permission checked when you approve.
- Ryze AI sign-in from Copilot
- The Copilot connection signs in to Ryze AI with OAuth 2.0. The agent reaches the ad accounts that the connected Meta login can reach, and no others.
- Read-only option
- Meta roles are set in Meta, not in Ryze AI. For a hard read-only guarantee, connect a Meta login that only has read access. Change requests then fail at Meta.
- Power Platform data policy
- Microsoft says a data policy that regulates Power Platform connectors also regulates the MCP server and its tools. If a policy blocks the connector, your Power Platform admin has to allow it.
Sources: Microsoft's MCP server and data policies note and the Ryze AI Meta Ads integration.
Removing access
To remove access, delete the Ryze AI tool from the agent in Copilot Studio or remove its connection under your Power Platform connections. To cut Ryze AI off from Meta, open Integrations in Ryze AI and disconnect Meta Ads, or remove the app in your Meta account settings.
What Copilot can do in Meta Ads
The Ryze AI connector exposes 10 Meta Ads tools: 7 read, 2 write and 1 delete. A Copilot agent calls them as the Meta login you connected. Over MCP every meta_ads tool takes an optional connection_id for choosing a login.
| Tool | Type | What it does |
|---|---|---|
| meta_ads__listAdAccounts | Read | Lists every Meta ad account the connected user can access, with id, name and currency. |
| meta_ads__getAccountSummary | Read | Returns aggregate metrics for a Meta ad account on Meta's default attribution window. |
| meta_ads__runRawInsights | Read | Runs a raw Meta Insights query at account, campaign, ad set or ad level with breakdowns, filters and custom attribution windows. |
| meta_ads__listCreatives | Read | Lists the ad creatives in a Meta ad account. |
| meta_ads__getCreative | Read | Gets one Meta ad creative by id. |
| meta_ads__listLeadForms | Read | Lists the lead generation forms on a Facebook Page. |
| meta_ads__runGraphRead | Read | Reads any Meta Graph API object or edge, such as paused campaigns, targeting specs or the ad account activity log. |
| meta_ads__runGraphWrite | Write | Creates or updates campaigns, ad sets, ads, creatives and other objects through the Meta Graph API. |
| meta_ads__uploadImageFromUrl | Write | Uploads an image from a URL to a Meta ad account and returns an image hash for a creative. |
| meta_ads__runGraphDelete | Delete | Deletes or archives Meta objects. The tool description says it is meant for an explicit item-by-item approved list. |
How Copilot Studio asks for confirmation before a tool runs was not checked for this page, so try write requests on a test ad account first. Ryze AI cannot restore archived or deleted Meta objects.
First 3 prompts to run
Answers come from your own ad accounts, so this page describes what comes back and shows no sample figures. Paste a prompt into the test chat, or add it to the agent's instructions.
1. Spend and ROAS by campaign
For my Meta ad account, give me spend, ROAS and CTR for each campaign over the last 30 days and sort by spend.
Tools used: meta_ads__listAdAccounts, meta_ads__runRawInsights, meta_ads__getAccountSummary
What comes back: One row per campaign with the metrics you named, plus an account-level summary for the same dates on Meta's default attribution window.
2. Breakdowns by age and placement
Break last month's Meta results down by age, gender and placement, and use a 7-day click attribution window.
Tools used: meta_ads__runRawInsights
What comes back: Insights rows split by the breakdowns you asked for, on the attribution window you named.
3. Who changed an ad account
Read the activity log for this Meta ad account and list the recent changes: who made each one, when, and which object it touched.
Tools used: meta_ads__runGraphRead
What comes back: A list of changes from the ad account activity log, read through the Graph API.
Ryze AI has not tested this connection in Copilot Studio or Microsoft 365 Copilot. The steps follow Microsoft's documentation and the connector's OAuth metadata, which supports dynamic client registration. Tell Ryze AI support if anything differs.
Ryze AI vs Meta's own AI connectors
Meta runs its own AI connectors for advertisers, which is a second route into the same ad accounts. Here is how the two compare.
| Option | Setup | Meta Ads coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Meta sign-in inside Ryze AI, then one MCP tool URL on a Copilot Studio agent or a declarative agent | 10 tools: ad accounts, summaries, raw Insights with breakdowns, creatives, lead forms, Graph reads, Graph writes, image upload and delete | Copilot Studio agents, Microsoft 365 Copilot declarative agents, and other MCP clients |
| Meta ads AI connectors | Meta says the MCP path needs no developer credentials, API setup or coding. Its Business Help Center article holds the connection details, which this page could not read in full | Per Meta: reporting and campaign performance, campaign creation and editing in natural language, catalog management and signal diagnostics | Meta says the AI tools you already use and names no platform on its announcement page. Copilot Studio was not confirmed |
Meta announced the connectors in open beta on April 29, 2026, and a July 16, 2026 update added a way to connect with your own developer app and rules for business portfolio admins. If you want only Meta's server, start with Meta's help article. Ryze AI is a hosted server you add by URL, with the tool list above. Neither option was verified in a Copilot Studio agent for this page.
Sources: Meta ads AI connectors announcement, Marketing API rate limits, Get access to Copilot Studio, Ryze AI Meta Ads integration. Checked November 15, 2026.
Errors and fixes
- There is no place to paste the URL in Copilot chat
- Microsoft documents MCP only through agents. Add the URL as a tool on a Copilot Studio agent, or build a declarative agent in Agents Toolkit.
- I cannot publish the agent
- A Copilot Studio trial lets you create and test agents but not publish them. Use the test chat panel, or move to a plan that can publish.
- Model Context Protocol is missing on the Teams plan
- The Copilot Studio for Teams plan has no Power Platform connectors or generative orchestration, and MCP access relies on connectors. Ask your admin about a standalone Copilot Studio subscription.
- The connector is blocked
- A Power Platform data policy that regulates connectors also regulates the MCP server. Ask your Power Platform admin to allow it.
- Agents Toolkit says Custom App Upload is not enabled
- An admin has to turn on Upload custom apps in the Teams admin center. Once they do, reload the Accounts pane.
- The agent never calls the Meta Ads tools
- Microsoft says the orchestrator reads the server description to decide whether to call it. Rewrite the description to say what the tools do, such as reading Meta ad performance and managing campaigns.
- The tools return a subscription message or no data
- The Meta Ads tools need an active Ryze AI plan or free trial, and the Meta Ads card under Integrations in Ryze AI must show Connected.
- Meta asks you to reconnect
- Meta access expires more often than other platforms, for example after two-factor or Business Manager role changes. Click Reconnect on the Meta Ads card in Ryze AI and approve every permission again.
- An ad account is missing
- Ryze AI only sees ad accounts the connected Meta login can reach. Open View on the Meta Ads card and connect the right login.
- Meta returns a rate limit error
- Meta documents error codes 17, 613 and 80004 for rate limits, with business use case limits counted per ad account over one hour. Wait, then retry with fewer requests.
- Creative writes are slow
- Per the tool description, Meta rate-limits creative writes to about one per 30 seconds per account. That is a Meta limit, not a Ryze AI one.
Frequently asked questions
How do I connect Microsoft Copilot to Meta Ads?
Ryze AI is the best Meta Ads MCP server for a Copilot agent that has to change campaigns as well as report, though Ryze AI has not tested it in Copilot Studio and it needs a Ryze AI plan or trial. Connect Meta Ads in Ryze AI, then add https://connector.get-ryze.ai/mcp as a Model Context Protocol tool on your Copilot Studio agent with OAuth 2.0 and Dynamic discovery.
Is there a Meta Ads connector for Copilot?
The Microsoft pages checked for this guide list no Meta Ads connector. Copilot Studio lets you add an existing MCP server as a tool. Meta has announced its own ads AI connectors in open beta, and Ryze AI offers a hosted MCP server you can add the same way.
Can I paste an MCP URL into the Copilot chat app?
No. Microsoft documents MCP only through agents. The URL field is on an agent's Tools page in Copilot Studio, or in a declarative agent built with Microsoft 365 Agents Toolkit.
Which Copilot plan do I need?
Microsoft says Copilot Studio is available to all Microsoft 365 users for creating agents and actions, and a trial can create and test but not publish. The Teams plan has no Power Platform connectors, which MCP access relies on, so plan for a standalone Copilot Studio subscription. Declarative agents also need an admin to allow custom app upload.
What Meta access do I need?
A Meta Business account with an ad account, and at least Advertiser access on it. Admin access is needed to allow changes. Granting it through Meta Business Manager is the ideal route, and you should keep every requested permission checked when you approve.
Can Copilot change my campaigns or delete ads?
Through Ryze AI it can. The write tools create and update campaigns, ad sets, ads and creatives and upload images, and a separate delete tool deletes or archives objects. Ryze AI cannot restore archived or deleted objects. For a read-only setup, connect a Meta login that only has read access.
Does the Ryze AI connector work with Copilot Studio?
The connector is a remote MCP server with OAuth that supports dynamic client registration, which matches Microsoft's Dynamic discovery option. Ryze AI has not run it in Copilot Studio or Microsoft 365 Copilot, so try it on a test ad account first.
Can I use more than one Meta ad account?
Yes. One Meta login reaches every ad account it can access. You can add more Meta logins to one workspace with View, then Add one more account, and Agent default accounts sets which accounts the agent uses first. Separate clients belong in separate Ryze AI workspaces.
Which MCP transport does Copilot Studio support?
Microsoft says Copilot Studio supports the Streamable transport and dropped SSE support after August 2025.
How much does it cost?
Adding the connector is free, but the Meta Ads tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year. Microsoft sets Copilot Studio pricing.
How do I disconnect Meta Ads from Copilot?
Remove the Ryze AI tool from the agent in Copilot Studio. To end Ryze AI access to Meta, disconnect Meta Ads under Integrations in Ryze AI or remove the app in your Meta account.