How to connect Microsoft Copilot to Meta Ads

Connect Meta Ads once in Ryze AI, add one MCP URL as a tool on a Copilot Studio agent or a Microsoft 365 Copilot declarative agent, then ask about Facebook and Instagram spend, ROAS and creatives.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the link and opens Copilot Studio. Then add it under your agent, Tools, Add a tool, New tool, Model Context Protocol. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, find Meta Ads under Advertising and click Connect
  2. In Copilot Studio open your agent, then Tools, Add a tool, New tool, Model Context Protocol
  3. Enter a name, a description and the URL, choose OAuth 2.0 with Dynamic discovery, then Create
  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  1. Install Visual Studio Code and Microsoft 365 Agents Toolkit, version 6.12.0 or later.
  2. In Agents Toolkit select Create a New Agent/App, then Declarative Agent.
  3. Select Add an Action, then Start with an MCP Server, and enter https://connector.get-ryze.ai/mcp.
  4. Choose OAuth (with dynamic registration), then pick a project location and an agent name.
  5. 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.
  6. In the Lifecycle pane select Provision.
  7. 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.

ToolTypeWhat it does
meta_ads__listAdAccountsReadLists every Meta ad account the connected user can access, with id, name and currency.
meta_ads__getAccountSummaryReadReturns aggregate metrics for a Meta ad account on Meta's default attribution window.
meta_ads__runRawInsightsReadRuns a raw Meta Insights query at account, campaign, ad set or ad level with breakdowns, filters and custom attribution windows.
meta_ads__listCreativesReadLists the ad creatives in a Meta ad account.
meta_ads__getCreativeReadGets one Meta ad creative by id.
meta_ads__listLeadFormsReadLists the lead generation forms on a Facebook Page.
meta_ads__runGraphReadReadReads any Meta Graph API object or edge, such as paused campaigns, targeting specs or the ad account activity log.
meta_ads__runGraphWriteWriteCreates or updates campaigns, ad sets, ads, creatives and other objects through the Meta Graph API.
meta_ads__uploadImageFromUrlWriteUploads an image from a URL to a Meta ad account and returns an image hash for a creative.
meta_ads__runGraphDeleteDeleteDeletes 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.

OptionSetupMeta Ads coverageWorks in
Ryze AI connectorMeta sign-in inside Ryze AI, then one MCP tool URL on a Copilot Studio agent or a declarative agent10 tools: ad accounts, summaries, raw Insights with breakdowns, creatives, lead forms, Graph reads, Graph writes, image upload and deleteCopilot Studio agents, Microsoft 365 Copilot declarative agents, and other MCP clients
Meta ads AI connectorsMeta 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 fullPer Meta: reporting and campaign performance, campaign creation and editing in natural language, catalog management and signal diagnosticsMeta 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.

Add Meta Ads to your Copilot agent

Connect Meta Ads in Ryze AI, then add the MCP URL to your agent. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Meta Ads MCP server

Need help? Read the Ryze AI help center or email Ryze AI support.