Skip to content

docs: clarify MCP discovery and HTTP/2 troubleshooting - #26145

Open
dvdksn wants to merge 2 commits into
docker:mainfrom
dvdksn:codex/sbx-v045-mcp
Open

dvdksn wants to merge 2 commits into
docker:mainfrom
dvdksn:codex/sbx-v045-mcp

Conversation

@dvdksn

@dvdksn dvdksn commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

The MCP guide incorrectly describes private OAuth metadata discovery as blocked. Document its warning behavior and link to an HTTP/2 stream-stall workaround in troubleshooting.

Verified against docker/sandboxes release commit 2f44e051; scoped rumdl and Vale checks pass with no findings.

Related to https://github.com/docker/sandboxes/issues/6277. Complements the kits documentation in #26065.

@netlify /ai/sandboxes/mcp-gateway/

Generated by Codex

The MCP guide describes private OAuth metadata as blocked and omits the HTTP/2 workaround and recovery from an OAuth request without scopes.

Document discovery warnings and their opt-out, the remote transport flag, and explicit-scope retries with v0.45 version anchors.

Co-authored-by: Codex <noreply@openai.com>
@dvdksn dvdksn added this to the sbx/v0.45.0 milestone Sep 21, 2026
@netlify

netlify Bot commented Sep 21, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 31b703a
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ab1313a98895b00087806d6
😎 Deploy Preview https://deploy-preview-26145--docsdocker.netlify.app/ai/sandboxes/mcp-gateway/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Keep the MCP setup guide focused on current registration behavior. Move the HTTP/2 stream-stall workaround to troubleshooting, link to it, and remove version callouts and self-explanatory scope-error narration.

Co-Authored-By: Codex <noreply@openai.com>
@dvdksn dvdksn changed the title docs: update MCP gateway guidance for Sandboxes v0.45 docs: clarify MCP discovery and HTTP/2 troubleshooting Sep 21, 2026
@dvdksn
dvdksn requested a review from a team September 21, 2026 14:24
@dvdksn
dvdksn marked this pull request as ready for review September 21, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant