Add MCP Server Quickstart by ProgrammerAL · Pull Request #1179 · DuendeSoftware/docs.duendesoftware.com

ProgrammerAL · 2026-08-10T20:23:13Z

Added a quickstart page for an MCP Server demo using DCR
Added a Samples page for MCP Server with a link to the GitHub Samples repo

This is the documentation update for https://github.com/DuendeSoftware/customer-success/issues/864

Copilot

Pull request overview

Adds new Duende IdentityServer documentation covering an MCP Server demo that uses Dynamic Client Registration (DCR), plus a Samples landing page entry that links to the corresponding GitHub sample.

Changes:

Added a new quickstart: “Connecting an MCP Server and Client with DCR”
Added a new Samples page: “MCP Server and Client” with a LinkCard to the demo repo
Cross-linked the quickstart and the sample page

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
astro/src/content/docs/identityserver/samples/mcp-server.mdx	New samples page for the MCP demo, with links to DCR docs and the GitHub sample.
astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx	New end-to-end quickstart describing IdentityServer + MCP Server + console client setup using DCR.

Suppressed comments (4)

astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx:29

Grammar: "The below steps … adds" should be "The steps below … add".

The IdentityServer project needs to be configured to use DCR to allow clients at runtime. The below steps disable the static clients and adds DCR. Add a new Duende IdentityServer InMemory project to its own directory inside the `mcp-quickstart` directory you created above.

astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx:101

Typo in the code comment: "metadatada" should be "metadata".

        // this will add the default dynamic client registration endpoint to the discovery/metadatada documents

astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx:170

Minor typo/formatting in the snippet comment: add a space after // for readability/consistency.

    //Add this line

astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx:492

The XML doc comment block is malformed (it closes </summary> without opening <summary>) and the <param> names don’t match the method signature (authContext, not authorizationUrl/redirectUri). Since this is a copy/paste snippet, it’s worth keeping it correct.

/// Handles the OAuth authorization URL by starting a local HTTP server and opening a browser.
/// This implementation demonstrates how SDK consumers can provide their own authorization flow.
/// </summary>
/// <param name="authorizationUrl">The authorization URL to open in the browser.</param>
/// <param name="redirectUri">The redirect URI where the authorization code will be sent.</param>

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

maartenba

Left a bunch of comments, roughly two groups:

The reader arrives wanting to secure AI tools, not learn about DCR per se (it's a means to an end). Flipping to "here's how to secure your MCP server with IdentityServer (using DCR under the hood)"
Elaboration on some concepts. It's not the easiest topic and I think we may be glossing over a couple of things currently.
(OK three groups) Some formatting/Astro suggestions.

maartenba · 2026-08-11T11:40:12Z

@@ -0,0 +1,596 @@
+---
+title: "Connecting an MCP Server and Client with DCR"


Quickstarts is a good location, we can move it elsewhere when needed.

maartenba · 2026-08-11T12:11:19Z

+The console client will need to:
+
+1. Use the `ModelContextProtocol` NuGet package to create an `HttpClientTransport` object to communicate with the MCP Server.
+1. Include a `RedirectUri` back to itself after the user signs in.


Why is this redirect needed? Probably elaborate a little bit.

maartenba · 2026-08-11T12:11:56Z

+        AuthorizationCallbackHandler = HandleAuthorizationUrlAsync,
+        DynamicClientRegistration = new DynamicClientRegistrationOptions
+        {
+            ClientName = "ProtectedMcpClient"
+        },
+        Scopes = ["mcp:tools"],


Do these need elaboration?

maartenba · 2026-08-11T12:12:14Z

+/// <param name="cancellationToken">The cancellation token.</param>
+/// <returns>The authorization code extracted from the callback, or null if the operation failed.</returns>
+// static async Task<string?> HandleAuthorizationUrlAsync(Uri authorizationUrl, Uri redirectUri, CancellationToken cancellationToken)
+static async Task<AuthorizationResult?> HandleAuthorizationUrlAsync(AuthorizationCallbackContext authContext, CancellationToken cancellationToken)


Does this need elaboration in text?

maartenba · 2026-08-11T12:13:28Z

+### Run the Samples
+
+Start the IdentityServer and MCP Server applications, then run the console client. When prompted to sign in for the console client, use username `bob` with password `bob` to sign in. The console will output the response from the MCP Server after it self-registers.
+


Maybe repeat with a list what happened behind the scenes? (client requested server, server said need auth via IdP URL, client sees it can self register with DCR, self registers client, then does interactive auth in the browser with new client ID, then makes request to server, ...)

khalidabuhakmeh · 2026-08-11T12:14:07Z

@@ -0,0 +1,596 @@
+---
+title: "Connecting an MCP Server and Client with DCR"


Make the title of the page "Dynamic Client Registration" while you can use a label in the sidebar to have it be DCR

Frame it from AI/MCP perspective, DCR is secondary

khalidabuhakmeh · 2026-08-11T12:18:18Z

+    _ = app.MapRazorPages()
+        .RequireAuthorization();
+
+    //Add this line


Astro code blocks can highlight lines without comments like this. I think it is fine right now, but just a thought.

khalidabuhakmeh · 2026-08-11T12:19:07Z

+}
+```
+
+#### Hard Code Application Url


The use of "Hard Code" here is odd. "Setting the Application Url for Demo Purposes"

khalidabuhakmeh · 2026-08-11T12:21:17Z

+
+#### Configure MCP Tools
+
+Create a new directory called `McpTools` and add a `WeatherTools.cs` C# file. This will be the API called by our clients. The code for the file is below.


"Create a new directory within the project..."

khalidabuhakmeh · 2026-08-11T12:22:53Z

+}
+```
+
+### Run the Samples


It would be nice to see some of the console output from the MCP tool and the console client.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Co-authored-by: Maarten Balliauw <maarten@balliauw.be>

ProgrammerAL added 3 commits August 7, 2026 17:04

Started work on a page for an MCP server/client quickstart

87078c4

Merge branch 'main' into alrodri/mcp-docs

d322726

Completed MCP Server quickstart doc

7b43d3e

ProgrammerAL requested review from khalidabuhakmeh and maartenba and a lite review from Copilot August 10, 2026 20:23

ProgrammerAL self-assigned this Aug 10, 2026

ProgrammerAL added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 10, 2026

Copilot started reviewing on behalf of ProgrammerAL August 10, 2026 20:23 View session

Copilot AI reviewed Aug 10, 2026

View reviewed changes

Comment thread astro/src/content/docs/identityserver/samples/mcp-server.mdx Outdated

Comment thread astro/src/content/docs/identityserver/samples/mcp-server.mdx Outdated

Comment thread astro/src/content/docs/identityserver/quickstarts/8-mcp.mdx Outdated

maartenba requested changes Aug 11, 2026

View reviewed changes

khalidabuhakmeh approved these changes Aug 11, 2026

View reviewed changes

ProgrammerAL and others added 7 commits August 11, 2026 13:47

Potential fix for pull request finding

bbdb1bc

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Apply suggestions from code review

5340bc1

Co-authored-by: Maarten Balliauw <maarten@balliauw.be>

Added a mermaid diagram to the MCP Server quickstart page

6429af1

Trimmed comments a bit

5280102

Clarified enabling DCR in the IdentityServer pipeline

85854fc

Highlited sample code instead of a comment callout

6a47ca9

Updated how json files are displayed

d964738

		@@ -0,0 +1,596 @@
		---
		title: "Connecting an MCP Server and Client with DCR"

		### Run the Samples

		Start the IdentityServer and MCP Server applications, then run the console client. When prompted to sign in for the console client, use username `bob` with password `bob` to sign in. The console will output the response from the MCP Server after it self-registers.


		#### Configure MCP Tools

		Create a new directory called `McpTools` and add a `WeatherTools.cs` C# file. This will be the API called by our clients. The code for the file is below.

Uh oh!

Conversation

ProgrammerAL commented Aug 10, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

maartenba left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants