Skip to content

Automate mcp-remote OAuth token-cache bootstrap#20

Merged
BillJr99 merged 1 commit into
mainfrom
claude/mcp-token-cache-automation-Yuyxz
Jun 1, 2026
Merged

Automate mcp-remote OAuth token-cache bootstrap#20
BillJr99 merged 1 commit into
mainfrom
claude/mcp-token-cache-automation-Yuyxz

Conversation

@BillJr99

@BillJr99 BillJr99 commented Jun 1, 2026

Copy link
Copy Markdown
Owner

Remote, OAuth-protected providers are bridged with npx -y mcp-remote <url>
and cache tokens under MCP_REMOTE_CONFIG_DIR. The first grant needs a browser
once; this automates everything around it so a host shell is rarely needed.

  • Startup warm-up (server.py): on boot, introspect each mcp-remote bridge once
    so valid tokens refresh silently and any required re-auth URL is surfaced via
    pending_auth_urls/logs instead of failing on the first tool call. Gated by
    MCPPROXY_WARM_REMOTE (default on).
  • In-browser terminal (frontend/app.py): a PTY-over-WebSocket endpoint
    (/ws/terminal) plus an xterm.js modal. Wizard "Bootstrap / Authorize in
    terminal" button and a per-provider "Re-authorize" button run the mcp-remote
    flow live from the UI. Gated by MCPPROXY_WEB_TERMINAL (default on); /api/config
    exposes the flag so the UI hides the feature when disabled.
  • Pending-auth banner: the UI polls /api/pending-auth and shows a global
    "authorization required" banner with clickable links.
  • Host helper (bootstrap_auth.py + run_local.sh --bootstrap-auth): derives the
    mcp-remote URLs from configured providers and runs the flow per provider,
    writing the cache to MCP_REMOTE_CONFIG_DIR (default ./.mcp-auth).
  • README Part 3.25 updated; tests added for the config flag, the terminal gate,
    command extraction, and the warm-up helpers.

https://claude.ai/code/session_01XsiNca5mh3BwPMaDhBnuWW

Remote, OAuth-protected providers are bridged with `npx -y mcp-remote <url>`
and cache tokens under MCP_REMOTE_CONFIG_DIR. The first grant needs a browser
once; this automates everything around it so a host shell is rarely needed.

- Startup warm-up (server.py): on boot, introspect each mcp-remote bridge once
  so valid tokens refresh silently and any required re-auth URL is surfaced via
  pending_auth_urls/logs instead of failing on the first tool call. Gated by
  MCPPROXY_WARM_REMOTE (default on).
- In-browser terminal (frontend/app.py): a PTY-over-WebSocket endpoint
  (/ws/terminal) plus an xterm.js modal. Wizard "Bootstrap / Authorize in
  terminal" button and a per-provider "Re-authorize" button run the mcp-remote
  flow live from the UI. Gated by MCPPROXY_WEB_TERMINAL (default on); /api/config
  exposes the flag so the UI hides the feature when disabled.
- Pending-auth banner: the UI polls /api/pending-auth and shows a global
  "authorization required" banner with clickable links.
- Host helper (bootstrap_auth.py + run_local.sh --bootstrap-auth): derives the
  mcp-remote URLs from configured providers and runs the flow per provider,
  writing the cache to MCP_REMOTE_CONFIG_DIR (default ./.mcp-auth).
- README Part 3.25 updated; tests added for the config flag, the terminal gate,
  command extraction, and the warm-up helpers.

https://claude.ai/code/session_01XsiNca5mh3BwPMaDhBnuWW
Copilot AI review requested due to automatic review settings June 1, 2026 02:22
@BillJr99 BillJr99 merged commit 3841afe into main Jun 1, 2026
2 of 3 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

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.

3 participants