Skip to content

[ZT] Add managed OAuth step to self-hosted MCP server guide#30698

Open
GreenStage wants to merge 1 commit intocloudflare:productionfrom
GreenStage:egomes/mcp-self-hosted-managed-oauth
Open

[ZT] Add managed OAuth step to self-hosted MCP server guide#30698
GreenStage wants to merge 1 commit intocloudflare:productionfrom
GreenStage:egomes/mcp-self-hosted-managed-oauth

Conversation

@GreenStage
Copy link
Copy Markdown
Contributor

Summary

The self-hosted MCP server guide (Secure MCP servers > Self-hosted application) was missing the step to enable Managed OAuth on the Access application. Without this, non-browser MCP clients (CLIs, AI agents, SDKs) receive a 302 browser redirect instead of a proper OAuth 401 with WWW-Authenticate headers, effectively blocking them from authenticating.

This PR adds:

  • A Dashboard step instructing users to turn on Managed OAuth in Additional settings, with a link to the Managed OAuth reference page.
  • The oauth_configuration: { enabled: true } field to the API tab's example request body.

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant