Skip to content

Commit cb4206b

Browse files
avogurugithub-actions[bot]torresmateo
authored
copilot studio docs (#661)
* copilot studio docs * 🤖 Regenerate LLMs.txt * Update app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * added copilot studio to the MCP client grid * Update app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Mateo Torres <torresmateo@gmail.com> Co-authored-by: Mateo Torres <mateo@arcade.dev>
1 parent f989118 commit cb4206b

9 files changed

Lines changed: 110 additions & 0 deletions

File tree

‎app/en/guides/tool-calling/mcp-clients/_meta.tsx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,9 @@ const meta: MetaRecord = {
2020
"visual-studio-code": {
2121
title: "Visual Studio Code",
2222
},
23+
"copilot-studio": {
24+
title: "Microsoft Copilot Studio",
25+
},
2326
};
2427

2528
export default meta;

‎app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
import { Steps } from "nextra/components";
2+
import { SignupLink } from "@/app/_components/analytics";
3+
import Image from "next/image";
4+
5+
export const IMAGE_SCALE_FACTOR = 2;
6+
export const STEP_1_WIDTH = 1058;
7+
export const STEP_1_HEIGHT = 462;
8+
export const STEP_2_WIDTH = 1246;
9+
export const STEP_2_HEIGHT = 902;
10+
export const STEP_3_WIDTH = 924;
11+
export const STEP_3_HEIGHT = 1074;
12+
export const STEP_4_WIDTH = 1512;
13+
export const STEP_4_HEIGHT = 790;
14+
15+
# Use Arcade in Microsoft Copilot Studio
16+
17+
<GuideOverview>
18+
<GuideOverview.Outcomes>
19+
20+
Connect Microsoft Copilot Studio to an Arcade MCP Gateway.
21+
22+
</GuideOverview.Outcomes>
23+
24+
<GuideOverview.Prerequisites>
25+
26+
1. A Microsoft 365 subscription with access to Copilot Studio
27+
2. Create an <SignupLink linkLocation="docs:copilot-studio-client">Arcade account</SignupLink>
28+
3. Get an [Arcade API key](/get-started/setup/api-keys)
29+
4. Create an [Arcade MCP Gateway](/guides/create-tools/mcp-gateways) and select the tools you want to use
30+
31+
</GuideOverview.Prerequisites>
32+
33+
</GuideOverview>
34+
35+
<Steps>
36+
37+
### Create or open your agent
38+
39+
In [Copilot Studio](https://copilotstudio.microsoft.com/), create a new agent or open an existing one that you want to connect to Arcade tools.
40+
41+
### Add a new MCP tool
42+
43+
1. Inside your agent, click the **Tools** tab in the navigation panel
44+
2. Click on **Add a tool**
45+
3. In the Add tools panel, select **Model Context Protocol**
46+
4. Click on **New tool** to configure a new MCP connection
47+
48+
<Image
49+
alt={"Step 1: Navigate to the Tools menu in Copilot Studio"}
50+
className="max-w-full mt-4"
51+
src={"/images/mcp-gateway/copilot-studio/step-1.png"}
52+
width={STEP_1_WIDTH / IMAGE_SCALE_FACTOR}
53+
height={STEP_1_HEIGHT / IMAGE_SCALE_FACTOR}
54+
/>
55+
56+
### Configure the MCP Gateway connection
57+
58+
In the Model Context Protocol configuration dialog:
59+
60+
1. Enter a **Server name** for your connection (for example, "PersonalAssistantTools")
61+
2. Add a **Server description** to help identify the tools available
62+
3. Enter your Arcade MCP Gateway URL in the **Server URL** field: `https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>`
63+
4. Under **Authentication**, select **OAuth 2.0**
64+
5. Under **Type**, select **Dynamic discovery** to authorize the MCP gateway automatically using OAuth
65+
66+
<Image
67+
alt={"Step 2: Configure MCP Gateway with OAuth 2.0 and Dynamic Discovery"}
68+
className="max-w-full mt-4"
69+
src={"/images/mcp-gateway/copilot-studio/step-2.png"}
70+
width={STEP_2_WIDTH / IMAGE_SCALE_FACTOR}
71+
height={STEP_2_HEIGHT / IMAGE_SCALE_FACTOR}
72+
/>
73+
74+
### Complete the authorization flow
75+
76+
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.
77+
78+
<Image
79+
alt={"Step 3: Authorize Copilot Studio to access your Arcade account"}
80+
className="max-w-full mt-4"
81+
src={"/images/mcp-gateway/copilot-studio/step-3.png"}
82+
width={STEP_3_WIDTH / IMAGE_SCALE_FACTOR}
83+
height={STEP_3_HEIGHT / IMAGE_SCALE_FACTOR}
84+
/>
85+
86+
### Start using your tools
87+
88+
Once the connection is established, return to your agent and start a conversation. Now you can directly interact with your tools.
89+
90+
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.
91+
92+
<Image
93+
alt={"Step 4: Chat with your agent using Arcade tools"}
94+
className="max-w-full mt-4"
95+
src={"/images/mcp-gateway/copilot-studio/step-4.png"}
96+
width={STEP_4_WIDTH / IMAGE_SCALE_FACTOR}
97+
height={STEP_4_HEIGHT / IMAGE_SCALE_FACTOR}
98+
/>
99+
100+
</Steps>

‎app/en/guides/tool-calling/mcp-clients/mcp-client-grid.tsx‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,13 +21,19 @@ const mcpClients = [
2121
name: "Visual Studio Code",
2222
description: "Microsoft's code editor with MCP extensions",
2323
},
24+
{
25+
key: "copilot-studio",
26+
name: "Microsoft Copilot Studio",
27+
description: "Microsoft's AI agent platform with MCP integration",
28+
},
2429
];
2530

2631
// Logo mapping
2732
const logoSrc = {
2833
cursor: "/images/icons/cursor.png",
2934
"claude-desktop": "/images/icons/claude.png",
3035
"visual-studio-code": "/images/icons/vscode.svg",
36+
"copilot-studio": "/images/icons/microsoft-copilot-studio.png",
3137
};
3238

3339
export function MCPClientGrid() {

‎public/images/icons/microsoft-copilot-studio.png‎

64.9 KB
Loading

‎public/images/mcp-gateway/copilot-studio/step-1.png‎

85.9 KB
Loading

‎public/images/mcp-gateway/copilot-studio/step-2.png‎

146 KB
Loading

‎public/images/mcp-gateway/copilot-studio/step-3.png‎

382 KB
Loading

‎public/images/mcp-gateway/copilot-studio/step-4.png‎

937 KB
Loading

‎public/llms.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,7 @@ Arcade delivers three core capabilities: Deploy agents even your security team w
237237
- [Types of Tools](https://docs.arcade.dev/en/guides/create-tools/improve/types-of-tools.md): This documentation page explains the two types of tools offered by Arcade: Optimized tools and Starter tools. It highlights the differences in design and functionality, emphasizing that Optimized tools are tailored for AI-powered chat interfaces to improve performance, while Starter tools provide more
238238
- [Understanding `Context` and tools](https://docs.arcade.dev/en/guides/create-tools/tool-basics/runtime-data-access.md): This documentation page explains the `Context` class used in Arcade tools, detailing how to access runtime capabilities and tool-specific data securely. Users will learn how to utilize the `Context` object to retrieve OAuth tokens, secrets, user information, and to log
239239
- [Use Arcade in Cursor](https://docs.arcade.dev/en/guides/tool-calling/mcp-clients/cursor.md): This documentation page provides a step-by-step guide for users to connect Cursor to an Arcade MCP Gateway, enabling the use of Arcade tools within Cursor. It outlines the prerequisites needed for setup, including creating an Arcade account and obtaining an API key, as well
240+
- [Use Arcade in Microsoft Copilot Studio](https://docs.arcade.dev/en/guides/tool-calling/mcp-clients/copilot-studio.md): This documentation page guides users on how to connect Microsoft Copilot Studio to an Arcade MCP Gateway, enabling the integration of Arcade tools within their agents. It outlines the prerequisites, step-by-step instructions for creating or opening an agent, adding an MCP tool,
240241
- [Use Arcade in Visual Studio Code](https://docs.arcade.dev/en/guides/tool-calling/mcp-clients/visual-studio-code.md): This documentation page provides a step-by-step guide for connecting Visual Studio Code to an Arcade MCP Gateway, enabling users to integrate and utilize Arcade tools within the IDE. It outlines the prerequisites for setup, including creating an Arcade account and obtaining an API key,
241242
- [Use Arcade with Claude Desktop](https://docs.arcade.dev/en/guides/tool-calling/mcp-clients/claude-desktop.md): This documentation page is intended to guide users on how to utilize Arcade with Claude Desktop. However, it currently indicates that the content is forthcoming and does not provide any detailed instructions or information at this time.
242243
- [VercelApi](https://docs.arcade.dev/en/resources/integrations/development/vercel-api.md): The VercelApi documentation provides a comprehensive guide for users to manage their Vercel projects, domains, and integrations through various API tools. It outlines available functionalities such as creating and managing access groups, handling deployments, and managing DNS records, enabling

0 commit comments

Comments
 (0)