← Reddit

How to setup an HTTP-based MCP with authentication on Claude Desktop ?

Reddit · redaben_ · April 24, 2026
A developer built an HTTP-based MCP in Python using FastMCP and Azure authentication that successfully runs on Claude Code but could not deploy it to Claude Desktop because Claude Desktop does not support authentication on HTTP-based MCPs. The developer sought advice on workarounds or solutions for implementing this functionality for non-technical users.

Detailed Analysis

A developer working with FastMCP in Python has surfaced a notable friction point in Anthropic's MCP (Model Context Protocol) ecosystem: the apparent gap between Claude Code's robust support for authenticated HTTP-based MCP servers and Claude Desktop's more limited native handling of the same. The developer's server uses AzureProvider (Microsoft Authentication), which functions correctly in Claude Code but presents barriers when attempting to deploy the same integration for non-technical users through Claude Desktop. The frustration reflects a real asymmetry in how Anthropic has rolled out MCP capabilities across its two primary client surfaces — Claude Code being a developer-facing CLI tool, and Claude Desktop being the intended gateway for broader audiences.

The technical landscape for HTTP-based MCP authentication on Claude Desktop is more nuanced than the original post implies, though it does require more configuration than the seamless experience available in Claude Code. Claude Desktop supports several authentication pathways: static auth headers such as Bearer tokens can be injected via manual edits to `claude_desktop_config.json`, the Extensions directory UI simplifies credential entry for pre-built servers, and OAuth 2.0 flows are supported through the client's built-in OAuth discovery mechanism, which performs pre-flight requests to detect a server's auth metadata. For Azure-based authentication specifically, the OAuth 2.0 pathway is the most structurally appropriate route, though it requires the server to expose proper OAuth metadata endpoints and the deployment to be served over HTTPS — requirements that add meaningful complexity for non-trivial enterprise identity providers.

The core challenge for this specific use case — AzureProvider with non-technical end users — is that OAuth flows in Claude Desktop require users to authorize via browser redirects, which, while more user-friendly than editing config files, still introduces steps that may not be seamlessly invisible to lay audiences. Additionally, Claude Desktop's support for remote HTTP MCP servers (as opposed to locally-run stdio-based MCPs) is tied to paid plan tiers, adding an access consideration. Troubleshooting is further complicated by the need to validate that the server exposes the correct OAuth discovery metadata, that HTTPS is properly configured, and that any enterprise IAM or trust policies are aligned — all of which are non-trivial in an Azure Active Directory context.

This gap reflects a broader pattern in the MCP ecosystem's maturation trajectory. Anthropic has prioritized developer-facing tooling (Claude Code, the MCP SDK) in early rollouts, with the assumption that technical users will prototype and validate integrations before they are productionized for wider deployment. Claude Desktop, while increasingly capable, is still catching up in terms of enterprise-grade authentication support for remote servers. The MCP specification itself, being relatively new and rapidly evolving, is still accumulating community consensus around authentication best practices, as evidenced by active GitHub discussions on the topic. The developer's experience highlights that the path from a working Claude Code integration to a deployable Claude Desktop integration for non-technical users currently requires non-trivial additional engineering work — particularly when enterprise identity providers like Azure AD are involved.

The broader significance of this issue extends to Anthropic's ambition to make Claude a platform for agentic workflows deployable across organizations. HTTP-based MCPs with enterprise authentication are precisely the integration pattern that would unlock Claude Desktop as a productivity tool in corporate environments, where Azure AD is ubiquitous. Until Claude Desktop offers a more seamless, first-class experience for OAuth-based remote MCPs — ideally with support for enterprise OIDC providers without requiring manual config editing — the friction described by this developer will remain a recurring barrier to organizational adoption. The trajectory of the MCP ecosystem suggests these gaps will narrow, but for now, deployments targeting non-technical users via Claude Desktop with complex enterprise auth require careful architecture to bridge the capability delta between the two client environments.

Read original article →