Skip to main content
This guide is for administrators to configure Microsoft Copilot Studio to connect to your company’s Glean MCP servers.

Prerequisites

  • Glean OAuth authorization server enabled (Admin Console > Settings > Third-party access)
  • MCP server enabled (Admin Console > Platform > MCP)
  • Microsoft Copilot Studio access with System Customizer or System Administrator role
  • Generative Orchestration enabled in your Copilot Studio environment

Add Glean MCP Server to Copilot Studio

1

Navigate to Tools page

In Copilot Studio, go to your agent and select Tools from the left navigation.
Copilot Studio Tools page
2

Add a new MCP tool

Click Add a tool, then select the Model Context Protocol filter tab.
Click Add a tool
Click New tool to add a new MCP server, then select Glean from the list.
Click New tool
Select Glean
3

Configure the MCP server

Enter the following details:
  • Server name: Glean
  • Server description: Provides tools to work with Glean Enterprise Knowledge
  • Server URL: https://[instance-name]-be.glean.com/mcp/[server-name]
  • Authentication: Select OAuth 2.0 and choose a type:
    • Dynamic discovery (recommended): Automatically discovers OAuth endpoints from the server
    • Dynamic: Discovers some settings, requires manual token URL
    • Manual: All OAuth settings configured manually
MCP server configuration
4

Create a new connection

In the Add tool dialog, click the Connection dropdown and select Create new connection.
Create new connection
This triggers the OAuth flow. Sign in with your Glean credentials and authorize the connection on the Glean OAuth page.
Glean OAuth authorize page
Once authenticated, the connection shows as connected with a green checkmark. Click Add and configure to complete setup.
Connection confirmed with green checkmark
The Glean tool configuration page displays with the server connected.
Glean tool configured with server connected
5

Validate tools

Test the connection by asking your agent a question that requires Glean data. Verify the available tools are working correctly.

Authorization Options

Copilot Studio supports multiple OAuth 2.0 configuration types:
TypeDescriptionRecommended For
Dynamic discoveryAutomatically discovers OAuth endpoints from the serverMost deployments (recommended)
DynamicDiscovers some settings, requires manual token URLCustom configurations
ManualAll OAuth settings configured manuallyAdvanced/custom setups
Use Dynamic discovery when possible. It simplifies configuration by automatically retrieving OAuth endpoints from your Glean instance.

Copilot Studio MCP Constraints

  • Transport: Streamable HTTP (SSE transport is deprecated after August 2025)
  • Generative Orchestration required: MCP tools require Generative Orchestration to be enabled
  • Endpoint format: https://[instance-name]-be.glean.com/mcp/[server-name]
  • Authorization: OAuth 2.0 with PKCE support
References:

Troubleshooting

OAuth authorization failures

If OAuth authorization fails:
  1. Verify the Authorization URL and Token URL are correct for your Glean instance
  2. Ensure the Glean OAuth authorization server is enabled in Admin Console
  3. Check that the user has an active Glean account with appropriate permissions
  4. Try using Manual configuration if Dynamic Discovery is not working

Missing or unavailable tools

If MCP tools aren’t appearing in your agent:
  1. Confirm Generative Orchestration is enabled in your Copilot Studio environment
  2. Verify the MCP server is enabled in Glean Admin Console
  3. Check that tools are enabled on the specific server configuration
  4. Ensure the Server URL format is correct

Connection errors

If you encounter connection errors:
  1. Verify the Server URL includes both your instance name and server name
  2. Check firewall settings allow connections from Microsoft to your Glean instance
  3. Ensure the MCP server is properly configured and running

Using Glean Tools in Copilot Studio

Once the Glean MCP server is configured, users can interact with Glean data through your Copilot Studio agent. The agent will automatically use Glean tools when relevant queries are made.
The specific tools available depend on your Glean MCP server configuration. Common tools include search, chat, and read_document capabilities.