This guide walks through connecting Microsoft Copilot Studio to the Hudu MCP (Model Context Protocol) server using OAuth 2.0 authentication and Dynamic Discovery.
Once connected, Copilot can securely interact with Hudu documentation and activity logs directly through the Hudu MCP.
What the Hudu MCP Server Does
The Hudu MCP server provides structured access to Hudu content for AI clients such as Microsoft Copilot Studio.
Current capabilities include:
- Reading Hudu articles
- Creating new articles
- Editing existing articles
- Updating article draft status
- Reading Hudu activity logs
This allows Copilot to assist with documentation management and operational visibility directly from within your AI agent.
Connecting to Copilot
Log Into Copilot Studio
Sign into Microsoft Copilot Studio and select the environment where you want to create the agent.
Create a New Agent
- Click Create Blank Agent
- Enter a name for the agent
- Leave the default settings as-is
- Click Create
Add the Hudu MCP Tool
Inside the agent:
- Open the Tools tab
- Click + Add a tool
- Choose Add new Model Context Protocol (MCP)
Configure the MCP
Fill in the MCP server details.
Server Name
Hudu MCPServer Description
Provides access to Hudu articles and activity logs through MCPServer URL
https://<hudu_instance_URL>/mcpAuthentication
Under Authentication:
- Select OAuth 2.0
- Choose Dynamic discovery
- Click Create
Retrieve Redirect URL
When setting up the Hudu MCP connection in Copilot, you'll need to retrieve a Redirect URL from the custom connector and paste it into Hudu's admin settings.
After creating the MCP tool:
- Open Copilot Studio in a new tab
- Click into Tools
- Find and click into the Tool you just created
- Click into the Security tab
- Click Edit
- Change the authentication type to OAuth 2.0
- Scroll to the bottom of the page
- Copy the generated Redirect URL
Please note: You will see required fields when changing to OAuth2.0, these fields can remain unfilled. Only the Redirect URL is needed to paste into Hudu.
Configure the Redirect URL in Hudu
In Hudu:
- Open Hudu MCP in Hudu > Admin > External Apps
- Click + Add Redirect URI
- Paste in the Redirect URL copied from Copilot Studio
- Click Save
This allows the OAuth authentication flow between Copilot Studio and the Hudu MCP server to complete successfully.
Connect the Tool to the Agent
Return to Copilot Studio to finish adding the tool.
- Click the Connection dropdown
- Click Create new connection
- Click Create
- Make sure Pop-Ups are allowed
- Click Add and configure
- Next, go to Manage Your Connections
- Click Connect to finalize the connection
Publishing Your Agent
When your agent is ready, you publish it from Copilot Studio to make it available to users. You can deploy to multiple channels — such as Teams, Microsoft 365 Copilot, websites, and mobile apps — and any updates you make are pushed to all of them at once when you republish.
Keep in mind that changes don't go live until you publish. If users aren't seeing updates, that's usually why.
You can also start small with one channel and add more later as your rollout grows.
Authentication
By default, agents use Microsoft Entra ID, which handles sign-in automatically for Teams, Power Apps, and Microsoft 365 Copilot. If you need the agent to be publicly accessible, you can disable authentication so anyone can chat with it without signing in.
Please see the Microsoft Publication Fundamentals guide for more information.
FAQ
Make sure you have allowed the ./well-known endpoint.
A Copilot user license is required to publish in Copilot Studio: Copilot Licensing Requirements.