diff --git a/app/en/guides/tool-calling/mcp-clients/_meta.tsx b/app/en/guides/tool-calling/mcp-clients/_meta.tsx index cb9deae1a..c54cd6ef1 100644 --- a/app/en/guides/tool-calling/mcp-clients/_meta.tsx +++ b/app/en/guides/tool-calling/mcp-clients/_meta.tsx @@ -20,6 +20,9 @@ const meta: MetaRecord = { "visual-studio-code": { title: "Visual Studio Code", }, + "copilot-studio": { + title: "Microsoft Copilot Studio", + }, }; export default meta; diff --git a/app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx b/app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx new file mode 100644 index 000000000..304827b5c --- /dev/null +++ b/app/en/guides/tool-calling/mcp-clients/copilot-studio/page.mdx @@ -0,0 +1,100 @@ +import { Steps } from "nextra/components"; +import { SignupLink } from "@/app/_components/analytics"; +import Image from "next/image"; + +export const IMAGE_SCALE_FACTOR = 2; +export const STEP_1_WIDTH = 1058; +export const STEP_1_HEIGHT = 462; +export const STEP_2_WIDTH = 1246; +export const STEP_2_HEIGHT = 902; +export const STEP_3_WIDTH = 924; +export const STEP_3_HEIGHT = 1074; +export const STEP_4_WIDTH = 1512; +export const STEP_4_HEIGHT = 790; + +# Use Arcade in Microsoft Copilot Studio + + + + +Connect Microsoft Copilot Studio to an Arcade MCP Gateway. + + + + + +1. A Microsoft 365 subscription with access to Copilot Studio +2. Create an Arcade account +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 + + + + + + + +### Create or open your agent + +In [Copilot Studio](https://copilotstudio.microsoft.com/), create a new agent or open an existing one that you want to connect to Arcade tools. + +### Add a new MCP tool + +1. Inside your agent, click the **Tools** tab in the navigation panel +2. Click on **Add a tool** +3. In the Add tools panel, select **Model Context Protocol** +4. Click on **New tool** to configure a new MCP connection + +{"Step + +### 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/` +4. Under **Authentication**, select **OAuth 2.0** +5. Under **Type**, select **Dynamic discovery** to authorize the MCP gateway automatically using OAuth + +{"Step + +### 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. + +{"Step + +### 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. + +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. + +{"Step + + diff --git a/app/en/guides/tool-calling/mcp-clients/mcp-client-grid.tsx b/app/en/guides/tool-calling/mcp-clients/mcp-client-grid.tsx index 065586959..9dc79abc8 100644 --- a/app/en/guides/tool-calling/mcp-clients/mcp-client-grid.tsx +++ b/app/en/guides/tool-calling/mcp-clients/mcp-client-grid.tsx @@ -21,6 +21,11 @@ const mcpClients = [ name: "Visual Studio Code", description: "Microsoft's code editor with MCP extensions", }, + { + key: "copilot-studio", + name: "Microsoft Copilot Studio", + description: "Microsoft's AI agent platform with MCP integration", + }, ]; // Logo mapping @@ -28,6 +33,7 @@ const logoSrc = { cursor: "/images/icons/cursor.png", "claude-desktop": "/images/icons/claude.png", "visual-studio-code": "/images/icons/vscode.svg", + "copilot-studio": "/images/icons/microsoft-copilot-studio.png", }; export function MCPClientGrid() { diff --git a/public/images/icons/microsoft-copilot-studio.png b/public/images/icons/microsoft-copilot-studio.png new file mode 100644 index 000000000..ae55ede97 Binary files /dev/null and b/public/images/icons/microsoft-copilot-studio.png differ diff --git a/public/images/mcp-gateway/copilot-studio/step-1.png b/public/images/mcp-gateway/copilot-studio/step-1.png new file mode 100644 index 000000000..4a0f43ec8 Binary files /dev/null and b/public/images/mcp-gateway/copilot-studio/step-1.png differ diff --git a/public/images/mcp-gateway/copilot-studio/step-2.png b/public/images/mcp-gateway/copilot-studio/step-2.png new file mode 100644 index 000000000..62a419321 Binary files /dev/null and b/public/images/mcp-gateway/copilot-studio/step-2.png differ diff --git a/public/images/mcp-gateway/copilot-studio/step-3.png b/public/images/mcp-gateway/copilot-studio/step-3.png new file mode 100644 index 000000000..ca8c43182 Binary files /dev/null and b/public/images/mcp-gateway/copilot-studio/step-3.png differ diff --git a/public/images/mcp-gateway/copilot-studio/step-4.png b/public/images/mcp-gateway/copilot-studio/step-4.png new file mode 100644 index 000000000..0294c6694 Binary files /dev/null and b/public/images/mcp-gateway/copilot-studio/step-4.png differ diff --git a/public/llms.txt b/public/llms.txt index 39f89d763..f7a3fec12 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -237,6 +237,7 @@ Arcade delivers three core capabilities: Deploy agents even your security team w - [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 - [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 - [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 +- [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, - [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, - [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. - [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