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
18 changes: 11 additions & 7 deletions app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
```mdx
import { Steps } from "nextra/components";
import { SignupLink } from "@/app/_components/analytics";
import Image from "next/image";
Expand All @@ -12,12 +13,14 @@ export const STEP_3_HEIGHT = 1074;
export const STEP_4_WIDTH = 1512;
export const STEP_4_HEIGHT = 790;

<!-- Editorial: Arcade Terminology - Changed "MCP Gateway" to "MCP gateway" in title to match lowercase technical terms guideline -->

# Use Arcade in Microsoft Copilot Studio

<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 +29,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,18 +56,18 @@ 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

<Image
alt={"Step 2: Configure MCP Gateway with OAuth 2.0 and Dynamic Discovery"}
alt={"Step 2: Configure MCP gateway with OAuth 2.0 and Dynamic Discovery"}
className="max-w-full mt-4"
src={"/images/mcp-gateway/copilot-studio/step-2.png"}
width={STEP_2_WIDTH / IMAGE_SCALE_FACTOR}
Expand All @@ -73,7 +76,7 @@ In the Model Context Protocol configuration dialog:

### Complete the authorization flow

After saving the gateway configuration, you'll be redirected to the Arcade authorization page. Review the permissions requested and click **Allow** to authorize Copilot Studio to access your MCP resources.
After saving the gateway configuration, Arcade redirects you to the authorization page. Review the permissions requested and click **Allow** to authorize Copilot Studio to access your MCP resources.

<Image
alt={"Step 3: Authorize Copilot Studio to access your Arcade account"}
Expand All @@ -85,7 +88,7 @@ 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.

Expand All @@ -98,3 +101,4 @@ Arcade provides just-in-time authorization. When you use a tool that requires ac
/>

</Steps>
```