Skip to content

docs(rfcs): define OAuth and MCP gateway boundary - #3198

Draft
f-trycua wants to merge 2 commits into
mainfrom
agent/oauth-mcp-gateway-rfc
Draft

docs(rfcs): define OAuth and MCP gateway boundary#3198
f-trycua wants to merge 2 commits into
mainfrom
agent/oauth-mcp-gateway-rfc

Conversation

@f-trycua

Copy link
Copy Markdown
Collaborator

Summary

  • define Cua Driver's standard, transport-neutral MCP boundary
  • place OAuth, DCR, TLS, tunnels, and provider adapters in a separate optional gateway
  • keep one canonical Driver tool inventory and require trusted local approval for remote desktop access

Why

PR #2063 demonstrates demand from remote MCP clients that require OAuth and HTTPS. Keeping the public OAuth edge inside cua-driver would couple the desktop runtime to token storage, tunnel operations, and client-specific compatibility rules.

This RFC moves those responsibilities to a separately owned gateway while keeping Driver as the final authorization point.

Refs #3197.

Salvaged from #2063. The RFC and commit preserve outdog-hwh's design credit; later implementations must preserve authorship for any material code they adapt.

Validation

  • prettier --check rfcs/3197-oauth-mcp-gateway-boundary.md
  • RFC template-section and placeholder scan
  • git diff --check
  • repository-relative target check for every linked source and RFC file

Review focus

  • ownership and packaging of the gateway
  • the minimum authenticated Driver connection-lease contract
  • trusted local approval ownership on each platform
  • first supported OAuth and MCP transport profiles
  • DCR, token lifetime, revocation, storage, and tunnel policy

This is a draft decision document. It does not authorize implementation until the RFC is accepted.

f-trycua and others added 2 commits August 16, 2026 08:43
Salvaged from #2063.

Co-authored-by: outdog-hwh <168953287+outdog-hwh@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants