{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Custom Celonis MCP Server at Microsoft Copilot Studio","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"custom-celonis-mcp-server-at-microsoft-copilot-studio","__idx":0},"children":["Custom Celonis MCP Server at Microsoft Copilot Studio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Currently, Microsoft (MSFT) Copilot Studio has the limitation of not being able to name the connection you create when adding an MCP tool. Therefore, when using the standard ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.microsoft.com/en-us/connectors/celonismcpserver/#celonis-mcp-server"},"children":["Celonis MCP Server at MSFT Copilot studio"]},", you might face the issue of having multiple connections with the same name:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-connections.eed057bebb215c855d9d1bf77007ba8f3dc0dbbc60d363de6e596b0e69c3898d.9593a17e.png","alt":"mcp-connections"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To mitigate this issue, you can follow this guide to create a custom Celonis MCP Server connection at MSFT Copilot Studio."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-mcp-server-asset","__idx":1},"children":["Create MCP Server Asset:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create your MCP Server Asset in the Celonis Platform:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-create-celonis-mcp.9843e1a83f12bc8a8e04d5051e7a0376176244ede6c85618d5fabe48630b1a04.9593a17e.png","alt":"mcp-create-celonis-mcp"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"initial-oauth-client-setup","__idx":2},"children":["Initial OAuth client setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to the admin settings at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applications > Add New Application > OAuth Client"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete the form as shown below:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-new-oauth-client.fecd6c1e6ef703235b66ea0f126e4111e7e240afbeaf3a549b5437764ac75ab0.9593a17e.png","alt":"mcp-new-oauth-client"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dummy URI:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://global.consent.azure-apim.net/redirect/celonismcpserver"},"children":["https://global.consent.azure-apim.net/redirect/celonismcpserver"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the mcp scope and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-select-scope.e8ed661004f6ed518a5d519fc343c2e992a471959f69f8b2e6d914d5f67815c8.9593a17e.png","alt":"mcp-select-scope"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the Client ID and Client Secret."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"adding-a-custom-connector-in-msft-copilot-studio","__idx":3},"children":["Adding a custom connector in MSFT Copilot Studio"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to MSFT Copilot Studio and add a new custom MCP tool:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-add-custom-tool.945f22e540567a6bc0c8127d1d74360964ea65390c36aa347cca5f8c76172110.9593a17e.png","alt":"mcp-add-custom-tool"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the tool details:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-tool-details.b6992f1f0364a7473e43140003333bcd6449219a1ad8602897dce31cf99465d3.9593a17e.png","alt":"mcp-tool-details"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fill in the authorization details as follows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your Client ID and Client Secret"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].cloud/oauth2/authorize"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token URL template:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].celonis.cloud/oauth2/token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refresh URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].celonis.cloud/oauth2/token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes:"]}," mcp-asset.tools:execute"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-add-mcp-server.2cab80b19b65da49dd2b11b4ffe62f3062b759f7e73bd36f19aa8a2f916414b8.9593a17e.png","alt":"mcp-add-mcp-server"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},". After a moment, the following view will display:"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-server-successful.86d27a6ce9fcc56cbdf8462ed1b0e59b19f44a9772a6e801a0877849656488e5.9593a17e.png","alt":"mcp-server-successful"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the Redirect URL but ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DO NOT CLICK NEXT"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"oauth-client-setup","__idx":4},"children":["OAuth client setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Celonis Platform, navigate to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["admin settings > Applications"]}," and locate the client you created in the previous step. Click the three dots menu on the right and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-settings-applications.b4c3c5e2d4148c4c091c0c2b0d09d4b764f79b155d57718a35f9b4742d35feda.9593a17e.png","alt":"mcp-settings-applications"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}," with the Redirect URL from MSFT Copilot Studio:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-redirect-uris.de54c34514a43e8326e7f5c212ac0c72320cc5959b2ec5823a7f8f645f01c9d6.9593a17e.png","alt":"mcp-redirect-uris"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Define Scopes"]}," and then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connecting-to-the-custom-connector-in-msft-copilot-studio","__idx":5},"children":["Connecting to the custom connector in MSFT Copilot Studio"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate back to MSFT Copilot Studio and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},":"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-tool-created-next.38b0a58c7786c5c57f334a687468670558bc6dcd40e81dd01f67300f1b70d47f.9593a17e.png","alt":"mcp-tool-created-next"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following window will display. Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection"]}," button to create a new connection:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-add-tool-connection.38de54da26d03a500b805c1fd47625ebbc9979558c43765f695c335769ae5569.9593a17e.png","alt":"mcp-add-tool-connection"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mcp-connect-to-server.03deced16f5d1ad3c26bd28de60fc2cd81724cb93ee5546bdc81f3aaca12ffba.9593a17e.png","alt":"mcp-connect-to-server"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the connection is created, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add and configure"]}," button."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The connection is now added and your MCP server is connected to MSFT Copilot Studio."]}]},"headings":[{"value":"Custom Celonis MCP Server at Microsoft Copilot Studio","id":"custom-celonis-mcp-server-at-microsoft-copilot-studio","depth":1},{"value":"Create MCP Server Asset:","id":"create-mcp-server-asset","depth":3},{"value":"Initial OAuth client setup","id":"initial-oauth-client-setup","depth":3},{"value":"Adding a custom connector in MSFT Copilot Studio","id":"adding-a-custom-connector-in-msft-copilot-studio","depth":3},{"value":"OAuth client setup","id":"oauth-client-setup","depth":3},{"value":"Connecting to the custom connector in MSFT Copilot Studio","id":"connecting-to-the-custom-connector-in-msft-copilot-studio","depth":3}],"frontmatter":{"seo":{"title":"Custom Celonis MCP Server at Microsoft Copilot Studio"}},"lastModified":"2026-04-10T22:00:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/integrations/custom-mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}