Skip to content
Last updated

Custom Celonis MCP Server at Microsoft Copilot Studio

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 Celonis MCP Server at MSFT Copilot studio, you might face the issue of having multiple connections with the same name:

mcp-connections

To mitigate this issue, you can follow this guide to create a custom Celonis MCP Server connection at MSFT Copilot Studio.

Create MCP Server Asset:

Create your MCP Server Asset in the Celonis Platform:

mcp-create-celonis-mcp

Initial OAuth client setup

  1. Navigate to the admin settings at Applications > Add New Application > OAuth Client.

  2. Complete the form as shown below:
    mcp-new-oauth-client

    Dummy URI: https://global.consent.azure-apim.net/redirect/celonismcpserver

  3. Select the "mcp" scope and then click Create:
    mcp-select-scope

  4. Save the Client ID and Client Secret.

Important

Copy and securely store these credentials as they are only displayed once.

Adding a custom connector in MSFT Copilot Studio

  1. Navigate to MSFT Copilot Studio and add a new custom MCP tool:

    mcp-add-custom-tool

  2. Enter the tool details as shown below:

    mcp-tool-details

  3. Fill in the authorization details as follows:

    • Your Client ID and Client Secret
    • Authorization URL: https://[team].[realm].celonis.cloud/oauth2/authorize
    • Token URL template: https://[team].[realm].celonis.cloud/oauth2/token
    • Refresh URL: https://[team].[realm].celonis.cloud/oauth2/token
    • Scopes: mcp-asset.tools:execute

    mcp-add-mcp-server

  4. Click Create. After a moment, the following confirmation will display: mcp-server-successful

  5. Copy the Redirect URL but DO NOT CLICK NEXT.

OAuth client setup

  1. In the Celonis Platform, navigate to the Admin & Settings > Applications and locate the client you created in the previous step.

  2. Click the three dots menu on the right and select Edit.

    mcp-settings-applications

  3. On the Edit OAuth Client screen, update the Redirect URI with the Redirect URL from MSFT Copilot Studio:

    mcp-redirect-uris

  4. Click Define Scopes and then Save.

Connecting to the custom connector in MSFT Copilot Studio

  1. Navigate back to MSFT Copilot Studio and click Next:

    mcp-tool-created-next

  2. On the Add tool screen, click the Connection button to create a new connection:

    mcp-add-tool-connection

  3. Once the connection is created, click the Add and configure button.

  4. Click Create.

    mcp-connect-to-server

The connection is now added and your MCP server is connected to MSFT Copilot Studio.