{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Connect Copilot Studio to the eGain MCP"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connect-copilot-studio-to-the-egain-mcp","__idx":0},"children":["Connect Copilot Studio to the eGain MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this guide to connect ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Microsoft Copilot Studio"]}," (Power Platform) to your eGain MCP server. You add the MCP tool to a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard Agent"]}," so the agent can search and act on your eGain knowledge."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["eGain Knowledge tenant"]},". If you do not have one, sign up for a free trial of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI Knowledge Hub"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI Developer"]}," on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.egain.com/"},"children":["eGain.com"]},", or ask your eGain administrator to create an account for you in your team's existing tenant."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administration Console access"]}," for the partition you want Copilot Studio to read from (needed to enable Remote MCP)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copilot Studio access"]}," with permission to create ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard Agents"]}," and add tools. MCP access mirrors your eGain user's permissions — Copilot Studio can only access the portals and articles that your eGain user account can access."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact Support before you set up Remote MCP"]}," ","For versions 21.24 and earlier, Remote MCP is not available in all customer environments. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]}," to enable Remote MCP for your tenant or to confirm availability for your environment."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-enable-remote-mcp-in-your-egain-tenant","__idx":2},"children":["Step 1: Enable Remote MCP in your eGain tenant"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign in to your eGain Administration Console. Your tenant URL follows the pattern ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://<your-eGain-hostname>/<your-tenant-id>"]}," — for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://ai.egain.cloud/a1b2"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://aidev.egain.cloud/a1b2"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partition"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Turn on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Remote MCP"]}," toggle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select one of the available tabs for your use case:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent:"]}," for agent-only MCP access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authenticated Customer:"]}," for authenticated customer access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Anonymous Customer:"]}," for anonymous customer access."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the copy icon next to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server URL"]}," field to copy the URL. You will paste this into Copilot Studio in the next step."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-claude-admin.5faba482f5a31be95a654a72a125fd0f38ccd71e71ac6fc34f533e70948451cd.afe294b5.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-add-the-egain-mcp-to-copilot-studio","__idx":3},"children":["Step 2: Add the eGain MCP to Copilot Studio"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://copilotstudio.microsoft.com/"},"children":["Copilot Studio"]}," and go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agents"]}," tab. Click the dropdown beside ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Agent"]},", then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent (Standard)"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-agent.1c8eb6f3427f610f23e9dc6033d2d6b0845aa09902f874db8d84afdfe217f180.afe294b5.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Name your agent and complete the initial setup."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the top navigation bar, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tools"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a tool"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-tools.256adf84d6a821e13a0bc0bd228ac7a8028f6c2509a1d3adb2e26f9acc38d996.afe294b5.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the popup, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Model Context Protocol"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-popup.0a2106caf25833f33e58f35ae8903f251840357a772bc17259acfbe38eb95174.afe294b5.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a tool name and paste the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server URL"]}," you copied from the Administration Console into the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," based on the MCP URL you copied:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Anonymous MCP URL:"]}," set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["None"]},", then save. You can skip the remaining steps in this section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authenticated MCP URL:"]}," set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual"]},", then continue below.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-general.891e0f0797035ef7fb7421bb3ce952869c3539c1693cbba43976cb3d7d31797a.afe294b5.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the eGain Administration Console, register Copilot Studio as an MCP client:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Browser to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration > MCP"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," (for example, Copilot), a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},", and a temporary ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["https://"]}," URL in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URL"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the client credentials from eGain into Copilot Studio:"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP: Registered Clients"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Options > Edit"]}," for the Copilot client. Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," section, create one with a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," and turn on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status"]}," toggle."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the secret value right away, because it is not displayed again. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the Copilot Studio agent and paste the client ID and client secret into their respective fields."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-config.e4d9bec4d6ad89b68e8a61e62f754022cff356df5e6c95d0419661e1aa500805.afe294b5.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the eGain Administration Console and navigate to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Application"]}," page, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metadata"]}," to open your OAuth endpoints. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developer-portal/guides/authentication/metadata"},"children":["Find Your API Endpoints (Metadata)"]}," for details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy these values into the Copilot Studio MCP configuration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization URL"]}," — from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization URL"]}," in Metadata"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token URL"]}," — from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access Token URL"]}," in Metadata"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refresh Token URL"]}," — use the same value as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access Token URL"]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-fields.c25ad4f155b057bc89c621708c23c5a1503303449782598a141cc70cfd2075b3.afe294b5.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":10},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the MCP tool in Copilot Studio. Copilot Studio now displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["redirect URL"]},". Copy it, return to the eGain registered client, replace the temporary ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URL"]}," with Copilot Studio's value exactly, and save."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-redirect.27d132ebbcd39e0b86cb0b5541d8e00757e8a27a74f493c3d4883da6ef142dcd.afe294b5.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Copilot Studio, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create new connection"]},". Sign in with your eGain account when prompted. After successful login, the connection is ready and you can ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add and configure"]}," the MCP to your agent."," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-copilot-connection.10f164062345869e90cb85693de1b37c19be64f6120e6902360d98a1b1d44a0b.afe294b5.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Copilot Studio MCP and agent details, see Microsoft's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp"},"children":["Model Context Protocol in Copilot Studio"]}," documentation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-test-the-connection","__idx":4},"children":["Step 3: Test the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open your agent in Copilot Studio and ask something like:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["\"What does our master knowledge base say about refunds?\""]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication--permissions","__idx":5},"children":["Authentication & Permissions"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Copilot Studio authenticates using OAuth 2.0 with your eGain account. Copilot Studio never sees your account password."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Visibility:"]}," Copilot Studio can only see the portals and articles your eGain user is allowed to see."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revoking access:"]}," Revoke access at any time from Copilot Studio by removing or updating the MCP connection, or from your eGain account settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Anonymous access:"]}," If your portal allows it, you can skip sign-in entirely. Copilot Studio will see only what unauthenticated visitors see on your portal."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":6},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection fails after OAuth setup."]}," Verify the Authorization URL, Token URL, and Refresh Token URL match the values in your registered client's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metadata"]},". Confirm the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URL"]}," in eGain matches the redirect URL from Copilot Studio exactly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Anonymous MCP still prompts for sign-in."]}," Confirm ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," is set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["None"]}," in the Copilot Studio MCP configuration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"No portals found\"."]}," Confirm that the eGain account you signed in with has access to at least one portal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Changed eGain tenants."]}," Remove the MCP tool and reconnect using the new tenant's MCP Server URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in loop in the browser."]}," Disconnect the connection and recreate it, or try a private window or a different browser."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more issues, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developer-portal/guides/mcp/troubleshooting"},"children":["MCP Troubleshooting guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support-and-privacy","__idx":7},"children":["Support and privacy"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Support:"]}," For issues not covered above, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Privacy:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.egain.com/privacy-policies/"},"children":["eGain Privacy Policy"]}]}]}]},"headings":[{"value":"Connect Copilot Studio to the eGain MCP","id":"connect-copilot-studio-to-the-egain-mcp","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Enable Remote MCP in your eGain tenant","id":"step-1-enable-remote-mcp-in-your-egain-tenant","depth":2},{"value":"Step 2: Add the eGain MCP to Copilot Studio","id":"step-2-add-the-egain-mcp-to-copilot-studio","depth":2},{"value":"Step 3: Test the connection","id":"step-3-test-the-connection","depth":2},{"value":"Authentication & Permissions","id":"authentication--permissions","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Support and privacy","id":"support-and-privacy","depth":2}],"frontmatter":{"seo":{"title":"Connect Copilot Studio to the eGain MCP"}},"lastModified":"2026-10-12T19:03:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/mcp/copilot-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}