Connect Microsoft Copilot Studio to the Collibra MCP

Microsoft Copilot Studio connects to the Collibra MCP server through a custom connector configured with OAuth 2.0. After you connect, your Copilot Studio agents can use Collibra's governed metadata tools directly. The recommended approach is for an administrator to create the connection once and share it with selected user groups.

Note The Collibra MCP server runs in the Collibra Cloud environment, so this integration is not available for Collibra Platform for Government or Collibra Platform Self-Hosted (CPSH).

Prerequisites

In your Collibra environment

  • You need admin privileges in Collibra to register an OAuth application.

In your Microsoft Copilot Studio environment

  • You can create custom connectors and agents in your Copilot Studio environment.

You configure this connection in three stages due to a dependency between the two systems: Collibra requires a redirect URI to register an OAuth application, but Copilot Studio does not generate its redirect URI until it has a Client ID and Secret from that application. Start in Collibra with a placeholder redirect URI to get those credentials, use them to create the connector in Copilot Studio, then return to Collibra to swap in the real redirect URI.

Step 1: Register an OAuth application in Collibra

This step requires admin privileges in Collibra.

  1. Go to Settings.
  2. Click OAuth applications.
  3. Click New Application.
  4. Click Register user application.
  5. Enter an application name.
  6. Enter https://localhost as a placeholder redirect URI. You update this with the real value in Step 3, once Copilot Studio generates it.
  7. Deactivate Enable Proof Key for Code Exchange (PKCE).

    Important Microsoft Copilot Studio's connector does not support PKCE (RFC 7636). If you leave PKCE active, authentication fails with an invalid_request error for the missing code_challenge parameter.

  8. Click Register.
  9. Copy the OAuth Client ID and Client Secret. You need them to configure the connector in Microsoft Copilot Studio.

Step 2: Create the MCP connector tool in Microsoft Copilot Studio

  1. Go to https://copilotstudio.microsoft.com/environments/<environment_id>/tools.
  2. Click New tool and select Model Context Protocol.
  3. Select OAuth 2.0 for authentication and select Manual as the type.
  4. Enter the connector details:

    Field Value
    Server Name The name of your server.
    Server Description The description of your server.
    Server URL https://<tenant>.collibra.com/rest/mcp
    Authentication OAuth 2.0, Manual
    Client ID Client ID from Step 1.
    Client Secret Client Secret from Step 1.
    Authorization URL https://<tenant>.collibra.com/rest/oauth/v2/authorize
    Token URL https://<tenant>.collibra.com/rest/oauth/v2/token
    Refresh URL https://<tenant>.collibra.com/rest/oauth/v2/token
    Scopes Leave empty. Collibra accepts an empty scope or offline_access, but neither is required.
  5. Save the connector.
  6. Copilot Studio generates a redirect URL on the connector's Security tab.

Step 3: Update the OAuth application in Collibra

  1. In Microsoft Copilot Studio, open the connector tool you created.
  2. Go to the Security tab and copy the redirect URL.
  3. In Collibra, go to Settings > OAuth applications and edit the application from Step 1.
  4. Replace https://localhost with the copied redirect URL.

    Important Keep PKCE deactivated when you edit the application.

  5. Save the application.

Use the connection

  1. In Microsoft Copilot Studio, go to Agents.
  2. Create a blank agent, or open an existing one, and wait until Copilot Studio confirms the agent is provisioned.
  3. Go to the Tools tab and click Add tool.
  4. Click Model Context Protocol and select your MCP connector.
  5. Click Not connected, click Create new connection, and click Create.
  6. Sign in with your Collibra credentials in the OAuth prompt.
  7. Your agent connects to the Collibra MCP.
  8. Confirm the connection by prompting your agent to list all tools available through the connected MCP connector. If Collibra MCP tools appear in the response, your connection is ready for use.

What's next