{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/mcp-server-asset/integrations/msft-connector/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#celonis-mcp-server-in-microsoft-copilot-studio\" aria-label=\"celonis mcp server in microsoft copilot studio permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"celonis-mcp-server-in-microsoft-copilot-studio\"></div><strong>Celonis MCP Server in Microsoft Copilot Studio</strong></h1>\n<p>This topic walks you through integrating your Celonis MCP Server with Microsoft Copilot Studio. This integration enables your AI agents to leverage your Celonis tools and capabilities from Microsoft Copilot Studio.</p>\n<h2 style=\"position:relative;\"><a href=\"#prerequisites\" aria-label=\"prerequisites permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"prerequisites\"></div><strong>Prerequisites</strong></h2>\n<p>Before you begin, ensure you have:</p>\n<ul>\n<li>\nCompleted the \n<a href=\"https://www.notion.so/getting-started.md\">Getting Started</a>\n guide and set up your MCP Server in Celonis  \n</li>\n<li>\nAccess to Microsoft Copilot Studio  \n</li>\n<li>\nAdministrative permissions to create OAuth clients in your Celonis Platform\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#step-1-configure-oauth-client-in-the-celonis-platform\" aria-label=\"step 1 configure oauth client in the celonis platform permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-1-configure-oauth-client-in-the-celonis-platform\"></div><strong>Step 1: Configure OAuth Client in the Celonis Platform</strong></h2>\n<p><a href=\"https://docs.celonis.com/en/registering-oauth-client.html\">Create an OAuth client</a> in your Celonis Platform with the following configuration:</p>\n<ul>\n<li>\n<strong>Grant Type</strong>\n: \n<code class=\"language-text\">Authorization Code</code>\n  \n</li>\n<li>\n<strong>Redirect URI</strong>\n: \n<code class=\"language-text\">https://global.consent.azure-apim.net/redirect/celonismcpserver</code>\n  \n</li>\n<li>\n<strong>Authentication Method</strong>\n: \n<code class=\"language-text\">Client Secret</code>\n with both:  \n<ul>\n<li>\nClient secret basic  \n</li>\n<li>\nClient secret post  \n</li>\n</ul>\n</li>\n<li>\n<strong>Refresh Token</strong>\n: Enabled  \n</li>\n<li>\n<strong>Scope</strong>\n: \n<code class=\"language-text\">mcp-asset.tools:execute</code>\n (on the subsequent screen under the “MCP” scope group)\n</li>\n</ul>\n<p>Your configuration should look like this:</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 592px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 135.08771929824562%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAbCAYAAAB836/YAAAACXBIWXMAAAsTAAALEwEAmpwYAAACTUlEQVRIx61V7XKbMBDkrdtnaB+s//ornSaZJpO0TozBGARICIF0vT0McWyTMW41s3NCiNXeh44oz4tQlhUVhQqFKglza+0MGmoZsMacR6S1obv7x3Dz455+3v6ih8ffhLW61kJesa0qTaosqdaOipKosXR2hBAoMsaEvu+p6zqCdWzb1pFzTqxtR9uysp5JA78L+FwIRmB474WQ5obnfaoi6v3wUcPSQvCTmkPSE8LD08YN1ra0eknEtqxYMXtdm+n9iQAQaq0lXseb3ojDyWHncEBoKE13lBeKM11Snisy7NoQ18vQ914yjFgLYZJm7NpasolnJGIJIYAkworLIMEJkAz5OBGES+FcNxDOBXnJAMdECEWXBP6jhJwQ/keFZlLo/XUY4z4pTJItxfFbAbsrIVnGTUm3XDarF1rHG9rtcr5i6BzmA+h3gCisox+IwjhOmSwhzaUz1FR3APfOwjWU1zFANilUZU3xZksbdn3DNkkymWMNh8Gu2W543RgrhY/wjMBB4MA8QuNUqqZtVrCrrRS51o10lqHgrRQ9nmt+lv6475HjvJbE9pKgaIhXwypSefEvY2oOWZZLDOFuyvcal3woI38xxv0T4es64Y5TimuShK47Ss48kAx8J90GMUT8xiyjNza8NhStXwRUQNSzkjW7env3QLu8kAIH6dUxxJ/t+c+rNFbFc7hwXZPYEyr+F6POULji6kH3mO8uYaZB+KFslg7b8h/QBnpaefr0paXPXxlsn1b7m7I0+K5DZ/H8i/X07Xs3QVU9/QW8w0Ha0fPBEQAAAABJRU5ErkJggg=='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"New OAuth configuration settings\"\n        title=\"New OAuth configuration settings\"\n        src=\"/static/d36b229d78260fdec1f0a0e77b05cc3b/1b853/mcp-new-configuration.png\"\n        srcset=\"/static/d36b229d78260fdec1f0a0e77b05cc3b/d4770/mcp-new-configuration.png 228w,\n/static/d36b229d78260fdec1f0a0e77b05cc3b/379c3/mcp-new-configuration.png 455w,\n/static/d36b229d78260fdec1f0a0e77b05cc3b/1b853/mcp-new-configuration.png 592w\"\n        sizes=\"(max-width: 592px) 100vw, 592px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<ol>\n<li>\nClick the \n<strong>Define Scopes</strong>\n button. \n</li>\n<li>\nScroll down to the \n<strong>mcp</strong>\n group and expand it. \n</li>\n<li>\nThen select the \n<code class=\"language-text\">mcp-asset.tools:execute</code>\n option and click \n<strong>Create</strong>\n.\n</li>\n<li>\nIn the Client Credentials window, use the \n<strong>Copy to clipboard</strong>\n buttons to save your Client ID and Client Secret as you'll need them in \n<a href=\"#step-3-configure-the-connection\">Step 3</a>\n.\n<br>\n<br>\n\n\n<span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 910px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 28.947368421052634%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAGCAYAAADDl76dAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAvElEQVQY042Q2wrDIBBE/f9/LC2hb4kJyXq/TV2DKZYWKhzcxHF2R/GYnrjdJ/CulIbWI0qpvyBSkHKFkHLDPK9Ylg10nAdEGkettTIIIcD7kRDiUDMpJfASKWXkfBJjQohvAf8rpVRZp68y7Kzle6wXxlj4OoXzHta52tU3urgZVsoP2ERrg32nNrHgaByLzYio1Wx+4c6dm/SJPw2tdVDatGQtMovZqL1Xf7P+7cN19s2w5NKactJYY78AP8zVWkrtBHcAAAAASUVORK5CYII='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_client_credentials\"\n        title=\"mcp_client_credentials\"\n        src=\"/static/38c9fb3c228bc9fcd191297d37d04dbb/c6bbc/mcp-client-credentials.png\"\n        srcset=\"/static/38c9fb3c228bc9fcd191297d37d04dbb/d4770/mcp-client-credentials.png 228w,\n/static/38c9fb3c228bc9fcd191297d37d04dbb/379c3/mcp-client-credentials.png 455w,\n/static/38c9fb3c228bc9fcd191297d37d04dbb/c6bbc/mcp-client-credentials.png 910w,\n/static/38c9fb3c228bc9fcd191297d37d04dbb/844cc/mcp-client-credentials.png 1306w\"\n        sizes=\"(max-width: 910px) 100vw, 910px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span>\n</li>\n</ol>\n<p><strong>NOTE:</strong> When configuring a connection using the Authorization Code, the client ID and client secret will inherit permissions from the user. If additional permissions need to be assigned, go to the package you are using in Studio and follow <a href=\"https://docs.celonis.com/en/managing-packages-and-package-permissions.html\">these instructions</a>.</p>\n<h2 style=\"position:relative;\"><a href=\"#step-2-add-celonis-mcp-server-to-microsoft-copilot-studio\" aria-label=\"step 2 add celonis mcp server to microsoft copilot studio permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-2-add-celonis-mcp-server-to-microsoft-copilot-studio\"></div><strong>Step 2: Add Celonis MCP Server to Microsoft Copilot Studio</strong></h2>\n<p><strong>NOTE:</strong> Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice.</p>\n<p>Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.</p>\n<ol>\n<li>\nOpen Microsoft Copilot Studio and navigate to your Agent Configuration.  \n</li>\n<li>\nClick on the \n<strong>Tools</strong>\n tab.  \n</li>\n<li>\nClick the \n<strong>Add a Tool</strong>\n button.  \n</li>\n<li>\nOn the Add tool screen, search for \"Celonis MCP Server\" or find it under the \n<strong>Model Context Protocol</strong>\n tab.  \n</li>\n<li>\nFollow \n<a href=\"https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-components-to-agent\">these instructions</a>\n from the Microsoft Copilot Studio help center to finish adding the tool.\n</li>\n</ol>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 666px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 72.80701754385966%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAPCAYAAADkmO9VAAAACXBIWXMAAAsTAAALEwEAmpwYAAACEklEQVQ4y5VT7Y7bIBD0+79O/rTJk7RSc2pPdxfbgA3+AGNguruOnUv76yyNsICd3Z1Zquv1CmdtGccRA2Gapi+DYktKCafTqVRt2wrZNHsMfkHB17+SsyyXywVVCAuRzVjiikwHK2WKjDVh3UFn6Y4co6Cs9H9HiovUcf7+rVRN28L7IJlyKRtyQaE1pSzgsgvvUcIdickoMSMui8RLhbq10EYhhICFDpiIv8lGNLVC33dythIBf2ktsMajbRvUdS1QSj0Ih2GUyywqt7wT+jmQWY72H2cbYcLto0bXGTYDzjlZD8JS8kHIKyOQVsvKWmbRksl2pMx7231Ozoik6UE4kymW2prJGG7PugEvZsbvfsIvWutxu7wFy9+zw7TJFbJc5/MZVW7e0VHZwzA8Zb3eSENtZc72QCbToeCnXuBHB54QkYHiHqaoDob04MC9LQ7+0/VQxmBwTkyRINqfYsbNevQcQ13x3d0wIfxhIrmmwOZw2Tvhm3+F7hU604mLxwSw5mGiPS1d/Uf4qkbKptFbKxdYYKkwfEBbI4Rdt2nMZC5kvLTkbm9I814qf2pZ6RHGaII5qmDM6g2aZs1SIk6ytzzTnXfqyGiNjgnZ+c+Ek/NwgxMN9+mXuWtuGCkg3GWQOWQNqd3GtpjHiaqe5NXsYyMu/zsCBz7tcwJOyG0HeqZxiWSUx0z/lh4An7GOXOFfkbCHkXG6I4YAAAAASUVORK5CYII='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_add_tool\"\n        title=\"mcp_add_tool\"\n        src=\"/static/0594ad3a7536d4ae616b826cc3f269d3/ace37/mcp-add-tool.png\"\n        srcset=\"/static/0594ad3a7536d4ae616b826cc3f269d3/d4770/mcp-add-tool.png 228w,\n/static/0594ad3a7536d4ae616b826cc3f269d3/379c3/mcp-add-tool.png 455w,\n/static/0594ad3a7536d4ae616b826cc3f269d3/ace37/mcp-add-tool.png 666w\"\n        sizes=\"(max-width: 666px) 100vw, 666px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<h2 style=\"position:relative;\"><a href=\"#step-3-configure-the-connection\" aria-label=\"step 3 configure the connection permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-3-configure-the-connection\"></div><strong>Step 3: Configure the Connection</strong></h2>\n<p>After selecting the Celonis MCP Server tool, you'll be prompted to create a new connection. Provide the following details:</p>\n<ul>\n<li>\n<strong>Celonis MCP Server URL</strong>\n: Your MCP Server URL from the Getting Started guide: \n<code class=\"language-text\">https://[team].[realm].celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/[mcp-server-id]</code>\n  \n</li>\n<li>\n<strong>Team and Realm</strong>\n: Your Celonis instance details. Example: \n<code class=\"language-text\">test.eu-1</code>\n from \n<code class=\"language-text\">https://**test.eu-1**.celonis.cloud</code>\n  \n</li>\n<li>\n<strong>Client ID</strong>\n: The OAuth Client ID from \n<a href=\"#step-1-configure-oauth-client-in-the-celonis-platform\">Step 1</a>\n.  \n</li>\n<li>\n<strong>Client Secret</strong>\n: The OAuth Client Secret from \n<a href=\"#step-1-configure-oauth-client-in-the-celonis-platform\">Step 1</a>\n.\n</li>\n</ul>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 800px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 71.9298245614035%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAOCAYAAAAvxDzwAAAACXBIWXMAAAsTAAALEwEAmpwYAAABV0lEQVQ4y42TibKDIAxF/f8/1NbRuoxaW7eqoBZSLk983dRm5gqyHJIQrK7rqGkaeblcqCgKrbIsiDFGUkotY+b/mzA9DANZ6vO/482wUAhB0zTSOI66vwEkzrkEcPN0WF3XdL1eP9Y9HwwzHr4sfDek4Hw+a1VV9TWKVaDxJssyyvNcQxzHocPhQJ7n0fF4pCRJ9BxyjjRseghL01RvPp1O5Ps+xXFMURRRGIa6j3HM47DdkGHIFQDYXKpw27al2+22tKgK9Pu+VwC+D0TIgFVliVvT5fMsjHHVAoj+T8ByhglxJ3GfJZ4lFv10KQDCA4TWde0SLjy8K/g0TVqMD/tAwDJ1MUwBe9ZrMJtDhFDkBsqH8ROI6jYvAi1CReL/AN0CwhiEUgEMLR/g4UsOpTXX0urz27NRQeExYIjEcl1XBkGA+tLt3F+VWQOhTh3HJjDwAGzblg9oakCfjuUKJQAAAABJRU5ErkJggg=='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_connect_to_mcp_server\"\n        title=\"mcp_connect_to_mcp_server\"\n        src=\"/static/3c627757b64b7ea16d0cf02acbe7c790/5a190/mcp-connect-to-mcp-server.png\"\n        srcset=\"/static/3c627757b64b7ea16d0cf02acbe7c790/d4770/mcp-connect-to-mcp-server.png 228w,\n/static/3c627757b64b7ea16d0cf02acbe7c790/379c3/mcp-connect-to-mcp-server.png 455w,\n/static/3c627757b64b7ea16d0cf02acbe7c790/5a190/mcp-connect-to-mcp-server.png 800w\"\n        sizes=\"(max-width: 800px) 100vw, 800px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<p>Click <strong>Create</strong>. Once the connection is established, click <strong>Add and Configure</strong>.</p>\n<h2 style=\"position:relative;\"><a href=\"#step-4-view-available-tools\" aria-label=\"step 4 view available tools permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-4-view-available-tools\"></div><strong>Step 4: View Available Tools</strong></h2>\n<p>Once the connection is successfully configured, you'll see all the tools available from your MCP Server asset:</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 910px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 50%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAKCAYAAAC0VX7mAAAACXBIWXMAAAsTAAALEwEAmpwYAAABXklEQVQoz11SzXrAIAjz/V9yp112WusvgrJE7b5uhxQUGyAQvj4+55Wi51y81Or1oLXmvXcXgLY28QtveJ9ShhUX6d5EPJeCu+Tfd/TQVN3GdLUB2Ho4xvYH7ufcYDwL4t28q/lcMfeBzxuhicJxVKILOWdkFjcQPpYJREk2vArPvshYiOHwizlA2BTZGXBkHp7QFoOsikSskpkZq7IJ7dxtIvqbjOdQW1+EXc9P0K8f3ToqpFVl9eZFNpSJDuGbmDyhVAgPMkE7/Ol3GLD0Fb7ZJqSGGRLpH6KxztSYpCFVWdo8+lBD6sZKC/xUMHHo1/FDgjy5vQn/AW9CLOIVZE871LBhHQqIbqxBhl3TB2kEGUk5oGeIBKdutqsMd2mnFQB6XtcFsrIqrWXv3URFm7B7QssJsRjj2j2+5T6utWPLV2770cleuKxqL0AKVJFwf7cNLrOyqtP6OOvTMbwfYnwRBEkrc2MAAAAASUVORK5CYII='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_view_tools\"\n        title=\"mcp_view_tools\"\n        src=\"/static/3920857d5029135115fb7950decb198f/c6bbc/mcp-view-tools.png\"\n        srcset=\"/static/3920857d5029135115fb7950decb198f/d4770/mcp-view-tools.png 228w,\n/static/3920857d5029135115fb7950decb198f/379c3/mcp-view-tools.png 455w,\n/static/3920857d5029135115fb7950decb198f/c6bbc/mcp-view-tools.png 910w,\n/static/3920857d5029135115fb7950decb198f/d8104/mcp-view-tools.png 1365w,\n/static/3920857d5029135115fb7950decb198f/8bb81/mcp-view-tools.png 1602w\"\n        sizes=\"(max-width: 910px) 100vw, 910px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<h2 style=\"position:relative;\"><a href=\"#step-5-activate-the-connection\" aria-label=\"step 5 activate the connection permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-5-activate-the-connection\"></div><strong>Step 5: Activate the Connection</strong></h2>\n<p>The first time you use the tool, you'll need to activate the connection:</p>\n<ol>\n<li>\nSend your first message to the agent to trigger the connection.  \n</li>\n<li>\nClick the link in the agent’s response to navigate to the Connection Manager.\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 384px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 28.50877192982456%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAGCAYAAADDl76dAAAACXBIWXMAAAsTAAALEwEAmpwYAAAA/UlEQVQY031Qy26DMBDk5/pl/Ygc+xk9VeLYC+LWSm1UQIi4xoDNmxC8U68TUamVstJodm3vzHoD3dSolKK6rsFQSqGqKjRN47ksS0gpPThn8Bup3J27ZxaypHmeEYYhBV+FoLQQKE4nJEmCLMuQ5znSNIUQAsMwwBizo+s69H0HM87QDlU/OYxwQXEcI5iWM0anzg7czDxN057bbcPlsuJukCWmKIoo6J2jMdq7a639BMx+mrZF67hxX1vXqygReexaLt+c6U0QwT3j5w+Bh6cQj+Gbr7frIF6Ed8k79+d/Ba21uzPD3hrfpcHh9RMvx29fW/oV5HUsy/JP8AehN8ocdXLL+gAAAABJRU5ErkJggg=='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_connection_mgr_link\"\n        title=\"mcp_connection_mgr_link\"\n        src=\"/static/c5ed591a049734a839fcf25ce50259d0/804b2/mcp-connection-mgr-link.png\"\n        srcset=\"/static/c5ed591a049734a839fcf25ce50259d0/d4770/mcp-connection-mgr-link.png 228w,\n/static/c5ed591a049734a839fcf25ce50259d0/804b2/mcp-connection-mgr-link.png 384w\"\n        sizes=\"(max-width: 384px) 100vw, 384px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n</li>\n<li>\nIn the \n<strong>Connection Manager</strong>\n, find the connection you just created and click \n<strong>Connect</strong>\n to authorize your new connection.\n</li>\n</ol>\n<h2 style=\"position:relative;\"><a href=\"#step-6-test-your-integration\" aria-label=\"step 6 test your integration permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"step-6-test-your-integration\"></div><strong>Step 6: Test Your Integration</strong></h2>\n<p>You're now ready to test your agent with the Celonis tools you've configured.</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 910px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 50%; position: relative; bottom: 0; left: 0; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAKCAYAAAC0VX7mAAAACXBIWXMAAAsTAAALEwEAmpwYAAABgUlEQVQoz2VS2Y7bMBDz//9j3xbbZJHEjiWNbrPkOEG728DMyNaQ4BzL9dfHEbPBzJBzdvi5FNTWTtSGUipKrX6u5YzlhRgDwr5jCwFLaR3zAPiQVDxB5zmBwYs+JgkJgai9+XsjZzDq15m454otFVjtFOSf7pS4bk8SoxP03sdBhwOPx4p13Xi/wViB3AW6+Xw8YXSb5bQP1DGw5NLcSesTyTJCinTa/L31U3Dfw1lu0/fu5as192Dk0s1x8DlY6XEKiijIkYTesbbp0VjS5R5x2wyNLlTF5XLBMc+yJSZhVbWkzCa7k/kN5YVKwWgVH18Bv2/Ry9PQrterx0mhb4JKFjGztDO+MUhmZI8jicpLVjj96n1c1wdbsSOlxAGNv4KBiUYBq+M/JAcFOYBsCZ39Uw8jRe63GzYOSaJy+t6I5clxO7F0J/+LyG9aBbnan5ETVXu6O5QzDUar1jgsrU+nqAvGF/kngqLEkyFxD1NWe7rvaleZdKTJznn2sHF1/gBxfQ0JnacnpAAAAABJRU5ErkJggg=='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"mcp_test_integration\"\n        title=\"mcp_test_integration\"\n        src=\"/static/d27fed65af9529d0b07dd2a1a11dec8b/c6bbc/mcp-test-integration.png\"\n        srcset=\"/static/d27fed65af9529d0b07dd2a1a11dec8b/d4770/mcp-test-integration.png 228w,\n/static/d27fed65af9529d0b07dd2a1a11dec8b/379c3/mcp-test-integration.png 455w,\n/static/d27fed65af9529d0b07dd2a1a11dec8b/c6bbc/mcp-test-integration.png 910w,\n/static/d27fed65af9529d0b07dd2a1a11dec8b/d8104/mcp-test-integration.png 1365w,\n/static/d27fed65af9529d0b07dd2a1a11dec8b/8bb81/mcp-test-integration.png 1602w\"\n        sizes=\"(max-width: 910px) 100vw, 910px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<h2 style=\"position:relative;\"><a href=\"#troubleshooting\" aria-label=\"troubleshooting permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"troubleshooting\"></div><strong>Troubleshooting</strong></h2>\n<p>If you encounter issues:</p>\n<ul>\n<li>\nVerify your OAuth client configuration matches the requirements exactly.  \n</li>\n<li>\nEnsure the redirect URI is correctly set in your Celonis OAuth client: \n<code class=\"language-text\">https://global.consent.azure-apim.net/redirect/celonismcpserver</code>\n  \n</li>\n<li>\nCheck that your MCP Server URL is correct and your asset is published.\n</li>\n<li>\nConfirm the \n<code class=\"language-text\">mcp-asset.tools:execute</code>\n scope is enabled.\n</li>\n<li>\nVerify that your OAuth Client has the \n<strong>use package</strong>\n permission assigned for your MCP Server asset.\n</li>\n</ul>","headings":[{"value":"Celonis MCP Server in Microsoft Copilot Studio","depth":1},{"value":"Prerequisites","depth":2},{"value":"Step 1: Configure OAuth Client in the Celonis Platform","depth":2},{"value":"Step 2: Add Celonis MCP Server to Microsoft Copilot Studio","depth":2},{"value":"Step 3: Configure the Connection","depth":2},{"value":"Step 4: View Available Tools","depth":2},{"value":"Step 5: Activate the Connection","depth":2},{"value":"Step 6: Test Your Integration","depth":2},{"value":"Troubleshooting","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-17T23:29:11.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"9690e527-6011-5b7e-8685-cbd61ec58755__redocly content/mcp-server-asset/integrations/msft-connector/","seo":{"title":null,"description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"mcp-server-asset/integrations/msft-connector.md","pageBaseUrl":"/mcp-server-asset/integrations/msft-connector","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Celonis MCP Server in Microsoft Copilot Studio","id":"celonis-mcp-server-in-microsoft-copilot-studio"},{"depth":2,"value":"Prerequisites","id":"prerequisites"},{"depth":2,"value":"Step 1: Configure OAuth Client in the Celonis Platform","id":"step-1-configure-oauth-client-in-the-celonis-platform"},{"depth":2,"value":"Step 2: Add Celonis MCP Server to Microsoft Copilot Studio","id":"step-2-add-celonis-mcp-server-to-microsoft-copilot-studio"},{"depth":2,"value":"Step 3: Configure the Connection","id":"step-3-configure-the-connection"},{"depth":2,"value":"Step 4: View Available Tools","id":"step-4-view-available-tools"},{"depth":2,"value":"Step 5: Activate the Connection","id":"step-5-activate-the-connection"},{"depth":2,"value":"Step 6: Test Your Integration","id":"step-6-test-your-integration"},{"depth":2,"value":"Troubleshooting","id":"troubleshooting"}]},"data":{"title":""},"catalogInfo":null,"link":"/mcp-server-asset/integrations/msft-connector/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}