Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 13 additions & 7 deletions app/en/get-started/mcp-clients/copilot-studio/page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,18 @@ export const STEP_3_HEIGHT = 1074;
export const STEP_4_WIDTH = 1512;
export const STEP_4_HEIGHT = 790;

<!-- Editorial: Structure - Added intro line and reorganized to follow 10/20/70 format -->

# Use Arcade in Microsoft Copilot Studio

Connect your Microsoft Copilot Studio agents to Arcade tools through an MCP gateway.

This guide shows you how to integrate Microsoft Copilot Studio with Arcade MCP gateways. You'll configure OAuth authentication, connect to your gateway, and start using Arcade tools in your agents. Use this when you want to extend Copilot Studio agents with external API capabilities like Gmail, Slack, or custom tools. After completing this setup, your agents can access any tools configured in your Arcade MCP gateway.

<GuideOverview>
<GuideOverview.Outcomes>

Connect Microsoft Copilot Studio to an Arcade MCP Gateway.
Connect Microsoft Copilot Studio to an Arcade MCP gateway.

</GuideOverview.Outcomes>

Expand All @@ -26,7 +32,7 @@ Connect Microsoft Copilot Studio to an Arcade MCP Gateway.
1. A Microsoft 365 subscription with access to Copilot Studio
2. Create an <SignupLink linkLocation="docs:copilot-studio-client">Arcade account</SignupLink>
3. Get an [Arcade API key](/get-started/setup/api-keys)
4. Create an [Arcade MCP Gateway](/guides/create-tools/mcp-gateways) and select the tools you want to use
4. Create an [Arcade MCP gateway](/guides/create-tools/mcp-gateways) and select the tools you want to use

</GuideOverview.Prerequisites>

Expand All @@ -53,13 +59,13 @@ In [Copilot Studio](https://copilotstudio.microsoft.com/), create a new agent or
height={STEP_1_HEIGHT / IMAGE_SCALE_FACTOR}
/>

### Configure the MCP Gateway connection
### Configure the MCP gateway connection

In the Model Context Protocol configuration dialog:

1. Enter a **Server name** for your connection (for example, "PersonalAssistantTools")
2. Add a **Server description** to help identify the tools available
3. Enter your Arcade MCP Gateway URL in the **Server URL** field: `https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>`
3. Enter your Arcade MCP gateway URL in the **Server URL** field: `https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>`
4. Under **Authentication**, select **OAuth 2.0**
5. Under **Type**, select **Dynamic discovery** to authorize the MCP gateway automatically using OAuth

Expand All @@ -85,9 +91,9 @@ After saving the gateway configuration, you'll be redirected to the Arcade autho

### Start using your tools

Once the connection is established, return to your agent and start a conversation. Now you can directly interact with your tools.
Once you establish the connection, return to your agent and start a conversation. Now you can directly interact with your tools.

Arcade provides just-in-time authorization. When you use a tool that requires access to an external service, Copilot Studio will display an authorization link. Click the link to grant access and continue. This works seamlessly with tools like SharePoint, Outlook, Teams, Stripe, and Gmail.
Arcade provides just-in-time authorization. When you use a tool that requires access to an external service, Copilot Studio will display an authorization link. Click the link to grant access and continue. This works with tools like SharePoint, Outlook, Teams, Stripe, and Gmail.

<Image
alt={"Step 4: Chat with your agent using Arcade tools"}
Expand All @@ -97,4 +103,4 @@ Arcade provides just-in-time authorization. When you use a tool that requires ac
height={STEP_4_HEIGHT / IMAGE_SCALE_FACTOR}
/>

</Steps>
</Steps>
Loading