Skip to content

[Access] Document service token auth and device auth limitation for MCP portals#31008

Draft
kennyj42 wants to merge 1 commit into
cloudflare:productionfrom
kennyj42:kjohnson/mcp-portal-auth-clarifications
Draft

[Access] Document service token auth and device auth limitation for MCP portals#31008
kennyj42 wants to merge 1 commit into
cloudflare:productionfrom
kennyj42:kjohnson/mcp-portal-auth-clarifications

Conversation

@kennyj42
Copy link
Copy Markdown
Collaborator

What this PR does

  • Service token section: Documents how to connect to MCP portals using Access service tokens for machine-to-machine access, including the limitation that service tokens cannot use per-user OAuth (only admin credentials)
  • Device auth note: Explicitly documents that device authentication (WARP-based identity) is not supported for MCP portals -- browser auth flow is required

Why

Service tokens: The gateway code supports service token auth with specific routing behavior (bypasses OAuth provider, routes directly to MCP DO, uses svc:<id> user ID format). This is useful for CI/CD pipelines and automated agents but was completely undocumented.

Device auth: A customer asked about this at RSA. Internal SEs confirmed the option does not show up for MCP portals. Without this note, customers will search for a feature that does not exist.

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