Update contributing guide for HTTP mode#962
Merged
srnagar merged 1 commit intomicrosoft:feature/2.0beta-remotefrom Oct 28, 2025
Merged
Update contributing guide for HTTP mode#962srnagar merged 1 commit intomicrosoft:feature/2.0beta-remotefrom
srnagar merged 1 commit intomicrosoft:feature/2.0beta-remotefrom
Conversation
joshfree
approved these changes
Oct 27, 2025
github-project-automation
Bot
moved this from Untriaged
to In Progress
in Azure MCP Server
anuchandy
approved these changes
Oct 27, 2025
srnagar
requested review from
JasonYeMSFT,
JonathanCrd,
KarishmaGhiya,
chidozieononiwu,
g2vinay,
msalaman and
vukelich
and removed request for
a team
srnagar
merged commit 1931caf
into
microsoft:feature/2.0beta-remote
5 of 23 checks passed
vukelich
reviewed
Oct 28, 2025
vukelich
added a commit
that referenced
this pull request
Nov 3, 2025
…servers (#1020) * Add remote HTTP server mode with OAuth authentication and downstream token acquisition. (#910) Add remote HTTP server mode with OAuth authentication and downstream token acquisition - Add RunAsRemoteHttpService and OutgoingAuthStrategy options to enable MCP server to run as a remote HTTP service - Introduce ITokenProvider abstraction for dependency injection of downstream authentication tokens and credentials - Add support for On-Behalf-Of (OBO) token flow and hosting environment identity modes for outgoing authentication - Implement OAuth Protected Resource Metadata endpoint at /.well-known/oauth-protected-resource with WWW-Authenticate challenge - Add Visual Studio and dotnet run launch profile for debugging remote MCP server with Microsoft.Identity.Web configuration - Modernize HTTP host creation using WebApplicationBuilder with authentication and authorization middleware * Update contributing guide for HTTP mode (#962) * Add support for ENABLE_REMOTE compilation constant to include remote functionality only in non-trimmed builds (#1008) * Exclude Obo roots when building in trim mode given the AOT violations in Obo apis * Use aot safe apis for incoming auth * unblock template cli, fix CreateArmClientAsync_CreatesAndUsesCachedClient * dotnet format * Define ENABLE_REMOTE build property for untrimmed build * Require non-null ITenantService parameter to BaseAzureService to ensure all derived types can make authenticated Azure calls always. Fixes product, live tests, and unit tests. (#1029) Require non-null ITenantService parameter to BaseAzureService to ensure all derived types can make authenticated Azure calls always. Fixes product, live tests, and unit tests. * Update contributing guide and troubleshooting guide to address PR comments (#1005) * Update contributing guide and troubleshooting guide to address PR comments * move launchSettings instructions to wiki * minor update * update doc * address pr comments * change endpoint placeholder --------- Co-authored-by: Srikanta <51379715+srnagar@users.noreply.github.com> Co-authored-by: Anu Thomas <anuamd@hotmail.com>
colbytimm
pushed a commit
to colbytimm/microsoft-mcp
that referenced
this pull request
Dec 8, 2025
…servers (microsoft#1020) * Add remote HTTP server mode with OAuth authentication and downstream token acquisition. (microsoft#910) Add remote HTTP server mode with OAuth authentication and downstream token acquisition - Add RunAsRemoteHttpService and OutgoingAuthStrategy options to enable MCP server to run as a remote HTTP service - Introduce ITokenProvider abstraction for dependency injection of downstream authentication tokens and credentials - Add support for On-Behalf-Of (OBO) token flow and hosting environment identity modes for outgoing authentication - Implement OAuth Protected Resource Metadata endpoint at /.well-known/oauth-protected-resource with WWW-Authenticate challenge - Add Visual Studio and dotnet run launch profile for debugging remote MCP server with Microsoft.Identity.Web configuration - Modernize HTTP host creation using WebApplicationBuilder with authentication and authorization middleware * Update contributing guide for HTTP mode (microsoft#962) * Add support for ENABLE_REMOTE compilation constant to include remote functionality only in non-trimmed builds (microsoft#1008) * Exclude Obo roots when building in trim mode given the AOT violations in Obo apis * Use aot safe apis for incoming auth * unblock template cli, fix CreateArmClientAsync_CreatesAndUsesCachedClient * dotnet format * Define ENABLE_REMOTE build property for untrimmed build * Require non-null ITenantService parameter to BaseAzureService to ensure all derived types can make authenticated Azure calls always. Fixes product, live tests, and unit tests. (microsoft#1029) Require non-null ITenantService parameter to BaseAzureService to ensure all derived types can make authenticated Azure calls always. Fixes product, live tests, and unit tests. * Update contributing guide and troubleshooting guide to address PR comments (microsoft#1005) * Update contributing guide and troubleshooting guide to address PR comments * move launchSettings instructions to wiki * minor update * update doc * address pr comments * change endpoint placeholder --------- Co-authored-by: Srikanta <51379715+srnagar@users.noreply.github.com> Co-authored-by: Anu Thomas <anuamd@hotmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request adds detailed instructions for running the Azure MCP Server in HTTP mode and clarifies configuration steps for local development and testing. The documentation now covers both running the server via
dotnet runand using the built executable, including necessary environment variables and configuration for Azure AD authentication. These improvements help streamline onboarding and troubleshooting for developers.Documentation improvements for running and configuring Azure MCP Server:
dotnet run(leveraginglaunchSettings.json) and running the built executable directly, with clear details on required environment variables and command line arguments.mcp.jsonconfiguration for both stdio and HTTP modes, clarifying how to connect to the server and what values to update for each scenario.Developer experience and troubleshooting enhancements:
TROUBLESHOOTING.mdwith a recommended workflow for local development, highlighting the use ofdotnet runand the automatic configuration provided bylaunchSettings.jsonfor HTTP mode operation.