# 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](https://learn.microsoft.com/en-us/connectors/celonismcpserver/#celonis-mcp-server), you might face the issue of having multiple connections with the same name:

![mcp-connections](/assets/mcp-connections.eed057bebb215c855d9d1bf77007ba8f3dc0dbbc60d363de6e596b0e69c3898d.9593a17e.png)

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](/assets/mcp-create-celonis-mcp.9843e1a83f12bc8a8e04d5051e7a0376176244ede6c85618d5fabe48630b1a04.9593a17e.png)

### 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](/assets/mcp-new-oauth-client.fecd6c1e6ef703235b66ea0f126e4111e7e240afbeaf3a549b5437764ac75ab0.9593a17e.png)
**Dummy URI:** [https://global.consent.azure-apim.net/redirect/celonismcpserver](https://global.consent.azure-apim.net/redirect/celonismcpserver)
3. Select the mcp scope and click **Create**:
![mcp-select-scope](/assets/mcp-select-scope.e8ed661004f6ed518a5d519fc343c2e992a471959f69f8b2e6d914d5f67815c8.9593a17e.png)
4. Save the Client ID and Client Secret.


### 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](/assets/mcp-add-custom-tool.945f22e540567a6bc0c8127d1d74360964ea65390c36aa347cca5f8c76172110.9593a17e.png)
2. Enter the tool details:
![mcp-tool-details](/assets/mcp-tool-details.b6992f1f0364a7473e43140003333bcd6449219a1ad8602897dce31cf99465d3.9593a17e.png)
3. Fill in the authorization details as follows:
  * Your Client ID and Client Secret
  * **Authorization URL:** `https://[team].[realm].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](/assets/mcp-add-mcp-server.2cab80b19b65da49dd2b11b4ffe62f3062b759f7e73bd36f19aa8a2f916414b8.9593a17e.png)
4. Click **Create**. After a moment, the following view will display:
![mcp-server-successful](/assets/mcp-server-successful.86d27a6ce9fcc56cbdf8462ed1b0e59b19f44a9772a6e801a0877849656488e5.9593a17e.png)
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. Click the three dots menu on the right and select **Edit**.
![mcp-settings-applications](/assets/mcp-settings-applications.b4c3c5e2d4148c4c091c0c2b0d09d4b764f79b155d57718a35f9b4742d35feda.9593a17e.png)
2. Update the **Redirect URI** with the Redirect URL from MSFT Copilot Studio:
![mcp-redirect-uris](/assets/mcp-redirect-uris.de54c34514a43e8326e7f5c212ac0c72320cc5959b2ec5823a7f8f645f01c9d6.9593a17e.png)
3. 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](/assets/mcp-tool-created-next.38b0a58c7786c5c57f334a687468670558bc6dcd40e81dd01f67300f1b70d47f.9593a17e.png)
2. The following window will display. Click the **Connection** button to create a new connection:
![mcp-add-tool-connection](/assets/mcp-add-tool-connection.38de54da26d03a500b805c1fd47625ebbc9979558c43765f695c335769ae5569.9593a17e.png)

![mcp-connect-to-server](/assets/mcp-connect-to-server.03deced16f5d1ad3c26bd28de60fc2cd81724cb93ee5546bdc81f3aaca12ffba.9593a17e.png)
3. Once the connection is created, click the **Add and configure** button.


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