Skip to content

[Cloudflare One] Fix MCP portal default OAuth callback URL#31701

Open
kennyj42 wants to merge 2 commits into
cloudflare:productionfrom
kennyj42:kjohnson/mcp-portals-callback-url-default
Open

[Cloudflare One] Fix MCP portal default OAuth callback URL#31701
kennyj42 wants to merge 2 commits into
cloudflare:productionfrom
kennyj42:kjohnson/mcp-portals-callback-url-default

Conversation

@kennyj42

@kennyj42 kennyj42 commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

What this PR changes

Fixes the documented default upstream OAuth callback URL for MCP server portals. The current docs claim newly created MCP servers use a shared Cloudflare-owned callback URL by default, but the actual behavior is that the portal uses the per-portal hostname (https://<portal-hostname>/servers-callback) by default, and only switches to the shared URL (https://oauth-callbacks.cloudflareaccess.com/cdn-cgi/access/outbound-oauth-callback) when the shared callback flag is explicitly enabled on the portal.

What's in the PR

  • Rewrites the ### Upstream OAuth callback URL section to lead with the per-portal default
  • Adds a #### Shared Cloudflare callback URL (opt-in) subsection
  • Updates the troubleshooting entry for redirect URI errors to match

The portal uses the per-portal hostname (https://<portal>/servers-callback) by default. The shared Cloudflare callback URL (https://oauth-callbacks.cloudflareaccess.com/cdn-cgi/access/outbound-oauth-callback) is only used when explicitly enabled on the portal. Update the docs to match the actual flow.
@kennyj42 kennyj42 requested review from a team, asamborski and elithrar as code owners June 25, 2026 18:34
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit b9c3acf.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

✅ No code review issues found.

Style Guide Review

✅ No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.

Use 'turned on' instead of 'enabled' for toggle language per style guide.
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.

3 participants